{"openapi":"3.1.0","info":{"title":"Socialit API","version":"5cdbedc820cc","description":"API-first social media management: publishing, a unified inbox, analytics, Focus mode (everything a network API allows), CRM and automations, telephony and ads, for every network.\n\nAuthenticate with a workspace API key (`Authorization: Bearer sk_live_…`) or an OAuth 2.1 access token (authorization code + PKCE; scopes `read`, `write`, `admin`).\n\nErrors use one envelope: `{ error: { type, code, message, param?, errors? }, request_id }`. Lists return `{ object: \"list\", data, page, limit, total, has_more, next_page_url, previous_page_url }` and accept `<field>.<condition>=<value>` filters. POSTs that create or send honour `Idempotency-Key` (24 h). Rate limits are per workspace and reported in `RateLimit-*` headers.\n\nEvery operation is also an MCP tool on the remote MCP server (`/mcp`): `x-mcp-tool` is its name and `x-toolset` its toolset (`/mcp?toolsets=…`).","contact":{"name":"Socialit","url":"https://socialit.com/contact/"},"termsOfService":"https://socialit.com/terms/"},"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"sk_live_…","description":"Workspace API key (`Authorization: Bearer sk_live_…`). Full keys get read, write and admin; read keys only read. Keys can be restricted to profiles."},"OAuth2":{"type":"oauth2","description":"OAuth 2.1 authorization code flow with PKCE (S256). Dynamic client registration at https://api.socialit.com/oauth/register; metadata at https://api.socialit.com/.well-known/oauth-authorization-server.","flows":{"authorizationCode":{"authorizationUrl":"https://api.socialit.com/oauth/authorize","tokenUrl":"https://api.socialit.com/oauth/token","refreshUrl":"https://api.socialit.com/oauth/token","scopes":{"read":"Read workspace data","write":"Create and change content","admin":"Manage workspace settings, keys, webhooks and members","offline_access":"Refresh tokens"}}}}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":false,"description":"Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (`Idempotent-Replayed: true`) for 24 hours.","schema":{"type":"string","maxLength":255}}},"schemas":{"ErrorResponse":{"type":"object","description":"Error envelope used by every endpoint","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","conflict_error","plan_limit_error","rate_limit_error","platform_error","api_error"]},"code":{"type":"string"},"message":{"type":"string"},"param":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"platform":{"type":"string"},"platform_code":{"type":["string","number"]},"doc_url":{"type":"string"},"usage":{"type":"object","additionalProperties":true},"required_plan":{"type":"string"},"missing_scopes":{"type":"array","items":{"type":"string"}},"reconnect_url":{"type":"string"},"capability":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"},"description":"`feature_unavailable`: the scopes Socialit is not approved to use yet (reconnecting does not help)."},"platforms":{"type":"array","items":{"type":"string"},"description":"`feature_unavailable` when publishing: every network not approved yet."},"account_ids":{"type":"array","items":{"type":"string"},"description":"`feature_unavailable` when publishing: the target accounts that cannot publish yet."}},"required":["type","code","message"]},"request_id":{"type":"string"}},"required":["error"]}}},"paths":{"/v1/invite/tokens":{"post":{"operationId":"createInviteToken","summary":"Create an invite link","tags":["Invitations"],"description":"A shareable link that adds whoever opens it (after sign-in) to this workspace with the given role and profile access.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"role":{"type":"string","enum":["admin","member","billing","viewer"],"default":"member"},"profile_ids":{"type":"array","items":{"type":"string"},"maxItems":500},"scope":{"type":"string","enum":["all","profiles"],"description":"Zernio compatibility: `profiles` requires profile_ids"},"expires_in":{"type":"integer","minimum":300,"maximum":2592000,"default":604800,"description":"Seconds until the link expires (default 7 days, max 30)"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"team","x-mcp-tool":"create-invite-token","x-idempotent":true,"x-zernio":["POST /v1/invite/tokens"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["invite_token"]},"token":{"type":"string"},"url":{"type":"string"},"role":{"type":"string","enum":["admin","member","billing","viewer"]},"profile_ids":{"type":"array","items":{"type":"string"}},"expires_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/users":{"get":{"operationId":"listUsers","summary":"List users","tags":["Users"],"description":"Workspace members with their role and profile access.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","email","name","role"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"role","required":false},{"schema":{"type":"string"},"in":"query","name":"email","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"team","x-mcp-tool":"list-users","x-zernio":["GET /v1/users"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["user"]},"id":{"type":"string"},"name":{"type":["null","string"]},"email":{"type":"string"},"avatar_url":{"type":["null","string"]},"role":{"type":"string","enum":["owner","admin","member","billing","viewer"]},"all_profiles":{"type":"boolean"},"profile_ids":{"type":"array","items":{"type":"string"}},"joined_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/users/{id}":{"get":{"operationId":"getUser","summary":"Get a user","tags":["Users"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"User id (usr_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"team","x-mcp-tool":"get-user","x-zernio":["GET /v1/users/{userId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["user"]},"id":{"type":"string"},"name":{"type":["null","string"]},"email":{"type":"string"},"avatar_url":{"type":["null","string"]},"role":{"type":"string","enum":["owner","admin","member","billing","viewer"]},"all_profiles":{"type":"boolean"},"profile_ids":{"type":"array","items":{"type":"string"}},"joined_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/auth/verify":{"get":{"operationId":"verifyCredential","summary":"Verify the current credential","tags":["API Keys"],"description":"Returns the workspace, permission and scopes of the API key or OAuth token used.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"api_keys","x-mcp-tool":"verify-credential","x-zernio":["GET /v1/auth/verify"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["credential"]},"type":{"type":"string","enum":["api_key","oauth","session"]},"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"permission":{"type":"string","enum":["full","read"]},"scopes":{"type":"array","items":{"type":"string"}},"api_key_id":{"type":["null","string"]},"client_id":{"type":["null","string"]},"user_id":{"type":["null","string"]},"profile_ids":{"type":["null","array"],"items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/api-keys":{"get":{"operationId":"listApiKeys","summary":"List API keys","tags":["API Keys"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","last_used_at","name"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"name","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"api_keys","x-mcp-tool":"list-api-keys","x-zernio":["GET /v1/api-keys"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["api_key"]},"id":{"type":"string"},"name":{"type":"string"},"permission":{"type":"string","enum":["full","read"]},"profile_ids":{"type":["null","array"],"items":{"type":"string"}},"prefix":{"type":"string","description":"Non-secret display prefix, e.g. sk_live_abcd"},"key":{"type":"string","description":"The secret. Only returned on create and regenerate; store it safely."},"last_used_at":{"type":["null","string"],"format":"date-time"},"expires_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createApiKey","summary":"Create an API key","tags":["API Keys"],"description":"The response contains the secret `key`. It is never shown again.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"permission":{"type":"string","enum":["full","read"],"default":"full"},"profile_ids":{"type":["array","null"],"items":{"type":"string"},"maxItems":500,"description":"Restrict the key to these profiles (null = all)"},"expires_at":{"type":["string","null"],"format":"date-time"},"expires_in_days":{"type":"integer","minimum":1,"maximum":3650,"description":"Alternative to expires_at"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"api_keys","x-mcp-tool":"create-api-key","x-idempotent":true,"x-zernio":["POST /v1/api-keys"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["api_key"]},"id":{"type":"string"},"name":{"type":"string"},"permission":{"type":"string","enum":["full","read"]},"profile_ids":{"type":["null","array"],"items":{"type":"string"}},"prefix":{"type":"string","description":"Non-secret display prefix, e.g. sk_live_abcd"},"key":{"type":"string","description":"The secret. Only returned on create and regenerate; store it safely."},"last_used_at":{"type":["null","string"],"format":"date-time"},"expires_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/api-keys/{id}":{"get":{"operationId":"getApiKey","summary":"Get an API key","tags":["API Keys"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"key_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"apiKey id (key_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"api_keys","x-mcp-tool":"get-api-key","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["api_key"]},"id":{"type":"string"},"name":{"type":"string"},"permission":{"type":"string","enum":["full","read"]},"profile_ids":{"type":["null","array"],"items":{"type":"string"}},"prefix":{"type":"string","description":"Non-secret display prefix, e.g. sk_live_abcd"},"key":{"type":"string","description":"The secret. Only returned on create and regenerate; store it safely."},"last_used_at":{"type":["null","string"],"format":"date-time"},"expires_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateApiKey","summary":"Update an API key","tags":["API Keys"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"permission":{"type":"string","enum":["full","read"]},"profile_ids":{"type":["array","null"],"items":{"type":"string"},"maxItems":500,"description":"Restrict the key to these profiles (null = all)"},"expires_at":{"type":["string","null"],"format":"date-time"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"key_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"apiKey id (key_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"api_keys","x-mcp-tool":"update-api-key","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["api_key"]},"id":{"type":"string"},"name":{"type":"string"},"permission":{"type":"string","enum":["full","read"]},"profile_ids":{"type":["null","array"],"items":{"type":"string"}},"prefix":{"type":"string","description":"Non-secret display prefix, e.g. sk_live_abcd"},"key":{"type":"string","description":"The secret. Only returned on create and regenerate; store it safely."},"last_used_at":{"type":["null","string"],"format":"date-time"},"expires_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteApiKey","summary":"Delete an API key","tags":["API Keys"],"description":"Revokes the key immediately.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"key_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"apiKey id (key_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"api_keys","x-mcp-tool":"delete-api-key","x-zernio":["DELETE /v1/api-keys/{keyId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["api_key"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/api-keys/{id}/regenerate":{"post":{"operationId":"regenerateApiKey","summary":"Regenerate an API key","tags":["API Keys"],"description":"Issues a new secret for the same key; the old secret stops working.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"key_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"apiKey id (key_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"destructive","x-toolset":"api_keys","x-mcp-tool":"regenerate-api-key","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["api_key"]},"id":{"type":"string"},"name":{"type":"string"},"permission":{"type":"string","enum":["full","read"]},"profile_ids":{"type":["null","array"],"items":{"type":"string"}},"prefix":{"type":"string","description":"Non-secret display prefix, e.g. sk_live_abcd"},"key":{"type":"string","description":"The secret. Only returned on create and regenerate; store it safely."},"last_used_at":{"type":["null","string"],"format":"date-time"},"expires_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/webhooks":{"get":{"operationId":"listWebhooks","summary":"List webhooks","tags":["Webhooks"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name","last_delivery_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"enabled","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"webhooks","x-mcp-tool":"list-webhooks","x-zernio":["GET /v1/webhooks/settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["webhook"]},"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"enabled":{"type":"boolean"},"all_events":{"type":"boolean"},"events":{"type":"array","items":{"type":"string"}},"profile_ids":{"type":["null","array"],"items":{"type":"string"}},"secret":{"type":"string","description":"Signing secret. Only returned on create and reset-secret."},"last_delivery_at":{"type":["null","string"],"format":"date-time"},"failure_count":{"type":"integer"},"disabled_reason":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createWebhook","summary":"Create a webhook","tags":["Webhooks"],"description":"The response contains the signing `secret`; it is only shown again after reset-secret.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","url"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"string","minLength":8,"maxLength":2048},"events":{"type":"array","items":{"type":"string","enum":["*","post.scheduled","post.publishing","post.published","post.partially_published","post.failed","post.deleted","post.unpublished","post.cancelled","post.edited","post.recycled","post.approval_requested","post.approved","post.rejected","posting.published","posting.failed","account.connected","account.disconnected","account.needs_reconnect","account.updated","message.received","message.sent","message.delivered","message.read","message.failed","message.edited","message.deleted","reaction.received","conversation.created","conversation.updated","conversation.control_changed","comment.received","comment.replied","comment.hidden","comment.unhidden","comment.deleted","review.received","review.updated","review.replied","mention.received","contact.created","contact.updated","contact.deleted","contact.tag_added","contact.tag_removed","contact.field_changed","broadcast.scheduled","broadcast.sent","broadcast.failed","broadcast.sending","broadcast.cancelled","sequence.enrolled","sequence.step_sent","sequence.completed","sequence.exited","workflow.triggered","workflow.completed","workflow.failed","sms.received","sms.sent","sms.delivered","sms.failed","call.started","call.completed","call.missed","call.received","call.ended","call.failed","sms.opted_out","sms.opted_in","sms.registration.status_updated","sms.registration.action_required","call.recording_ready","call.transcription_ready","rcs.agent.status_updated","rcs.test_device.updated","rcs.received","rcs.sent","rcs.delivered","rcs.read","rcs.failed","imessage.received","imessage.sent","imessage.delivered","imessage.failed","imessage.sender.status_updated","imessage.subscription_updated","imessage.group.updated","phone_number.activated","phone_number.declined","phone_number.action_required","phone_number.verification_required","phone_number.kyc_submitted","phone_number.suspended","phone_number.reactivated","phone_number.released","phone_number.stock_available","phone_number.port_in.status_updated","branded_calling.identity.status_updated","branded_calling.identity.action_required","branded_calling.number.status_updated","verification.approved","verification.failed","ad.created","ad.updated","ad.deleted","ad.status_changed","ad.video.processed","ad_campaign.created","ad_campaign.updated","ad_campaign.deleted","ad_audience.created","ad_audience.deleted","ad_insights_report.completed","ad_connection.connected","ad_connection.disconnected","ad_connection.needs_reconnect","ad_account.initial_sync_completed","ad_account.sync_failed","ad_account.sync_recovered","lead.received","ad_account.created","ad_account.updated","analytics.synced","support_run.completed","support_run.failed","member.joined","member.removed","webhook.test","billing.subscription_created","billing.subscription_updated","billing.subscription_canceled","billing.invoice_paid","billing.payment_failed","billing.credits_purchased","billing.accounts_over_limit"]},"maxItems":200,"uniqueItems":true},"all_events":{"type":"boolean"},"profile_ids":{"type":["array","null"],"items":{"type":"string"},"maxItems":500},"enabled":{"type":"boolean","default":true},"secret":{"type":"string","minLength":16,"maxLength":256,"description":"Bring your own signing secret (default: generated)"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"webhooks","x-mcp-tool":"create-webhook","x-idempotent":true,"x-feature":"webhooks","x-zernio":["POST /v1/webhooks/settings"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["webhook"]},"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"enabled":{"type":"boolean"},"all_events":{"type":"boolean"},"events":{"type":"array","items":{"type":"string"}},"profile_ids":{"type":["null","array"],"items":{"type":"string"}},"secret":{"type":"string","description":"Signing secret. Only returned on create and reset-secret."},"last_delivery_at":{"type":["null","string"],"format":"date-time"},"failure_count":{"type":"integer"},"disabled_reason":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/webhooks/{id}":{"get":{"operationId":"getWebhook","summary":"Get a webhook","tags":["Webhooks"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"webhook id (wh_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"webhooks","x-mcp-tool":"get-webhook","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["webhook"]},"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"enabled":{"type":"boolean"},"all_events":{"type":"boolean"},"events":{"type":"array","items":{"type":"string"}},"profile_ids":{"type":["null","array"],"items":{"type":"string"}},"secret":{"type":"string","description":"Signing secret. Only returned on create and reset-secret."},"last_delivery_at":{"type":["null","string"],"format":"date-time"},"failure_count":{"type":"integer"},"disabled_reason":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateWebhook","summary":"Update a webhook","tags":["Webhooks"],"description":"Re-enabling a disabled webhook resets its failure streak.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"string","minLength":8,"maxLength":2048},"events":{"type":"array","items":{"type":"string","enum":["*","post.scheduled","post.publishing","post.published","post.partially_published","post.failed","post.deleted","post.unpublished","post.cancelled","post.edited","post.recycled","post.approval_requested","post.approved","post.rejected","posting.published","posting.failed","account.connected","account.disconnected","account.needs_reconnect","account.updated","message.received","message.sent","message.delivered","message.read","message.failed","message.edited","message.deleted","reaction.received","conversation.created","conversation.updated","conversation.control_changed","comment.received","comment.replied","comment.hidden","comment.unhidden","comment.deleted","review.received","review.updated","review.replied","mention.received","contact.created","contact.updated","contact.deleted","contact.tag_added","contact.tag_removed","contact.field_changed","broadcast.scheduled","broadcast.sent","broadcast.failed","broadcast.sending","broadcast.cancelled","sequence.enrolled","sequence.step_sent","sequence.completed","sequence.exited","workflow.triggered","workflow.completed","workflow.failed","sms.received","sms.sent","sms.delivered","sms.failed","call.started","call.completed","call.missed","call.received","call.ended","call.failed","sms.opted_out","sms.opted_in","sms.registration.status_updated","sms.registration.action_required","call.recording_ready","call.transcription_ready","rcs.agent.status_updated","rcs.test_device.updated","rcs.received","rcs.sent","rcs.delivered","rcs.read","rcs.failed","imessage.received","imessage.sent","imessage.delivered","imessage.failed","imessage.sender.status_updated","imessage.subscription_updated","imessage.group.updated","phone_number.activated","phone_number.declined","phone_number.action_required","phone_number.verification_required","phone_number.kyc_submitted","phone_number.suspended","phone_number.reactivated","phone_number.released","phone_number.stock_available","phone_number.port_in.status_updated","branded_calling.identity.status_updated","branded_calling.identity.action_required","branded_calling.number.status_updated","verification.approved","verification.failed","ad.created","ad.updated","ad.deleted","ad.status_changed","ad.video.processed","ad_campaign.created","ad_campaign.updated","ad_campaign.deleted","ad_audience.created","ad_audience.deleted","ad_insights_report.completed","ad_connection.connected","ad_connection.disconnected","ad_connection.needs_reconnect","ad_account.initial_sync_completed","ad_account.sync_failed","ad_account.sync_recovered","lead.received","ad_account.created","ad_account.updated","analytics.synced","support_run.completed","support_run.failed","member.joined","member.removed","webhook.test","billing.subscription_created","billing.subscription_updated","billing.subscription_canceled","billing.invoice_paid","billing.payment_failed","billing.credits_purchased","billing.accounts_over_limit"]},"maxItems":200,"uniqueItems":true},"all_events":{"type":"boolean"},"profile_ids":{"type":["array","null"],"items":{"type":"string"},"maxItems":500},"enabled":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"webhook id (wh_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"webhooks","x-mcp-tool":"update-webhook","x-zernio":["PUT /v1/webhooks/settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["webhook"]},"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"enabled":{"type":"boolean"},"all_events":{"type":"boolean"},"events":{"type":"array","items":{"type":"string"}},"profile_ids":{"type":["null","array"],"items":{"type":"string"}},"secret":{"type":"string","description":"Signing secret. Only returned on create and reset-secret."},"last_delivery_at":{"type":["null","string"],"format":"date-time"},"failure_count":{"type":"integer"},"disabled_reason":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteWebhook","summary":"Delete a webhook","tags":["Webhooks"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"webhook id (wh_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"webhooks","x-mcp-tool":"delete-webhook","x-zernio":["DELETE /v1/webhooks/settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["webhook"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/webhooks/{id}/test":{"post":{"operationId":"testWebhook","summary":"Send a test event","tags":["Webhooks"],"description":"Sends one signed sample event now and returns the receiver response. Not retried.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["post.scheduled","post.publishing","post.published","post.partially_published","post.failed","post.deleted","post.unpublished","post.cancelled","post.edited","post.recycled","post.approval_requested","post.approved","post.rejected","posting.published","posting.failed","account.connected","account.disconnected","account.needs_reconnect","account.updated","message.received","message.sent","message.delivered","message.read","message.failed","message.edited","message.deleted","reaction.received","conversation.created","conversation.updated","conversation.control_changed","comment.received","comment.replied","comment.hidden","comment.unhidden","comment.deleted","review.received","review.updated","review.replied","mention.received","contact.created","contact.updated","contact.deleted","contact.tag_added","contact.tag_removed","contact.field_changed","broadcast.scheduled","broadcast.sent","broadcast.failed","broadcast.sending","broadcast.cancelled","sequence.enrolled","sequence.step_sent","sequence.completed","sequence.exited","workflow.triggered","workflow.completed","workflow.failed","sms.received","sms.sent","sms.delivered","sms.failed","call.started","call.completed","call.missed","call.received","call.ended","call.failed","sms.opted_out","sms.opted_in","sms.registration.status_updated","sms.registration.action_required","call.recording_ready","call.transcription_ready","rcs.agent.status_updated","rcs.test_device.updated","rcs.received","rcs.sent","rcs.delivered","rcs.read","rcs.failed","imessage.received","imessage.sent","imessage.delivered","imessage.failed","imessage.sender.status_updated","imessage.subscription_updated","imessage.group.updated","phone_number.activated","phone_number.declined","phone_number.action_required","phone_number.verification_required","phone_number.kyc_submitted","phone_number.suspended","phone_number.reactivated","phone_number.released","phone_number.stock_available","phone_number.port_in.status_updated","branded_calling.identity.status_updated","branded_calling.identity.action_required","branded_calling.number.status_updated","verification.approved","verification.failed","ad.created","ad.updated","ad.deleted","ad.status_changed","ad.video.processed","ad_campaign.created","ad_campaign.updated","ad_campaign.deleted","ad_audience.created","ad_audience.deleted","ad_insights_report.completed","ad_connection.connected","ad_connection.disconnected","ad_connection.needs_reconnect","ad_account.initial_sync_completed","ad_account.sync_failed","ad_account.sync_recovered","lead.received","ad_account.created","ad_account.updated","analytics.synced","support_run.completed","support_run.failed","member.joined","member.removed","webhook.test","billing.subscription_created","billing.subscription_updated","billing.subscription_canceled","billing.invoice_paid","billing.payment_failed","billing.credits_purchased","billing.accounts_over_limit"],"description":"Sample event type (default webhook.test)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"webhook id (wh_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"external","x-toolset":"webhooks","x-mcp-tool":"test-webhook","x-rate-limit":{"max":10,"timeWindow":"1 minute"},"x-zernio":["POST /v1/webhooks/test"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["webhook_test"]},"success":{"type":"boolean"},"status_code":{"type":["null","integer"]},"duration_ms":{"type":["null","integer"]},"response_body":{"type":["null","string"]},"error":{"type":["null","string"]},"delivery":{"type":"object","properties":{"object":{"type":"string","enum":["webhook_delivery"]},"id":{"type":"string"},"webhook_id":{"type":"string"},"event_id":{"type":["null","string"]},"event_type":{"type":"string"},"attempt":{"type":"integer"},"status":{"type":"string","enum":["pending","delivered","failed"]},"status_code":{"type":["null","integer"]},"response_body":{"type":["null","string"]},"error":{"type":["null","string"]},"duration_ms":{"type":["null","integer"]},"test":{"type":"boolean"},"next_retry_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/webhooks/{id}/reset-secret":{"post":{"operationId":"resetWebhookSecret","summary":"Rotate the signing secret","tags":["Webhooks"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"webhook id (wh_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"destructive","x-toolset":"webhooks","x-mcp-tool":"reset-webhook-secret","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["webhook"]},"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"enabled":{"type":"boolean"},"all_events":{"type":"boolean"},"events":{"type":"array","items":{"type":"string"}},"profile_ids":{"type":["null","array"],"items":{"type":"string"}},"secret":{"type":"string","description":"Signing secret. Only returned on create and reset-secret."},"last_delivery_at":{"type":["null","string"],"format":"date-time"},"failure_count":{"type":"integer"},"disabled_reason":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/webhooks/deliveries":{"get":{"operationId":"listAllWebhookDeliveries","summary":"List webhook deliveries","tags":["Webhooks"],"description":"Delivery log across every webhook of the workspace.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","status_code","attempt"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"event_type","required":false},{"schema":{"type":"string"},"in":"query","name":"webhook_id","required":false},{"schema":{"type":"string"},"in":"query","name":"event_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"webhooks","x-mcp-tool":"list-all-webhook-deliveries","x-zernio":["GET /v1/webhooks/logs"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["webhook_delivery"]},"id":{"type":"string"},"webhook_id":{"type":"string"},"event_id":{"type":["null","string"]},"event_type":{"type":"string"},"attempt":{"type":"integer"},"status":{"type":"string","enum":["pending","delivered","failed"]},"status_code":{"type":["null","integer"]},"response_body":{"type":["null","string"]},"error":{"type":["null","string"]},"duration_ms":{"type":["null","integer"]},"test":{"type":"boolean"},"next_retry_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/webhooks/deliveries/{id}":{"get":{"operationId":"getWebhookDelivery","summary":"Get a webhook delivery","tags":["Webhooks"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"whd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"webhookDelivery id (whd_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"webhooks","x-mcp-tool":"get-webhook-delivery","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["webhook_delivery"]},"id":{"type":"string"},"webhook_id":{"type":"string"},"event_id":{"type":["null","string"]},"event_type":{"type":"string"},"attempt":{"type":"integer"},"status":{"type":"string","enum":["pending","delivered","failed"]},"status_code":{"type":["null","integer"]},"response_body":{"type":["null","string"]},"error":{"type":["null","string"]},"duration_ms":{"type":["null","integer"]},"test":{"type":"boolean"},"next_retry_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/webhooks/deliveries/{id}/redeliver":{"post":{"operationId":"redeliverWebhookDelivery","summary":"Redeliver an event","tags":["Webhooks"],"description":"Queues a new delivery of the same event to the same webhook.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"whd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"webhookDelivery id (whd_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"external","x-toolset":"webhooks","x-mcp-tool":"redeliver-webhook-delivery","x-idempotent":true,"x-rate-limit":{"max":60,"timeWindow":"1 minute"},"x-zernio":["POST /v1/webhooks/logs/redeliver"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["webhook_delivery"]},"id":{"type":"string"},"webhook_id":{"type":"string"},"event_id":{"type":["null","string"]},"event_type":{"type":"string"},"attempt":{"type":"integer"},"status":{"type":"string","enum":["pending","delivered","failed"]},"status_code":{"type":["null","integer"]},"response_body":{"type":["null","string"]},"error":{"type":["null","string"]},"duration_ms":{"type":["null","integer"]},"test":{"type":"boolean"},"next_retry_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/webhooks/{id}/deliveries":{"get":{"operationId":"listWebhookDeliveries","summary":"List a webhook's deliveries","tags":["Webhooks"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","status_code","attempt"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"event_type","required":false},{"schema":{"type":"string"},"in":"query","name":"webhook_id","required":false},{"schema":{"type":"string"},"in":"query","name":"event_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"webhook id (wh_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"webhooks","x-mcp-tool":"list-webhook-deliveries","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["webhook_delivery"]},"id":{"type":"string"},"webhook_id":{"type":"string"},"event_id":{"type":["null","string"]},"event_type":{"type":"string"},"attempt":{"type":"integer"},"status":{"type":"string","enum":["pending","delivered","failed"]},"status_code":{"type":["null","integer"]},"response_body":{"type":["null","string"]},"error":{"type":["null","string"]},"duration_ms":{"type":["null","integer"]},"test":{"type":"boolean"},"next_retry_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/webhooks/{id}/retry-failed":{"post":{"operationId":"retryFailedWebhookDeliveries","summary":"Retry failed deliveries","tags":["Webhooks"],"description":"Re-queues failed deliveries from the last 3 days.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wh_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"webhook id (wh_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"external","x-toolset":"webhooks","x-mcp-tool":"retry-failed-webhook-deliveries","x-idempotent":true,"x-rate-limit":{"max":10,"timeWindow":"1 hour"},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["webhook_retry"]},"webhook_id":{"type":"string"},"retried":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/events/names":{"get":{"operationId":"listEventTypes","summary":"List event types","tags":["Events"],"description":"Every event type a webhook can subscribe to, with its group and description.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"webhooks","x-mcp-tool":"list-event-types","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["event_type"]},"type":{"type":"string"},"group":{"type":"string"},"description":{"type":"string"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/events":{"get":{"operationId":"listEvents","summary":"List events","tags":["Events"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"type","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"webhooks","x-mcp-tool":"list-events","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["event"]},"id":{"type":"string"},"type":{"type":"string"},"profile_id":{"type":["null","string"]},"data":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/events/{id}":{"get":{"operationId":"getEvent","summary":"Get an event","tags":["Events"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"evt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"event id (evt_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"webhooks","x-mcp-tool":"get-event","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["event"]},"id":{"type":"string"},"type":{"type":"string"},"profile_id":{"type":["null","string"]},"data":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/logs":{"get":{"operationId":"listRequestLogs","summary":"List API request logs","tags":["Logs"],"description":"Filter with `status`, `method`, `path`, `api_key_id`, `source`, `created_at.after` / `created_at.before`, or any `<field>.<condition>`.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","status","duration_ms"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"method","required":false},{"schema":{"type":"string"},"in":"query","name":"path","required":false},{"schema":{"type":"string"},"in":"query","name":"api_key_id","required":false},{"schema":{"type":"string"},"in":"query","name":"source","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"logs","x-mcp-tool":"list-request-logs","x-zernio":["GET /v1/logs"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["request_log"]},"id":{"type":"string"},"method":{"type":"string"},"path":{"type":"string"},"route":{"type":["null","string"]},"operation_id":{"type":["null","string"]},"source":{"type":"string","enum":["api","mcp"]},"status":{"type":"integer"},"duration_ms":{"type":["null","integer"]},"api_key_id":{"type":["null","string"]},"oauth_client_id":{"type":["null","string"]},"request_id":{"type":["null","string"]},"ip":{"type":["null","string"]},"user_agent":{"type":["null","string"]},"request_body":{"type":["null","object","array"],"additionalProperties":true},"response_body":{"type":["null","object","array"],"additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/logs/{id}":{"get":{"operationId":"getRequestLog","summary":"Get an API request log","tags":["Logs"],"description":"Includes the (redacted) request and response bodies.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"log_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"requestLog id (log_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"logs","x-mcp-tool":"get-request-log","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["request_log"]},"id":{"type":"string"},"method":{"type":"string"},"path":{"type":"string"},"route":{"type":["null","string"]},"operation_id":{"type":["null","string"]},"source":{"type":"string","enum":["api","mcp"]},"status":{"type":"integer"},"duration_ms":{"type":["null","integer"]},"api_key_id":{"type":["null","string"]},"oauth_client_id":{"type":["null","string"]},"request_id":{"type":["null","string"]},"ip":{"type":["null","string"]},"user_agent":{"type":["null","string"]},"request_body":{"type":["null","object","array"],"additionalProperties":true},"response_body":{"type":["null","object","array"],"additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/activity":{"get":{"operationId":"listActivity","summary":"List workspace activity","tags":["Logs"],"description":"Audit log of changes to workspace settings, members, API keys and webhooks.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"action","required":false},{"schema":{"type":"string"},"in":"query","name":"actor_type","required":false},{"schema":{"type":"string"},"in":"query","name":"target_type","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"logs","x-mcp-tool":"list-activity","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["activity"]},"id":{"type":"string"},"actor":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"action":{"type":"string"},"target":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/usage":{"get":{"operationId":"getUsage","summary":"Get usage","tags":["Billing"],"description":"Plan, limits and consumption for the current period: connected accounts against the allowance (plan included + extra accounts + lifetime + Apple seats), members, profiles, webhooks, API keys, posts, storage, API requests this hour, X API pass-through calls and spend, and prepaid credits. Also covers the deprecated `usage-stats` snapshot.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"billing","x-mcp-tool":"get-usage","x-roles":["owner","admin","billing"],"x-zernio":["GET /v1/usage","GET /v1/usage-stats"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["usage"]},"plan":{"type":"string","enum":["free","pro","business","enterprise"]},"interval":{"type":["null","string"]},"period_start":{"type":["null","string"],"format":"date-time"},"period_end":{"type":["null","string"],"format":"date-time"},"accounts":{"type":"object","properties":{"used":{"type":"integer"},"included":{"type":["null","integer"]},"extra_purchased":{"type":"integer"},"lifetime":{"type":"integer"},"apple":{"type":"integer"},"legacy_subscribed":{"type":"integer"},"limit":{"type":["null","integer"]},"available":{"type":["null","integer"]},"over_limit":{"type":"integer"},"paused":{"type":"integer"}}},"members":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":["null","integer"]}}},"profiles":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":["null","integer"]}}},"webhooks":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":["null","integer"]}}},"api_keys":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":["null","integer"]}}},"posts":{"type":"object","properties":{"this_month":{"type":"integer"},"limit_per_month":{"type":["null","integer"]}}},"storage":{"type":"object","properties":{"used_bytes":{"type":"integer"},"limit_bytes":{"type":["null","integer"]}}},"api":{"type":"object","properties":{"requests_this_hour":{"type":"integer"},"limit_per_hour":{"type":"integer"}}},"x_api":{"type":"object","properties":{"calls":{"type":"integer"},"spend_cents":{"type":"integer"},"calls_by_operation":{"type":"object","additionalProperties":{"type":"integer"}}}},"credits_cents":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/usage/x-api":{"get":{"operationId":"getXApiUsage","summary":"Get X API usage","tags":["Billing"],"description":"Metering of X API pass-through calls (debited from prepaid credits at cost) over a window: totals, per-operation breakdown and a day/month series. Pair with `GET /billing/x-pricing`. Profile-restricted keys only see their profiles’ accounts.","parameters":[{"schema":{"type":"string","enum":["cycle","prev_cycle","7d","30d","90d","12mo","custom"],"default":"cycle"},"in":"query","name":"range","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"from","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"to","required":false},{"schema":{"type":"string","enum":["day","month","total"],"default":"day"},"in":"query","name":"granularity","required":false},{"schema":{"type":"string","pattern":"^sa_[0-9A-Za-z]{27}$"},"in":"query","name":"account_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"billing","x-mcp-tool":"get-x-api-usage","x-roles":["owner","admin","billing"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["x_api_usage"]},"range":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"granularity":{"type":"string"},"totals":{"type":"object","properties":{"calls":{"type":"integer"},"spend_cents":{"type":"integer"},"spend_micro_usd":{"type":"integer"}}},"by_operation":{"type":"array","items":{"type":"object","properties":{"operation":{"type":"string"},"calls":{"type":"integer"},"spend_cents":{"type":"integer"}}}},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"calls":{"type":"integer"},"spend_cents":{"type":"integer"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/billing":{"get":{"operationId":"getBilling","summary":"Get billing overview","tags":["Billing"],"description":"Plan, billing interval, subscription status and period, extra accounts, recurring price, account allowance and publishing pause, payment method, invoices summary, upcoming invoice, credits and the dashboard banner.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"billing","x-mcp-tool":"get-billing","x-roles":["owner","admin","billing"],"x-zernio":["GET /v1/billing"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["billing"]},"plan":{"type":"string","enum":["free","pro","business","enterprise"]},"plan_name":{"type":"string"},"interval":{"type":["null","string"]},"status":{"type":"string"},"provider":{"type":"string","enum":["none","stripe","apple","ltd","enterprise"]},"customer_id":{"type":["null","string"]},"subscription_id":{"type":["null","string"]},"current_period_start":{"type":["null","string"],"format":"date-time"},"current_period_end":{"type":["null","string"],"format":"date-time"},"cancel_at_period_end":{"type":"boolean"},"canceled_at":{"type":["null","string"],"format":"date-time"},"extra_accounts":{"type":"integer"},"price":{"type":["null","object"],"properties":{"currency":{"type":"string"},"base_cents":{"type":"integer"},"extra_account_cents":{"type":"integer"},"extra_accounts_cents":{"type":"integer"},"total_cents":{"type":"integer"},"period":{"type":"string"}}},"accounts":{"type":"object","properties":{"used":{"type":"integer"},"included":{"type":["null","integer"]},"extra_purchased":{"type":"integer"},"lifetime":{"type":"integer"},"apple":{"type":"integer"},"legacy_subscribed":{"type":"integer"},"limit":{"type":["null","integer"]},"available":{"type":["null","integer"]},"over_limit":{"type":"integer"},"paused":{"type":"integer"}}},"publishing_paused":{"type":"object","properties":{"active":{"type":"boolean"},"account_ids":{"type":"array","items":{"type":"string"}}}},"banner":{"type":["null","object"],"properties":{"type":{"type":"string"},"severity":{"type":"string"},"message":{"type":"string"},"action":{"type":"string"}}},"payment_method":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["payment_method"]},"id":{"type":"string"},"type":{"type":"string"},"brand":{"type":["null","string"]},"last4":{"type":["null","string"]},"exp_month":{"type":["null","integer"]},"exp_year":{"type":["null","integer"]},"wallet":{"type":["null","string"]},"is_default":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"}}},"has_payment_method":{"type":"boolean"},"invoices":{"type":"object","properties":{"latest":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["invoice"]},"id":{"type":"string"},"number":{"type":["null","string"]},"status":{"type":["null","string"]},"currency":{"type":"string"},"amount_due_cents":{"type":"integer"},"amount_paid_cents":{"type":"integer"},"amount_remaining_cents":{"type":"integer"},"subtotal_cents":{"type":"integer"},"tax_cents":{"type":"integer"},"total_cents":{"type":"integer"},"billing_reason":{"type":["null","string"]},"description":{"type":["null","string"]},"period_start":{"type":["null","string"],"format":"date-time"},"period_end":{"type":["null","string"],"format":"date-time"},"hosted_invoice_url":{"type":["null","string"]},"invoice_pdf":{"type":["null","string"]},"due_date":{"type":["null","string"],"format":"date-time"},"paid_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"lines":{"type":"array","items":{"type":"object","properties":{"description":{"type":["null","string"]},"amount_cents":{"type":"integer"},"quantity":{"type":["null","integer"]},"period_start":{"type":["null","string"],"format":"date-time"},"period_end":{"type":["null","string"],"format":"date-time"}}}}}},"open_count":{"type":"integer"},"open_amount_cents":{"type":"integer"}}},"upcoming_invoice":{"type":["null","object"],"properties":{"amount_due_cents":{"type":"integer"},"currency":{"type":"string"},"next_payment_attempt":{"type":["null","string"],"format":"date-time"}}},"credits_cents":{"type":"integer"},"x_usage_blocked":{"type":"boolean"},"legacy":{"type":"object","properties":{"billing_mode":{"type":"string"},"lifetime_seats":{"type":"integer"},"subscribed_seats":{"type":"integer"},"apple_seats":{"type":"integer"},"source":{"type":["null","string"]},"metered":{"type":"boolean"}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/billing/plans":{"get":{"operationId":"listPlans","summary":"List plans","tags":["Billing"],"description":"Prices (`price_cents` per month, `year` = per month billed yearly; `billed_cents` per billing period), extra account prices, limits and features of every plan.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"billing","x-mcp-tool":"list-plans","x-roles":["owner","admin","billing"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["plan"]},"id":{"type":"string","enum":["free","pro","business","enterprise"]},"name":{"type":"string"},"rank":{"type":"integer"},"self_serve":{"type":"boolean"},"current":{"type":"boolean"},"price_cents":{"type":"object","properties":{"month":{"type":["null","integer"]},"year":{"type":["null","integer"]}}},"billed_cents":{"type":"object","properties":{"month":{"type":["null","integer"]},"year":{"type":["null","integer"]}}},"extra_account_cents":{"type":"object","properties":{"month":{"type":["null","integer"]},"year":{"type":["null","integer"]}}},"extra_account_billed_cents":{"type":"object","properties":{"month":{"type":["null","integer"]},"year":{"type":["null","integer"]}}},"limits":{"type":"object","additionalProperties":{"type":["null","integer"]}},"features":{"type":"object","additionalProperties":{"type":"boolean"}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/billing/x-pricing":{"get":{"operationId":"getXPricing","summary":"Get X API pricing","tags":["Billing"],"description":"The X API pass-through price table (zero markup) by operation and tier. Safe to cache for a billing period.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"billing","x-mcp-tool":"get-x-pricing","x-roles":["owner","admin","billing"],"x-zernio":["GET /v1/billing/x-pricing"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["x_pricing"]},"currency":{"type":"string"},"markup":{"type":"string"},"source":{"type":"string"},"last_verified":{"type":"string"},"tiers":{"type":"array","items":{"type":"object","properties":{"tier":{"type":"string"},"price_per_call_usd":{"type":"number"},"operation_count":{"type":"integer"}}}},"operations":{"type":"array","items":{"type":"object","properties":{"operation":{"type":"string"},"display_name":{"type":"string"},"price_per_call_usd":{"type":"number"},"price_per_call_cents":{"type":"number"},"price_micro_usd":{"type":"integer"},"tier":{"type":"string"},"triggered_by":{"type":"array","items":{"type":"string"}}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/billing/credits":{"get":{"operationId":"getBillingCredits","summary":"Get prepaid credits","tags":["Billing"],"description":"Credit balance (USD cents) used for X API pass-through calls, whether X actions are blocked, and the credit packs for sale.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"billing","x-mcp-tool":"get-billing-credits","x-roles":["owner","admin","billing"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["credits"]},"balance_cents":{"type":"integer"},"x_usage_blocked":{"type":"boolean"},"packs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"price_cents":{"type":"integer"},"credits_cents":{"type":"integer"},"ios_product_id":{"type":["null","string"]}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/billing/preview":{"get":{"operationId":"previewBillingChange","summary":"Preview a plan change","tags":["Billing"],"description":"Recurring price and the proration due now for switching plan, interval or extra accounts. Without a subscription the preview is the first period (`requires_checkout: true`). Upgrades are invoiced immediately; downgrades credit the next invoice.","parameters":[{"schema":{"type":"string","enum":["free","pro","business","enterprise"]},"in":"query","name":"plan","required":true},{"schema":{"type":"string","enum":["month","year"]},"in":"query","name":"interval","required":false},{"schema":{"type":"integer","minimum":0,"maximum":100000},"in":"query","name":"extra_accounts","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"billing","x-mcp-tool":"preview-billing-change","x-roles":["owner","admin","billing"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["billing_preview"]},"plan":{"type":"string"},"interval":{"type":"string"},"extra_accounts":{"type":"integer"},"change_type":{"type":"string","enum":["new","upgrade","downgrade","interval_change","extra_accounts","none"]},"requires_checkout":{"type":"boolean"},"currency":{"type":"string"},"recurring":{"type":"object","properties":{"base_cents":{"type":"integer"},"extra_accounts_cents":{"type":"integer"},"total_cents":{"type":"integer"},"period":{"type":"string"}}},"amount_due_now_cents":{"type":"integer"},"proration_date":{"type":["null","integer"]},"lines":{"type":"array","items":{"type":"object","properties":{"description":{"type":["null","string"]},"amount_cents":{"type":"integer"},"proration":{"type":"boolean"},"period_start":{"type":["null","string"],"format":"date-time"},"period_end":{"type":["null","string"],"format":"date-time"}}}},"next_invoice_at":{"type":["null","string"],"format":"date-time"},"accounts":{"type":"object","properties":{"used":{"type":"integer"},"limit_after":{"type":["null","integer"]},"over_limit_after":{"type":"integer"}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/billing/invoices":{"get":{"operationId":"listBillingInvoices","summary":"List invoices","tags":["Billing"],"description":"Stripe invoices of the workspace, newest first, with hosted page and PDF links.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["draft","open","paid","uncollectible","void"]},"in":"query","name":"status","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"billing","x-mcp-tool":"list-billing-invoices","x-roles":["owner","admin","billing"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["invoice"]},"id":{"type":"string"},"number":{"type":["null","string"]},"status":{"type":["null","string"]},"currency":{"type":"string"},"amount_due_cents":{"type":"integer"},"amount_paid_cents":{"type":"integer"},"amount_remaining_cents":{"type":"integer"},"subtotal_cents":{"type":"integer"},"tax_cents":{"type":"integer"},"total_cents":{"type":"integer"},"billing_reason":{"type":["null","string"]},"description":{"type":["null","string"]},"period_start":{"type":["null","string"],"format":"date-time"},"period_end":{"type":["null","string"],"format":"date-time"},"hosted_invoice_url":{"type":["null","string"]},"invoice_pdf":{"type":["null","string"]},"due_date":{"type":["null","string"],"format":"date-time"},"paid_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"lines":{"type":"array","items":{"type":"object","properties":{"description":{"type":["null","string"]},"amount_cents":{"type":"integer"},"quantity":{"type":["null","integer"]},"period_start":{"type":["null","string"],"format":"date-time"},"period_end":{"type":["null","string"],"format":"date-time"}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/billing/invoices/{id}":{"get":{"operationId":"getBillingInvoice","summary":"Get an invoice","tags":["Billing"],"parameters":[{"schema":{"type":"string","pattern":"^in_[A-Za-z0-9_]+$"},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"billing","x-mcp-tool":"get-billing-invoice","x-roles":["owner","admin","billing"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["invoice"]},"id":{"type":"string"},"number":{"type":["null","string"]},"status":{"type":["null","string"]},"currency":{"type":"string"},"amount_due_cents":{"type":"integer"},"amount_paid_cents":{"type":"integer"},"amount_remaining_cents":{"type":"integer"},"subtotal_cents":{"type":"integer"},"tax_cents":{"type":"integer"},"total_cents":{"type":"integer"},"billing_reason":{"type":["null","string"]},"description":{"type":["null","string"]},"period_start":{"type":["null","string"],"format":"date-time"},"period_end":{"type":["null","string"],"format":"date-time"},"hosted_invoice_url":{"type":["null","string"]},"invoice_pdf":{"type":["null","string"]},"due_date":{"type":["null","string"],"format":"date-time"},"paid_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"lines":{"type":"array","items":{"type":"object","properties":{"description":{"type":["null","string"]},"amount_cents":{"type":"integer"},"quantity":{"type":["null","integer"]},"period_start":{"type":["null","string"],"format":"date-time"},"period_end":{"type":["null","string"],"format":"date-time"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/me/connected-apps":{"get":{"operationId":"listConnectedApps","summary":"List connected apps","tags":["Connected Apps"],"description":"With an API key: apps that can reach this workspace (admin keys). In the dashboard: apps you approved.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"account","x-mcp-tool":null,"x-zernio":["GET /v1/me/connected-apps"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["connected_app"]},"client_id":{"type":"string"},"client_name":{"type":"string"},"client_uri":{"type":["null","string"]},"logo_uri":{"type":["null","string"]},"scopes":{"type":"array","items":{"type":"string"}},"workspaces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"role":{"type":["null","string"]}}}},"created_at":{"type":["null","string"],"format":"date-time"},"last_used_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/me/connected-apps/{clientId}":{"delete":{"operationId":"revokeConnectedApp","summary":"Revoke a connected app","tags":["Connected Apps"],"description":"With an API key the app loses access to this workspace only; in the dashboard every grant you gave the app is revoked.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":2048},"in":"path","name":"clientId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"destructive","x-toolset":"account","x-mcp-tool":null,"x-zernio":["DELETE /v1/me/connected-apps/{clientId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connected_app"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics":{"get":{"operationId":"listPostAnalytics","summary":"List post analytics","tags":["Analytics"],"description":"Posts (Socialit and external) with their metrics per platform, paginated, plus an `overview`. Defaults to the last 90 days (max 366). Dates are UTC days (YYYY-MM-DD). History is limited by the plan (free 30 d, pro 365 d, business 730 d).","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"},{"schema":{"type":"string","enum":["all","socialit","late","external"]},"in":"query","name":"source","required":false,"description":"all (default), socialit (published through Socialit; alias late), external (imported)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","maxLength":2000},"in":"query","name":"tags","required":false,"description":"Comma-separated post tags (max 20): only Socialit posts carrying every tag (exact, case-sensitive). More than 200 matching published posts in the range → 400 (narrow the dates)."},{"schema":{"type":"string","enum":["date","engagement","impressions","reach","likes","comments","shares","saves","clicks","views","engagement_rate"],"default":"date"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"in":"query","name":"order","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"list-post-analytics","x-feature":"analytics","x-zernio":["GET /v1/analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["post_analytics"]},"id":{"type":"string"},"post_id":{"type":"string"},"status":{"type":"string"},"source":{"type":"string","enum":["socialit","external"]},"content":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"platform":{"type":"string"},"platform_post_url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"],"description":"First attached media of the post (video poster or image URL); null without media"},"sync_status":{"type":"string","enum":["synced","pending","partial","unavailable"]},"calculated":{"type":"boolean"},"metrics":{"type":["null","object"],"description":"Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"views":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"quotes":{"type":["null","number"]},"follows":{"type":["null","number"]},"profile_views":{"type":["null","number"]},"website_clicks":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"avg_view_percentage":{"type":["null","number"]},"completion_rate":{"type":["null","number"]},"replays":{"type":["null","number"]},"reposts":{"type":["null","number"]},"sends":{"type":["null","number"]},"outbound_clicks":{"type":["null","number"]},"pin_clicks":{"type":["null","number"]},"video_duration_seconds":{"type":["null","number"]},"earnings":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}},"platforms":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting_analytics"]},"posting_id":{"type":"string"},"account_id":{"type":["null","string"]},"account_username":{"type":["null","string"]},"platform":{"type":"string"},"status":{"type":"string"},"platform_post_id":{"type":["null","string"]},"platform_post_url":{"type":["null","string"]},"metrics":{"type":["null","object"],"description":"Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"views":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"quotes":{"type":["null","number"]},"follows":{"type":["null","number"]},"profile_views":{"type":["null","number"]},"website_clicks":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"avg_view_percentage":{"type":["null","number"]},"completion_rate":{"type":["null","number"]},"replays":{"type":["null","number"]},"reposts":{"type":["null","number"]},"sends":{"type":["null","number"]},"outbound_clicks":{"type":["null","number"]},"pin_clicks":{"type":["null","number"]},"video_duration_seconds":{"type":["null","number"]},"earnings":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}},"sync_status":{"type":"string","enum":["synced","pending","unavailable"]},"error_code":{"type":["null","string"]},"error_message":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}}},"last_synced_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"overview":{"type":"object","properties":{"total_posts":{"type":"integer"},"published_posts":{"type":"integer"},"scheduled_posts":{"type":"integer"},"last_synced_at":{"type":["null","string"],"format":"date-time"},"stale_accounts":{"type":"integer"}}}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/posts/{postId}":{"get":{"operationId":"getPostAnalytics","summary":"Get analytics for one post","tags":["Analytics"],"description":"Accepts a post id (pst_…), a posting id (sp_…) or a platform post id. Returns 202 (same body) while a metrics sync is pending; one is queued automatically.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"postId","required":true,"description":"Post id (pst_…), posting id (sp_…) or the platform post id"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-post-analytics","x-feature":"analytics","x-zernio":["GET /v1/analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_analytics"]},"id":{"type":"string"},"post_id":{"type":"string"},"status":{"type":"string"},"source":{"type":"string","enum":["socialit","external"]},"content":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"platform":{"type":"string"},"platform_post_url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"],"description":"First attached media of the post (video poster or image URL); null without media"},"sync_status":{"type":"string","enum":["synced","pending","partial","unavailable"]},"calculated":{"type":"boolean"},"metrics":{"type":["null","object"],"description":"Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"views":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"quotes":{"type":["null","number"]},"follows":{"type":["null","number"]},"profile_views":{"type":["null","number"]},"website_clicks":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"avg_view_percentage":{"type":["null","number"]},"completion_rate":{"type":["null","number"]},"replays":{"type":["null","number"]},"reposts":{"type":["null","number"]},"sends":{"type":["null","number"]},"outbound_clicks":{"type":["null","number"]},"pin_clicks":{"type":["null","number"]},"video_duration_seconds":{"type":["null","number"]},"earnings":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}},"platforms":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting_analytics"]},"posting_id":{"type":"string"},"account_id":{"type":["null","string"]},"account_username":{"type":["null","string"]},"platform":{"type":"string"},"status":{"type":"string"},"platform_post_id":{"type":["null","string"]},"platform_post_url":{"type":["null","string"]},"metrics":{"type":["null","object"],"description":"Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"views":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"quotes":{"type":["null","number"]},"follows":{"type":["null","number"]},"profile_views":{"type":["null","number"]},"website_clicks":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"avg_view_percentage":{"type":["null","number"]},"completion_rate":{"type":["null","number"]},"replays":{"type":["null","number"]},"reposts":{"type":["null","number"]},"sends":{"type":["null","number"]},"outbound_clicks":{"type":["null","number"]},"pin_clicks":{"type":["null","number"]},"video_duration_seconds":{"type":["null","number"]},"earnings":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}},"sync_status":{"type":"string","enum":["synced","pending","unavailable"]},"error_code":{"type":["null","string"]},"error_message":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}}},"last_synced_at":{"type":["null","string"],"format":"date-time"}}}}}},"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_analytics"]},"id":{"type":"string"},"post_id":{"type":"string"},"status":{"type":"string"},"source":{"type":"string","enum":["socialit","external"]},"content":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"platform":{"type":"string"},"platform_post_url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"],"description":"First attached media of the post (video poster or image URL); null without media"},"sync_status":{"type":"string","enum":["synced","pending","partial","unavailable"]},"calculated":{"type":"boolean"},"metrics":{"type":["null","object"],"description":"Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"views":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"quotes":{"type":["null","number"]},"follows":{"type":["null","number"]},"profile_views":{"type":["null","number"]},"website_clicks":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"avg_view_percentage":{"type":["null","number"]},"completion_rate":{"type":["null","number"]},"replays":{"type":["null","number"]},"reposts":{"type":["null","number"]},"sends":{"type":["null","number"]},"outbound_clicks":{"type":["null","number"]},"pin_clicks":{"type":["null","number"]},"video_duration_seconds":{"type":["null","number"]},"earnings":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}},"platforms":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting_analytics"]},"posting_id":{"type":"string"},"account_id":{"type":["null","string"]},"account_username":{"type":["null","string"]},"platform":{"type":"string"},"status":{"type":"string"},"platform_post_id":{"type":["null","string"]},"platform_post_url":{"type":["null","string"]},"metrics":{"type":["null","object"],"description":"Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"views":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"quotes":{"type":["null","number"]},"follows":{"type":["null","number"]},"profile_views":{"type":["null","number"]},"website_clicks":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"avg_view_percentage":{"type":["null","number"]},"completion_rate":{"type":["null","number"]},"replays":{"type":["null","number"]},"reposts":{"type":["null","number"]},"sends":{"type":["null","number"]},"outbound_clicks":{"type":["null","number"]},"pin_clicks":{"type":["null","number"]},"video_duration_seconds":{"type":["null","number"]},"earnings":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}},"sync_status":{"type":"string","enum":["synced","pending","unavailable"]},"error_code":{"type":["null","string"]},"error_message":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}}},"last_synced_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/delta":{"get":{"operationId":"getAnalyticsDelta","summary":"Analytics changed since a cursor","tags":["Analytics"],"description":"Cursor feed of changed post metric snapshots across every account you can read (oldest first). Call without `cursor` first to get the current position, load your baseline from GET /analytics, then poll with `next_cursor`. Cursors expire after 7 days.","parameters":[{"schema":{"type":"string","maxLength":200},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-analytics-delta","x-feature":"analytics","x-zernio":["GET /v1/analytics/delta"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["analytics_delta"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["analytics_change"]},"id":{"type":"string"},"post_id":{"type":"string"},"posting_id":{"type":"string"},"account_id":{"type":"string"},"profile_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_post_id":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"is_deleted":{"type":"boolean"},"metrics":{"type":["null","object"],"description":"Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"views":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"quotes":{"type":["null","number"]},"follows":{"type":["null","number"]},"profile_views":{"type":["null","number"]},"website_clicks":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"avg_view_percentage":{"type":["null","number"]},"completion_rate":{"type":["null","number"]},"replays":{"type":["null","number"]},"reposts":{"type":["null","number"]},"sends":{"type":["null","number"]},"outbound_clicks":{"type":["null","number"]},"pin_clicks":{"type":["null","number"]},"video_duration_seconds":{"type":["null","number"]},"earnings":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}}}}},"next_cursor":{"type":"string"},"has_more":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/post-timeline":{"get":{"operationId":"getPostTimeline","summary":"Get the daily metric history of a post","tags":["Analytics"],"description":"One row per day and platform (last snapshot of the day). Defaults to the last 90 days.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"post_id","required":true},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-post-timeline","x-feature":"analytics","x-zernio":["GET /v1/analytics/post-timeline"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_timeline"]},"post_id":{"type":"string"},"from_date":{"type":"string"},"to_date":{"type":"string"},"timeline":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"posting_id":{"type":"string"},"account_id":{"type":"string"},"platform":{"type":"string"},"platform_post_id":{"type":["null","string"]},"metrics":{"type":["null","object"],"description":"Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"views":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"quotes":{"type":["null","number"]},"follows":{"type":["null","number"]},"profile_views":{"type":["null","number"]},"website_clicks":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"avg_view_percentage":{"type":["null","number"]},"completion_rate":{"type":["null","number"]},"replays":{"type":["null","number"]},"reposts":{"type":["null","number"]},"sends":{"type":["null","number"]},"outbound_clicks":{"type":["null","number"]},"pin_clicks":{"type":["null","number"]},"video_duration_seconds":{"type":["null","number"]},"earnings":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/sync-external":{"post":{"operationId":"syncExternalPosts","summary":"Sync external posts of an account now","tags":["Analytics"],"description":"Fetches the account's latest posts from the network (including posts published natively), imports them with their metrics and, with `url` or `post_id`, returns the matching post. Debounced per account (15 s).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["account_id"],"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"Account id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"url":{"type":"string","maxLength":2000},"post_id":{"type":"string","maxLength":300,"description":"Platform post id"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"analytics","x-mcp-tool":"sync-external-posts","x-idempotent":true,"x-feature":"analytics","x-zernio":["POST /v1/posts/sync-external"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["external_post_sync"]},"account_id":{"type":"string"},"synced":{"type":"object","properties":{"posts_found":{"type":"integer"},"posts_synced":{"type":"integer"},"skipped":{"type":"boolean"}}},"found":{"type":["null","boolean"]},"post":{"anyOf":[{"type":"null"},{"type":"object","properties":{"object":{"type":"string","enum":["external_post"]},"post_id":{"type":"string"},"posting_id":{"type":"string"},"account_id":{"type":"string"},"platform":{"type":"string"},"platform_post_id":{"type":"string"},"platform_post_url":{"type":["string","null"]},"content":{"type":["string","null"]},"published_at":{"type":["string","null"],"format":"date-time"},"metrics":{"type":["object","null"],"description":"Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube","properties":{"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"views":{"type":["number","null"]},"likes":{"type":["number","null"]},"comments":{"type":["number","null"]},"shares":{"type":["number","null"]},"saves":{"type":["number","null"]},"clicks":{"type":["number","null"]},"quotes":{"type":["number","null"]},"follows":{"type":["number","null"]},"profile_views":{"type":["number","null"]},"website_clicks":{"type":["number","null"]},"watch_time_seconds":{"type":["number","null"]},"avg_view_duration_seconds":{"type":["number","null"]},"avg_view_percentage":{"type":["number","null"]},"completion_rate":{"type":["number","null"]},"replays":{"type":["number","null"]},"reposts":{"type":["number","null"]},"sends":{"type":["number","null"]},"outbound_clicks":{"type":["number","null"]},"pin_clicks":{"type":["number","null"]},"video_duration_seconds":{"type":["number","null"]},"earnings":{"type":["number","null"]},"engagements":{"type":["number","null"]},"engagement_rate":{"type":["number","null"]}}}}}]},"posts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["external_post"]},"post_id":{"type":"string"},"posting_id":{"type":"string"},"account_id":{"type":"string"},"platform":{"type":"string"},"platform_post_id":{"type":"string"},"platform_post_url":{"type":["null","string"]},"content":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"metrics":{"type":["null","object"],"description":"Normalized metrics; engagement_rate is a percentage (0-100), never computed for YouTube","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"views":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"quotes":{"type":["null","number"]},"follows":{"type":["null","number"]},"profile_views":{"type":["null","number"]},"website_clicks":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"avg_view_percentage":{"type":["null","number"]},"completion_rate":{"type":["null","number"]},"replays":{"type":["null","number"]},"reposts":{"type":["null","number"]},"sends":{"type":["null","number"]},"outbound_clicks":{"type":["null","number"]},"pin_clicks":{"type":["null","number"]},"video_duration_seconds":{"type":["null","number"]},"earnings":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/analytics/dashboard":{"get":{"operationId":"getAnalyticsDashboard","summary":"Get an analytics dashboard","tags":["Analytics"],"description":"Totals, follower growth, a daily series, top and recent posts in one call. Daily and total metrics use received attribution. Cross-network totals are Socialit-calculated (`calculated: true`) and come with a per-platform breakdown; YouTube numbers are never folded into derived rates. Pinterest analytics are never stored and are absent from stored aggregates.","parameters":[{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":true,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":true,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["previous_period"]},"in":"query","name":"compare","required":false},{"schema":{"type":"integer","minimum":0,"maximum":25,"default":5},"in":"query","name":"top_posts","required":false},{"schema":{"type":"integer","minimum":0,"maximum":25,"default":10},"in":"query","name":"recent_posts","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-analytics-dashboard","x-feature":"analytics","x-zernio":["GET /v1/analytics/dashboard"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["analytics_dashboard"]},"date_range":{"type":"object","properties":{"from_date":{"type":"string"},"to_date":{"type":"string"}}},"calculated":{"type":"boolean"},"totals":{"type":["null","object"],"properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"views":{"type":["null","number"]},"engagement":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}},"previous_totals":{"type":["null","object"],"properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"views":{"type":["null","number"]},"engagement":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}},"followers":{"type":["null","object"],"properties":{"current":{"type":["null","number"]},"gained":{"type":["null","number"]},"by_account":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":"string"},"platform":{"type":"string"},"current":{"type":["null","number"]},"gained":{"type":["null","number"]}}}}}},"previous_followers":{"type":["null","object"],"properties":{"current":{"type":["null","number"]},"gained":{"type":["null","number"]},"by_account":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":"string"},"platform":{"type":"string"},"current":{"type":["null","number"]},"gained":{"type":["null","number"]}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"engagement":{"type":["null","number"]},"views":{"type":["null","number"]},"followers_gained":{"type":["null","number"]}}}},"platform_breakdown":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"posts":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"views":{"type":["null","number"]},"engagement":{"type":["null","number"]},"followers":{"type":["null","number"]}}}},"top_posts":{"type":"array","items":{"type":"object","properties":{"post_id":{"type":"string"},"posting_id":{"type":"string"},"account_id":{"type":"string"},"platform":{"type":"string"},"content":{"type":["null","string"]},"platform_post_url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"metrics":{"type":"object","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"views":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}}}}},"recent_posts":{"type":"array","items":{"type":"object","properties":{"post_id":{"type":"string"},"posting_id":{"type":"string"},"account_id":{"type":"string"},"platform":{"type":"string"},"content":{"type":["null","string"]},"platform_post_url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"metrics":{"type":"object","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"views":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}}}}},"data_as_of":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/daily-metrics":{"get":{"operationId":"getDailyMetrics","summary":"Get daily aggregated metrics","tags":["Analytics"],"description":"Per-day post counts and summed metrics plus a platform breakdown. Defaults to the last 180 days. Cross-network totals are Socialit-calculated (`calculated: true`) and come with a per-platform breakdown; YouTube numbers are never folded into derived rates. Pinterest analytics are never stored and are absent from stored aggregates.","parameters":[{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["all","socialit","late","external"]},"in":"query","name":"source","required":false,"description":"all (default), socialit (published through Socialit; alias late), external (imported)"},{"schema":{"type":"string","enum":["publish","received"],"default":"publish"},"in":"query","name":"attribution","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-daily-metrics","x-feature":"analytics","x-zernio":["GET /v1/analytics/daily-metrics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["daily_metrics"]},"from_date":{"type":"string"},"to_date":{"type":"string"},"attribution":{"type":"string","enum":["publish","received"]},"calculated":{"type":"boolean"},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"post_count":{"type":"integer"},"platforms":{"type":"object","additionalProperties":{"type":"number"}},"metrics":{"type":"object","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"views":{"type":["null","number"]}}}}}},"platform_breakdown":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"post_count":{"type":"integer"},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"clicks":{"type":["null","number"]},"views":{"type":["null","number"]}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/best-time":{"get":{"operationId":"getBestTimeToPost","summary":"Get the best times to post","tags":["Analytics"],"description":"Average engagement of published posts by UTC weekday (0 = Sunday) and hour, best slots first.","parameters":[{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["all","socialit","late","external"]},"in":"query","name":"source","required":false,"description":"all (default), socialit (published through Socialit; alias late), external (imported)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-best-time-to-post","x-feature":"analytics","x-zernio":["GET /v1/analytics/best-time"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["best_time"]},"timezone":{"type":"string"},"slots":{"type":"array","items":{"type":"object","properties":{"day_of_week":{"type":"integer"},"hour":{"type":"integer"},"avg_engagement":{"type":["null","number"]},"post_count":{"type":"integer"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/content-decay":{"get":{"operationId":"getContentDecay","summary":"Get content performance decay","tags":["Analytics"],"description":"Average share of a post's final engagement reached 1h, 6h, 24h, 3d, 7d and 30d after publishing.","parameters":[{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["all","socialit","late","external"]},"in":"query","name":"source","required":false,"description":"all (default), socialit (published through Socialit; alias late), external (imported)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-content-decay","x-feature":"analytics","x-zernio":["GET /v1/analytics/content-decay"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["content_decay"]},"buckets":{"type":"array","items":{"type":"object","properties":{"bucket_order":{"type":"integer"},"bucket_label":{"type":"string"},"avg_pct_of_final":{"type":["null","number"]},"post_count":{"type":"integer"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/posting-frequency":{"get":{"operationId":"getPostingFrequency","summary":"Get posting frequency vs engagement","tags":["Analytics"],"description":"Average engagement rate and engagement per platform for each observed posts-per-week cadence.","parameters":[{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["all","socialit","late","external"]},"in":"query","name":"source","required":false,"description":"all (default), socialit (published through Socialit; alias late), external (imported)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-posting-frequency","x-feature":"analytics","x-zernio":["GET /v1/analytics/posting-frequency"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["posting_frequency"]},"frequency":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"posts_per_week":{"type":"integer"},"avg_engagement_rate":{"type":["null","number"]},"avg_engagement":{"type":["null","number"]},"weeks_count":{"type":"integer"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/accounts/{accountId}":{"get":{"operationId":"getAccountAnalytics","summary":"Get stored analytics of an account","tags":["Analytics"],"description":"Daily follower snapshots and normalized daily insights collected by the analytics sync (Pinterest: live, cached for an hour).","parameters":[{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-account-analytics","x-feature":"analytics","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_analytics"]},"account_id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"date_range":{"type":"object","properties":{"from_date":{"type":"string"},"to_date":{"type":"string"}}},"current":{"type":["null","object"],"properties":{"followers":{"type":["null","integer"]},"following":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"date":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"snapshots":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"followers":{"type":["null","integer"]},"following":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]}}}},"insights":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","additionalProperties":{"type":"number"}}}}},"totals":{"type":"object","additionalProperties":{"type":"number"}},"last_synced_at":{"type":["null","string"],"format":"date-time"},"cached":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/accounts/{accountId}/demographics":{"get":{"operationId":"getAccountDemographics","summary":"Get audience demographics of an account","tags":["Analytics"],"description":"Live audience demographics from the network (age, gender, country, city, locale where available).","parameters":[{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-account-demographics","x-feature":"analytics","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["demographics"]},"account_id":{"type":"string"},"platform":{"type":"string"},"metric":{"type":["null","string"]},"timeframe":{"type":["null","string"]},"video_id":{"type":["null","string"]},"title":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"snapshot_date":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"date_range":{"type":["null","object"],"properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"demographics":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}}},"note":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/accounts/{accountId}/reports/{report}":{"get":{"operationId":"getAccountReport","summary":"Run a network analytics report","tags":["Analytics"],"description":"Live network-specific report (e.g. YouTube traffic sources, Pinterest top pins, Threads benchmarks). Extra query parameters are passed to the report.","parameters":[{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"in":"path","name":"report","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-account-report","x-feature":"analytics","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["platform_report"]},"account_id":{"type":"string"},"platform":{"type":"string"},"report":{"type":"string"},"data":{"type":["null","object"],"additionalProperties":true,"description":"Provider report as returned (arrays are wrapped as { rows })"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/accounts/{accountId}/sync":{"post":{"operationId":"syncAccountAnalytics","summary":"Queue an analytics sync for an account","tags":["Analytics"],"description":"Refreshes stats, insights and post metrics in the background (202). `analytics.synced` fires when it completes.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":["object","null"],"additionalProperties":false,"properties":{"scope":{"type":"array","items":{"type":"string","enum":["stats","insights","posts"]},"minItems":1,"uniqueItems":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"analytics","x-mcp-tool":"sync-account-analytics","x-idempotent":true,"x-feature":"analytics","responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["analytics_sync"]},"account_id":{"type":"string"},"status":{"type":"string","enum":["queued"]},"scope":{"type":"array","items":{"type":"string"}},"queued_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/youtube/channel-insights":{"get":{"operationId":"getYoutubeChannelInsights","summary":"Get YouTube channel insights","tags":["Analytics"],"description":"Channel metrics from YouTube Analytics (2-3 day delay, max 89 days). Requires the yt-analytics.readonly scope.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false,"description":"Comma-separated metric names (network vocabulary)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["total_value","time_series"],"default":"total_value"},"in":"query","name":"metric_type","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-youtube-channel-insights","x-feature":"analytics","x-zernio":["GET /v1/analytics/youtube/channel-insights"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_insights"]},"account_id":{"type":"string"},"platform":{"type":"string"},"date_range":{"type":"object","properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"metric_type":{"type":"string","enum":["total_value","time_series"]},"breakdown":{"type":["null","string"]},"metrics":{"type":"object","additionalProperties":{"type":"object","properties":{"total":{"type":["null","number"]},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["null","number"]}}}},"breakdowns":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}},"unit":{"type":["null","string"]},"currency":{"type":["null","string"]}}}},"unavailable_metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"},"message":{"type":["null","string"]}}}},"data_delay":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/youtube/daily-views":{"get":{"operationId":"getYoutubeDailyViews","summary":"Get YouTube daily views of a video","tags":["Analytics"],"description":"Daily views, watch time and subscriber changes of one video (max 90 days; default ends 3 days ago).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"video_id","required":true},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-youtube-daily-views","x-feature":"analytics","x-zernio":["GET /v1/analytics/youtube/daily-views"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["youtube_daily_views"]},"account_id":{"type":"string"},"video_id":{"type":"string"},"title":{"type":["null","string"]},"duration_seconds":{"type":["null","integer"]},"date_range":{"type":"object","properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"provisional_since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"total_views":{"type":["null","number"]},"daily_views":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"views":{"type":["null","number"]},"estimated_minutes_watched":{"type":["null","number"]},"average_view_duration":{"type":["null","number"]},"average_view_percentage":{"type":["null","number"]},"subscribers_gained":{"type":["null","number"]},"subscribers_lost":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]}}}},"last_synced_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/youtube/video-retention":{"get":{"operationId":"getYoutubeVideoRetention","summary":"Get the YouTube audience retention curve of a video","tags":["Analytics"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"video_id","required":true},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-youtube-video-retention","x-feature":"analytics","x-zernio":["GET /v1/analytics/youtube/video-retention"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["youtube_video_retention"]},"account_id":{"type":"string"},"video_id":{"type":"string"},"title":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"duration_seconds":{"type":["null","integer"]},"date_range":{"type":"object","properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"provisional_since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"retention_curve":{"type":"array","items":{"type":"object","properties":{"elapsed_video_time_ratio":{"type":["null","number"]},"audience_watch_ratio":{"type":["null","number"]},"relative_retention_performance":{"type":["null","number"]},"started_watching":{"type":["null","number"]},"stopped_watching":{"type":["null","number"]},"total_segment_impressions":{"type":["null","number"]}}}},"note":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/youtube/demographics":{"get":{"operationId":"getYoutubeDemographics","summary":"Get YouTube audience demographics","tags":["Analytics"],"description":"Age and gender are viewer percentages; country values are views. Channel-wide or one video with `video_id`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","maxLength":64},"in":"query","name":"video_id","required":false},{"schema":{"type":"string"},"in":"query","name":"breakdown","required":false,"description":"age,gender,country"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-youtube-demographics","x-feature":"analytics","x-zernio":["GET /v1/analytics/youtube/demographics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["demographics"]},"account_id":{"type":"string"},"platform":{"type":"string"},"metric":{"type":["null","string"]},"timeframe":{"type":["null","string"]},"video_id":{"type":["null","string"]},"title":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"snapshot_date":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"date_range":{"type":["null","object"],"properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"demographics":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}}},"note":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/linkedin/org-aggregate-analytics":{"get":{"operationId":"getLinkedinOrgAnalytics","summary":"Get LinkedIn organization analytics","tags":["Analytics"],"description":"Share, follower and page statistics of a LinkedIn organization page (max 89 days).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false,"description":"Comma-separated metric names (network vocabulary)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["total_value","time_series"],"default":"total_value"},"in":"query","name":"metric_type","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-linkedin-org-analytics","x-feature":"analytics","x-zernio":["GET /v1/analytics/linkedin/org-aggregate-analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_insights"]},"account_id":{"type":"string"},"platform":{"type":"string"},"date_range":{"type":"object","properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"metric_type":{"type":"string","enum":["total_value","time_series"]},"breakdown":{"type":["null","string"]},"metrics":{"type":"object","additionalProperties":{"type":"object","properties":{"total":{"type":["null","number"]},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["null","number"]}}}},"breakdowns":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}},"unit":{"type":["null","string"]},"currency":{"type":["null","string"]}}}},"unavailable_metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"},"message":{"type":["null","string"]}}}},"data_delay":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/aggregate-analytics":{"get":{"operationId":"getLinkedinAggregateAnalytics","summary":"Get LinkedIn personal account aggregate stats","tags":["Analytics"],"description":"Totals or daily series across the member's posts (posts published through Socialit; LinkedIn API limitation).","parameters":[{"schema":{"type":"string","enum":["TOTAL","DAILY"],"default":"TOTAL"},"in":"query","name":"aggregation","required":false},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false,"description":"IMPRESSION,MEMBERS_REACHED,REACTION,COMMENT,RESHARE,POST_SAVE,POST_SEND"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-linkedin-aggregate-analytics","x-feature":"analytics","x-zernio":["GET /v1/accounts/{accountId}/linkedin-aggregate-analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["linkedin_aggregate_analytics"]},"account_id":{"type":"string"},"platform":{"type":"string"},"account_type":{"type":"string"},"username":{"type":["null","string"]},"aggregation":{"type":"string","enum":["TOTAL","DAILY"]},"date_range":{"type":"object","properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"analytics":{"type":"object","description":"TOTAL: numbers per metric; DAILY: [{ date, count }] per metric","additionalProperties":{"anyOf":[{"type":"number"},{"type":"null"},{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"count":{"type":["number","null"]}}}}]}},"skipped_metrics":{"type":"array","items":{"type":"string"}},"note":{"type":["null","string"]},"last_updated":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/post-analytics":{"get":{"operationId":"getLinkedinPostAnalytics","summary":"Get LinkedIn post stats","tags":["Analytics"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"urn","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-linkedin-post-analytics","x-feature":"analytics","x-zernio":["GET /v1/accounts/{accountId}/linkedin-post-analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["linkedin_post_analytics"]},"account_id":{"type":"string"},"platform":{"type":"string"},"account_type":{"type":"string"},"username":{"type":["null","string"]},"post_urn":{"type":"string"},"analytics":{"type":"object","properties":{"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"sends":{"type":["null","number"]},"clicks":{"type":["null","number"]},"views":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]}}},"last_updated":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/post-reactions":{"get":{"operationId":"getLinkedinPostReactions","summary":"Get LinkedIn post reactions","tags":["Analytics"],"description":"Individual reactions on an organization post (offset cursor).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"urn","required":true},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"integer","minimum":0,"default":0},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-linkedin-post-reactions","x-feature":"analytics","x-zernio":["GET /v1/accounts/{accountId}/linkedin-post-reactions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["linkedin_post_reactions"]},"account_id":{"type":"string"},"post_urn":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"reaction_type":{"type":["null","string"]},"reaction_label":{"type":["null","string"]},"reacted_at":{"type":["null","string"],"format":"date-time"},"from":{"type":"object","properties":{"urn":{"type":["null","string"]},"name":{"type":["null","string"]},"headline":{"type":["null","string"]},"username":{"type":["null","string"]},"profile_picture":{"type":["null","string"]},"profile_url":{"type":["null","string"]}}}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"total":{"type":["null","integer"]},"last_updated":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/tiktok/account-insights":{"get":{"operationId":"getTiktokAccountInsights","summary":"Get TikTok account insights","tags":["Analytics"],"description":"Live counters plus daily history joined from Socialit snapshots (max 89 days).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false,"description":"Comma-separated metric names (network vocabulary)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["total_value","time_series"],"default":"total_value"},"in":"query","name":"metric_type","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-tiktok-account-insights","x-feature":"analytics","x-zernio":["GET /v1/analytics/tiktok/account-insights"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_insights"]},"account_id":{"type":"string"},"platform":{"type":"string"},"date_range":{"type":"object","properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"metric_type":{"type":"string","enum":["total_value","time_series"]},"breakdown":{"type":["null","string"]},"metrics":{"type":"object","additionalProperties":{"type":"object","properties":{"total":{"type":["null","number"]},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["null","number"]}}}},"breakdowns":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}},"unit":{"type":["null","string"]},"currency":{"type":["null","string"]}}}},"unavailable_metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"},"message":{"type":["null","string"]}}}},"data_delay":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/facebook/page-insights":{"get":{"operationId":"getFacebookPageInsights","summary":"Get Facebook Page insights","tags":["Analytics"],"description":"Current (post-November 2025) Page metrics; followers_gained / followers_lost are synthesized from daily follows/unfollows (max 89 days).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false,"description":"Comma-separated metric names (network vocabulary)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["total_value","time_series"],"default":"total_value"},"in":"query","name":"metric_type","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-facebook-page-insights","x-feature":"analytics","x-zernio":["GET /v1/analytics/facebook/page-insights"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_insights"]},"account_id":{"type":"string"},"platform":{"type":"string"},"date_range":{"type":"object","properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"metric_type":{"type":"string","enum":["total_value","time_series"]},"breakdown":{"type":["null","string"]},"metrics":{"type":"object","additionalProperties":{"type":"object","properties":{"total":{"type":["null","number"]},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["null","number"]}}}},"breakdowns":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}},"unit":{"type":["null","string"]},"currency":{"type":["null","string"]}}}},"unavailable_metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"},"message":{"type":["null","string"]}}}},"data_delay":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/facebook/post-earnings":{"get":{"operationId":"getFacebookPostEarnings","summary":"Get lifetime monetization earnings of a Facebook post","tags":["Analytics"],"description":"Lifetime (cumulative) values in the platform's raw unit; never sum across posts or dates.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"query","name":"post_id","required":true},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false,"description":"Comma-separated metric names (network vocabulary)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-facebook-post-earnings","x-feature":"analytics","x-zernio":["GET /v1/analytics/facebook/post-earnings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_earnings"]},"account_id":{"type":"string"},"platform":{"type":"string"},"post_id":{"type":"string"},"period":{"type":"string","enum":["lifetime"]},"metrics":{"type":"object","additionalProperties":{"type":"object","properties":{"total":{"type":["null","number"]},"unit":{"type":["null","string"]},"currency":{"type":["null","string"]}}}},"unavailable_metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"},"message":{"type":["null","string"]}}}},"data_delay":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/facebook/demographics":{"get":{"operationId":"getFacebookDemographics","summary":"Get Facebook Page follower demographics","tags":["Analytics"],"description":"Followers by country and city (Meta removed age and gender for Pages in November 2025).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"breakdown","required":false,"description":"country,city"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-facebook-demographics","x-feature":"analytics","x-zernio":["GET /v1/analytics/facebook/demographics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["demographics"]},"account_id":{"type":"string"},"platform":{"type":"string"},"metric":{"type":["null","string"]},"timeframe":{"type":["null","string"]},"video_id":{"type":["null","string"]},"title":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"snapshot_date":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"date_range":{"type":["null","object"],"properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"demographics":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}}},"note":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/post-reactions":{"get":{"operationId":"getFacebookPostReactions","summary":"Get the reaction breakdown of a Facebook post","tags":["Analytics"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"query","name":"post_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-facebook-post-reactions","x-feature":"analytics","x-zernio":["GET /v1/accounts/{accountId}/facebook-post-reactions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["facebook_post_reactions"]},"account_id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"post_id":{"type":"string"},"total":{"type":["null","number"]},"breakdown":{"type":"object","properties":{"like":{"type":["null","number"]},"love":{"type":["null","number"]},"haha":{"type":["null","number"]},"wow":{"type":["null","number"]},"sad":{"type":["null","number"]},"angry":{"type":["null","number"]},"care":{"type":["null","number"]}}},"last_updated":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/instagram/account-insights":{"get":{"operationId":"getInstagramAccountInsights","summary":"Get Instagram account insights","tags":["Analytics"],"description":"Only `reach` supports metric_type=time_series (Instagram API limitation). Breakdowns need metric_type=total_value.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false,"description":"Comma-separated metric names (network vocabulary)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["total_value","time_series"],"default":"total_value"},"in":"query","name":"metric_type","required":false},{"schema":{"type":"string","enum":["media_product_type","follow_type","follower_type","contact_button_type"]},"in":"query","name":"breakdown","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-instagram-account-insights","x-feature":"analytics","x-zernio":["GET /v1/analytics/instagram/account-insights"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_insights"]},"account_id":{"type":"string"},"platform":{"type":"string"},"date_range":{"type":"object","properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"metric_type":{"type":"string","enum":["total_value","time_series"]},"breakdown":{"type":["null","string"]},"metrics":{"type":"object","additionalProperties":{"type":"object","properties":{"total":{"type":["null","number"]},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["null","number"]}}}},"breakdowns":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}},"unit":{"type":["null","string"]},"currency":{"type":["null","string"]}}}},"unavailable_metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"},"message":{"type":["null","string"]}}}},"data_delay":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/instagram/follower-history":{"get":{"operationId":"getInstagramFollowerHistory","summary":"Get Instagram follower history","tags":["Analytics"],"description":"Daily follower count from Socialit snapshots joined with Instagram's new-follower series (max 89 days).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false,"description":"Comma-separated metric names (network vocabulary)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["total_value","time_series"],"default":"total_value"},"in":"query","name":"metric_type","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-instagram-follower-history","x-feature":"analytics","x-zernio":["GET /v1/analytics/instagram/follower-history"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_insights"]},"account_id":{"type":"string"},"platform":{"type":"string"},"date_range":{"type":"object","properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"metric_type":{"type":"string","enum":["total_value","time_series"]},"breakdown":{"type":["null","string"]},"metrics":{"type":"object","additionalProperties":{"type":"object","properties":{"total":{"type":["null","number"]},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["null","number"]}}}},"breakdowns":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}},"unit":{"type":["null","string"]},"currency":{"type":["null","string"]}}}},"unavailable_metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"},"message":{"type":["null","string"]}}}},"data_delay":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/instagram/demographics":{"get":{"operationId":"getInstagramDemographics","summary":"Get Instagram audience demographics","tags":["Analytics"],"description":"Top 45 entries per dimension; requires at least 100 followers.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","enum":["follower_demographics","engaged_audience_demographics"],"default":"follower_demographics"},"in":"query","name":"metric","required":false},{"schema":{"type":"string"},"in":"query","name":"breakdown","required":false,"description":"age,city,country,gender"},{"schema":{"type":"string","enum":["this_week","this_month"],"default":"this_month"},"in":"query","name":"timeframe","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-instagram-demographics","x-feature":"analytics","x-zernio":["GET /v1/analytics/instagram/demographics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["demographics"]},"account_id":{"type":"string"},"platform":{"type":"string"},"metric":{"type":["null","string"]},"timeframe":{"type":["null","string"]},"video_id":{"type":["null","string"]},"title":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"snapshot_date":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"date_range":{"type":["null","object"],"properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"demographics":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}}},"note":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/instagram/online-followers":{"get":{"operationId":"getInstagramOnlineFollowers","summary":"Get Instagram followers online per hour","tags":["Analytics"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-instagram-online-followers","x-feature":"analytics","x-zernio":["GET /v1/analytics/instagram/online-followers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["online_followers"]},"account_id":{"type":"string"},"platform":{"type":"string"},"metric":{"type":"string"},"days":{"type":"array","items":{"type":"object","properties":{"end_time":{"type":"string"},"hours":{"type":"object","additionalProperties":{"type":"number"}}}}},"note":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/googlebusiness/performance":{"get":{"operationId":"getGoogleBusinessPerformance","summary":"Get Google Business Profile performance metrics","tags":["Analytics"],"description":"Daily impressions, clicks, calls, directions, conversations, bookings and food orders (2-3 day delay, up to 18 months back).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false,"description":"Comma-separated metric names (network vocabulary)"},{"schema":{"type":"string"},"in":"query","name":"from_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-google-business-performance","x-feature":"analytics","x-zernio":["GET /v1/analytics/googlebusiness/performance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_insights"]},"account_id":{"type":"string"},"platform":{"type":"string"},"date_range":{"type":"object","properties":{"since":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"},"until":{"type":["null","string"],"description":"UTC day (YYYY-MM-DD)"}}},"metric_type":{"type":"string","enum":["total_value","time_series"]},"breakdown":{"type":["null","string"]},"metrics":{"type":"object","additionalProperties":{"type":"object","properties":{"total":{"type":["null","number"]},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["null","number"]}}}},"breakdowns":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":["null","number"]}}}},"unit":{"type":["null","string"]},"currency":{"type":["null","string"]}}}},"unavailable_metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"},"message":{"type":["null","string"]}}}},"data_delay":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/googlebusiness/search-keywords":{"get":{"operationId":"getGoogleBusinessSearchKeywords","summary":"Get Google Business Profile search keywords","tags":["Analytics"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"start_month","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"end_month","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-google-business-search-keywords","x-feature":"analytics","x-zernio":["GET /v1/analytics/googlebusiness/search-keywords"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["search_keywords"]},"account_id":{"type":"string"},"platform":{"type":"string"},"month_range":{"type":"object","properties":{"start_month":{"type":"string"},"end_month":{"type":"string"}}},"keywords":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"impressions":{"type":["null","number"]}}}},"note":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/inbox/volume":{"get":{"operationId":"getInboxVolume","summary":"Get inbox messaging volume","tags":["Analytics"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"from_date","required":true,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"},{"schema":{"type":"string","enum":["human","api","workflow","sequence","broadcast","comment_automation","automation","contact","platform"]},"in":"query","name":"source","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-inbox-volume","x-feature":"inbox","x-zernio":["GET /v1/analytics/inbox/volume"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["inbox_volume"]},"from_date":{"type":"string"},"to_date":{"type":"string"},"summary":{"type":"object","properties":{"received":{"type":"integer"},"sent":{"type":"integer"},"read":{"type":"integer"},"failed":{"type":"integer"},"unique_conversations":{"type":"integer"}}},"timeseries":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"received":{"type":"integer"},"sent":{"type":"integer"},"read":{"type":"integer"},"failed":{"type":"integer"}}}},"by_platform":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"received":{"type":"integer"},"sent":{"type":"integer"},"read":{"type":"integer"},"failed":{"type":"integer"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/inbox/heatmap":{"get":{"operationId":"getInboxHeatmap","summary":"Get the inbox day × hour heatmap","tags":["Analytics"],"description":"Sparse buckets; `dow` is ISO (1 = Monday … 7 = Sunday), hours in UTC.","parameters":[{"schema":{"type":"string"},"in":"query","name":"from_date","required":true,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"},{"schema":{"type":"string","enum":["human","api","workflow","sequence","broadcast","comment_automation","automation","contact","platform"]},"in":"query","name":"source","required":false},{"schema":{"type":"string","enum":["message.received","message.sent","message.read","all"]},"in":"query","name":"action","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-inbox-heatmap","x-feature":"inbox","x-zernio":["GET /v1/analytics/inbox/heatmap"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["inbox_heatmap"]},"from_date":{"type":"string"},"to_date":{"type":"string"},"buckets":{"type":"array","items":{"type":"object","properties":{"dow":{"type":"integer"},"hour":{"type":"integer"},"received":{"type":"integer"},"sent":{"type":"integer"},"read":{"type":"integer"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/inbox/source-breakdown":{"get":{"operationId":"getInboxSourceBreakdown","summary":"Get inbox messages by source","tags":["Analytics"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"from_date","required":true,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-inbox-source-breakdown","x-feature":"inbox","x-zernio":["GET /v1/analytics/inbox/source-breakdown"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["inbox_source_breakdown"]},"from_date":{"type":"string"},"to_date":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"received":{"type":"integer"},"sent":{"type":"integer"},"read":{"type":"integer"},"by_platform":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"received":{"type":"integer"},"sent":{"type":"integer"},"read":{"type":"integer"}}}}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/inbox/response-time":{"get":{"operationId":"getInboxResponseTime","summary":"Get inbox response-time stats","tags":["Analytics"],"description":"Time to first response (each inbound streak paired with the next outbound message), summary and histogram.","parameters":[{"schema":{"type":"string"},"in":"query","name":"from_date","required":true,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-inbox-response-time","x-feature":"inbox","x-zernio":["GET /v1/analytics/inbox/response-time"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["inbox_response_time"]},"from_date":{"type":"string"},"to_date":{"type":"string"},"summary":{"type":"object","properties":{"sample_size":{"type":"integer"},"median_seconds":{"type":["null","integer"]},"p90_seconds":{"type":["null","integer"]},"p99_seconds":{"type":["null","integer"]},"mean_seconds":{"type":["null","integer"]},"fastest_seconds":{"type":["null","integer"]},"slowest_seconds":{"type":["null","integer"]}}},"histogram":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"lower_seconds":{"type":"integer"},"upper_seconds":{"type":["null","integer"]},"count":{"type":"integer"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/inbox/top-accounts":{"get":{"operationId":"getInboxTopAccounts","summary":"Get top accounts by inbox volume","tags":["Analytics"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"from_date","required":true,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"},{"schema":{"type":"string","enum":["human","api","workflow","sequence","broadcast","comment_automation","automation","contact","platform"]},"in":"query","name":"source","required":false},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"in":"query","name":"limit","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-inbox-top-accounts","x-feature":"inbox","x-zernio":["GET /v1/analytics/inbox/top-accounts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["inbox_top_accounts"]},"from_date":{"type":"string"},"to_date":{"type":"string"},"accounts":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":"string"},"platform":{"type":"string"},"display_name":{"type":["null","string"]},"username":{"type":["null","string"]},"received":{"type":"integer"},"sent":{"type":"integer"},"total":{"type":"integer"},"conversations":{"type":"integer"},"median_response_seconds":{"type":["null","integer"]},"replied_count":{"type":"integer"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/inbox/conversations":{"get":{"operationId":"listConversationAnalytics","summary":"List conversation analytics","tags":["Analytics"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"from_date","required":true,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"platform","required":false,"description":"Network key (x, instagram, …; aliases twitter, googlebusiness) or \"all\""},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Profile id (pro_…) or \"all\""},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":false,"description":"Account id (sa_…)"},{"schema":{"type":"string","enum":["human","api","workflow","sequence","broadcast","comment_automation","automation","contact","platform"]},"in":"query","name":"source","required":false},{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["last_message_at","first_message_at","total_messages","received","sent","read","failed"],"default":"last_message_at"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"in":"query","name":"order","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"list-conversation-analytics","x-feature":"inbox","x-zernio":["GET /v1/analytics/inbox/conversations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["conversation_analytics"]},"conversation_id":{"type":"string"},"platform_conversation_id":{"type":["null","string"]},"account_id":{"type":"string"},"platform":{"type":"string"},"participant_name":{"type":["null","string"]},"participant_username":{"type":["null","string"]},"participant_picture":{"type":["null","string"]},"last_message":{"type":["null","string"]},"total_messages":{"type":"integer"},"received":{"type":"integer"},"sent":{"type":"integer"},"read":{"type":"integer"},"failed":{"type":"integer"},"first_message_at":{"type":["null","string"],"format":"date-time"},"last_message_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"from_date":{"type":"string"},"to_date":{"type":"string"}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/analytics/inbox/conversations/{conversationId}":{"get":{"operationId":"getConversationAnalytics","summary":"Get analytics of one conversation","tags":["Analytics"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"from_date","required":true,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string"},"in":"query","name":"to_date","required":false,"description":"UTC day (YYYY-MM-DD)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"conversationId","required":true,"description":"Conversation id (conv_…) or the platform conversation id"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"analytics","x-mcp-tool":"get-conversation-analytics","x-feature":"inbox","x-zernio":["GET /v1/analytics/inbox/conversations/{conversationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversation_analytics_detail"]},"conversation_id":{"type":"string"},"platform_conversation_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"from_date":{"type":"string"},"to_date":{"type":"string"},"summary":{"type":"object","properties":{"received":{"type":"integer"},"sent":{"type":"integer"},"read":{"type":"integer"},"failed":{"type":"integer"},"total_messages":{"type":"integer"},"first_message_at":{"type":["null","string"],"format":"date-time"},"last_message_at":{"type":["null","string"],"format":"date-time"}}},"timeseries":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"received":{"type":"integer"},"sent":{"type":"integer"},"read":{"type":"integer"},"failed":{"type":"integer"}}}},"by_source":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"count":{"type":"integer"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/profiles":{"get":{"operationId":"listProfiles","summary":"List profiles","tags":["Accounts"],"description":"Profiles group connected accounts per brand, client or end customer. Filter by `name`, `external_id` or `is_default`.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["name","created_at","updated_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"name","required":false},{"schema":{"type":"string"},"in":"query","name":"external_id","required":false},{"schema":{"type":"boolean"},"in":"query","name":"is_default","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-profiles","x-zernio":["GET /v1/profiles"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["profile"]},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"color":{"type":["null","string"]},"timezone":{"type":["null","string"]},"external_id":{"type":["null","string"]},"is_default":{"type":"boolean"},"account_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","name","is_default"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createProfile","summary":"Create a profile","tags":["Accounts"],"description":"The first profile of a workspace is the default. `external_id` is your tenant id (unique per workspace).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":["string","null"],"maxLength":500},"color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$","description":"Hex color #RRGGBB"},"timezone":{"type":["string","null"],"maxLength":64},"external_id":{"type":["string","null"],"minLength":1,"maxLength":255},"is_default":{"type":"boolean"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"create-profile","x-idempotent":true,"x-zernio":["POST /v1/profiles"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["profile"]},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"color":{"type":["null","string"]},"timezone":{"type":["null","string"]},"external_id":{"type":["null","string"]},"is_default":{"type":"boolean"},"account_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","name","is_default"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/profiles/{id}":{"get":{"operationId":"getProfile","summary":"Get a profile","tags":["Accounts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pro_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"profile id (pro_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"get-profile","x-zernio":["GET /v1/profiles/{profileId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["profile"]},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"color":{"type":["null","string"]},"timezone":{"type":["null","string"]},"external_id":{"type":["null","string"]},"is_default":{"type":"boolean"},"account_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","name","is_default"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateProfile","summary":"Update a profile","tags":["Accounts"],"description":"Set `is_default: true` to make this the workspace default profile.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":["string","null"],"maxLength":500},"color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$","description":"Hex color #RRGGBB"},"timezone":{"type":["string","null"],"maxLength":64},"external_id":{"type":["string","null"],"minLength":1,"maxLength":255},"is_default":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pro_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"profile id (pro_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"accounts","x-mcp-tool":"update-profile","x-zernio":["PUT /v1/profiles/{profileId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["profile"]},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"color":{"type":["null","string"]},"timezone":{"type":["null","string"]},"external_id":{"type":["null","string"]},"is_default":{"type":"boolean"},"account_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","name","is_default"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteProfile","summary":"Delete a profile","tags":["Accounts"],"description":"Refused with 409 `profile_has_accounts` while accounts are assigned, unless `force=true` (the accounts stay connected, unassigned).","parameters":[{"schema":{"type":"boolean","default":false},"in":"query","name":"force","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pro_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"profile id (pro_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"destructive","x-toolset":"accounts","x-mcp-tool":"delete-profile","x-zernio":["DELETE /v1/profiles/{profileId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["profile"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/account-groups":{"get":{"operationId":"listAccountGroups","summary":"List account groups","tags":["Accounts"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["name","created_at","updated_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"name","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-account-groups","x-zernio":["GET /v1/account-groups"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account_group"]},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"color":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"account_ids":{"type":"array","items":{"type":"string"}},"account_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","name","account_ids"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAccountGroup","summary":"Create an account group","tags":["Accounts"],"description":"A named collection of accounts for cross-posting and organization, optionally owned by a profile.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"account_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"maxItems":500},"profile_id":{"type":["string","null"],"maxLength":80},"description":{"type":["string","null"],"maxLength":500},"color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$","description":"Hex color #RRGGBB"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"create-account-group","x-idempotent":true,"x-zernio":["POST /v1/account-groups"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_group"]},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"color":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"account_ids":{"type":"array","items":{"type":"string"}},"account_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","name","account_ids"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/account-groups/{id}":{"get":{"operationId":"getAccountGroup","summary":"Get an account group","tags":["Accounts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"group id (grp_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"get-account-group","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_group"]},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"color":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"account_ids":{"type":"array","items":{"type":"string"}},"account_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","name","account_ids"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAccountGroup","summary":"Update an account group","tags":["Accounts"],"description":"`account_ids` replaces the membership.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"account_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"maxItems":500},"profile_id":{"type":["string","null"],"maxLength":80},"description":{"type":["string","null"],"maxLength":500},"color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$","description":"Hex color #RRGGBB"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"group id (grp_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"accounts","x-mcp-tool":"update-account-group","x-zernio":["PUT /v1/account-groups/{groupId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_group"]},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"color":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"account_ids":{"type":"array","items":{"type":"string"}},"account_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","name","account_ids"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAccountGroup","summary":"Delete an account group","tags":["Accounts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"group id (grp_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"accounts","x-mcp-tool":"delete-account-group","x-zernio":["DELETE /v1/account-groups/{groupId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_group"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/account-groups/{id}/accounts":{"post":{"operationId":"addAccountGroupAccounts","summary":"Add accounts to an account group","tags":["Accounts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["account_ids"],"properties":{"account_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"maxItems":500,"minItems":1}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"group id (grp_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"accounts","x-mcp-tool":"add-account-group-accounts","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_group"]},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"color":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"account_ids":{"type":"array","items":{"type":"string"}},"account_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","name","account_ids"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/account-groups/{id}/accounts/{accountId}":{"delete":{"operationId":"removeAccountGroupAccount","summary":"Remove an account from an account group","tags":["Accounts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"group id (grp_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"socialAccount id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"accounts","x-mcp-tool":"remove-account-group-account","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_group"]},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"color":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"account_ids":{"type":"array","items":{"type":"string"}},"account_count":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","name","account_ids"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts":{"get":{"operationId":"listAccounts","summary":"List connected accounts","tags":["Accounts"],"description":"Filter with `platform`, `profile_id` (or `none`), `group_id`, `status`, `account_type`, `search`, or `<field>.<condition>=` filters.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","updated_at","platform","username","display_name","status"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"platform","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"pro_… or `none` for unassigned accounts"},{"schema":{"type":"string"},"in":"query","name":"group_id","required":false},{"schema":{"type":"string","enum":["active","needs_reconnect"]},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["profile","page","organization","channel"]},"in":"query","name":"account_type","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"search","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-accounts","x-zernio":["GET /v1/accounts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/health":{"get":{"operationId":"getAccountsHealth","summary":"Health of every account","tags":["Accounts"],"description":"Summary plus per-account health. `live=true` probes every token at the network (slower).","parameters":[{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false},{"schema":{"type":"string","enum":["healthy","warning","error"]},"in":"query","name":"status","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"live","required":false},{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"get-accounts-health","x-zernio":["GET /v1/accounts/health"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account_health"]},"account_id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"status":{"type":"string","enum":["healthy","warning","error"]},"can_post":{"type":"boolean"},"can_fetch_analytics":{"type":"boolean"},"token_valid":{"type":["null","boolean"]},"token_expires_at":{"type":["null","string"],"format":"date-time"},"needs_reconnect":{"type":"boolean"},"token":{"type":"object","properties":{"valid":{"type":["null","boolean"]},"strategy":{"type":"string"},"expires_at":{"type":["null","string"],"format":"date-time"},"needs_refresh":{"type":"boolean"},"detail":{"type":["null","string"]}}},"permissions":{"type":"object","properties":{"posting":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string"},"granted":{"type":"boolean"},"required":{"type":"boolean"}}}},"analytics":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string"},"granted":{"type":"boolean"},"required":{"type":"boolean"}}}},"optional":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string"},"granted":{"type":"boolean"},"required":{"type":"boolean"}}}},"missing_required":{"type":"array","items":{"type":"string"}}}},"issues":{"type":"array","items":{"type":"string"}},"recommendations":{"type":"array","items":{"type":"string"}},"live":{"type":"boolean"},"checked_at":{"type":"string","format":"date-time"}},"required":["object","account_id","status"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"summary":{"type":"object","properties":{"total":{"type":"integer"},"healthy":{"type":"integer"},"warning":{"type":"integer"},"error":{"type":"integer"},"needs_reconnect":{"type":"integer"}}}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/follower-stats":{"get":{"operationId":"getFollowerStats","summary":"Follower counts and growth","tags":["Accounts"],"description":"Daily follower snapshots per account (filled by the analytics sync), bucketed daily, weekly or monthly.","parameters":[{"schema":{"type":"string"},"in":"query","name":"account_ids","required":false,"description":"Comma separated sa_… ids"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string","enum":["daily","weekly","monthly"],"default":"daily"},"in":"query","name":"granularity","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"get-follower-stats","x-zernio":["GET /v1/accounts/follower-stats"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["follower_stats"]},"date_range":{"type":"object","properties":{"from_date":{"type":"string"},"to_date":{"type":"string"}}},"granularity":{"type":"string","enum":["daily","weekly","monthly"]},"accounts":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"current_followers":{"type":["null","integer"]},"growth":{"type":"integer"},"growth_percentage":{"type":"number"},"last_updated":{"type":["null","string"],"format":"date-time"},"stats":{"type":"object","properties":{"following":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]}}},"data_points":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"followers":{"type":["null","integer"]}}}}}}}},"required":["object","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{id}":{"get":{"operationId":"getAccount","summary":"Get an account","tags":["Accounts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"socialAccount id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"get-account","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAccount","summary":"Update an account or move it to another profile","tags":["Accounts"],"description":"Local label (`name`), `display_name`, `username`, `default_config` (per-network publish defaults) and `profile_id` (move).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":["string","null"],"maxLength":100},"display_name":{"type":["string","null"],"maxLength":200},"username":{"type":["string","null"],"maxLength":200},"profile_id":{"type":["string","null"],"maxLength":80},"default_config":{"type":["object","null"],"additionalProperties":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"socialAccount id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"accounts","x-mcp-tool":"update-account","x-zernio":["PUT /v1/accounts/{accountId}","PATCH /v1/accounts/{accountId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"disconnectAccount","summary":"Disconnect an account","tags":["Accounts"],"description":"Revokes the token at the network where supported (and no other account shares the grant), then deletes the account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"socialAccount id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"accounts","x-mcp-tool":"disconnect-account","x-zernio":["DELETE /v1/accounts/{accountId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"token_revoked":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{id}/health":{"get":{"operationId":"getAccountHealth","summary":"Check the health of an account","tags":["Accounts"],"description":"Live token probe plus granted-vs-required permissions. A dead token marks the account needs_reconnect.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"socialAccount id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"external","x-toolset":"accounts","x-mcp-tool":"get-account-health","x-zernio":["GET /v1/accounts/{accountId}/health"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["account_health"]},"account_id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"status":{"type":"string","enum":["healthy","warning","error"]},"can_post":{"type":"boolean"},"can_fetch_analytics":{"type":"boolean"},"token_valid":{"type":["null","boolean"]},"token_expires_at":{"type":["null","string"],"format":"date-time"},"needs_reconnect":{"type":"boolean"},"token":{"type":"object","properties":{"valid":{"type":["null","boolean"]},"strategy":{"type":"string"},"expires_at":{"type":["null","string"],"format":"date-time"},"needs_refresh":{"type":"boolean"},"detail":{"type":["null","string"]}}},"permissions":{"type":"object","properties":{"posting":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string"},"granted":{"type":"boolean"},"required":{"type":"boolean"}}}},"analytics":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string"},"granted":{"type":"boolean"},"required":{"type":"boolean"}}}},"optional":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string"},"granted":{"type":"boolean"},"required":{"type":"boolean"}}}},"missing_required":{"type":"array","items":{"type":"string"}}}},"issues":{"type":"array","items":{"type":"string"}},"recommendations":{"type":"array","items":{"type":"string"}},"live":{"type":"boolean"},"checked_at":{"type":"string","format":"date-time"}},"required":["object","account_id","status"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{id}/posts":{"get":{"operationId":"listAccountPlatformPosts","summary":"List posts published on the network","tags":["Accounts"],"description":"Recent posts read live from the network, including posts not published through Socialit.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"socialAccount id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"external","x-toolset":"accounts","x-mcp-tool":"list-account-platform-posts","x-zernio":["GET /v1/accounts/{accountId}/posts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["platform_post"]},"id":{"type":"string"},"platform":{"type":"string"},"content":{"type":["null","string"]},"url":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"media_type":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"metrics":{"type":["null","object"],"properties":{"likes":{"type":["null","integer"]},"comments":{"type":["null","integer"]},"shares":{"type":["null","integer"]},"views":{"type":["null","integer"]}}}},"required":["object","id"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"last_updated":{"type":"string","format":"date-time"}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/platforms":{"get":{"operationId":"listConnectPlatforms","summary":"List connectable networks","tags":["Accounts"],"description":"Every connect flow with its connect methods, required inputs and picker step. `enabled=true` keeps the ones configured on this server.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"boolean"},"in":"query","name":"enabled","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-connect-platforms","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["connect_platform"]},"id":{"type":"string"},"platform":{"type":"string"},"name":{"type":"string"},"enabled":{"type":"boolean"},"connect_type":{"type":"string"},"connect_types":{"type":"array","items":{"type":"string"}},"requires":{"type":"array","items":{"type":"string"}},"selection":{"type":["null","string"]},"scope_sets":{"type":"array","items":{"type":"string"}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/{platform}":{"get":{"operationId":"getConnectUrl","summary":"Start connecting an account (authorization URL)","tags":["Accounts"],"description":"Returns the network authorization URL. After sign-in the network redirects to Socialit, which connects the account (or shows a picker) and sends the browser to `redirect_url`. `headless=true` hands multi-target selections to your own picker.","parameters":[{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":["string","null"],"maxLength":2000},"in":"query","name":"redirect_url","required":false,"description":"Absolute http(s) URL or app scheme"},{"schema":{"type":"boolean","default":false},"in":"query","name":"headless","required":false},{"schema":{"type":"string","enum":["core","focus","revenue","members","content_owner"]},"in":"query","name":"scope_set","required":false},{"schema":{"type":"string"},"in":"query","name":"reconnect_account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false,"description":"Alias of reconnect_account_id"},{"schema":{"type":"string","enum":["instagram_login","facebook_login"]},"in":"query","name":"login_method","required":false},{"schema":{"type":"string","maxLength":255},"in":"query","name":"instance","required":false},{"schema":{"type":"string","maxLength":255},"in":"query","name":"identifier","required":false},{"schema":{"type":"string","maxLength":20},"in":"query","name":"locale","required":false},{"schema":{"type":"boolean"},"in":"query","name":"force_reauth","required":false},{"schema":{"type":"string","maxLength":100},"in":"query","name":"content_owner_id","required":false,"description":"YouTube CMS content owner"},{"schema":{"type":"string","enum":["bot","webhook"]},"in":"query","name":"discord_mode","required":false},{"schema":{"type":"string","maxLength":40},"in":"query","name":"guild_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"path","name":"platform","required":true,"description":"Network or connect flow (x, facebook, linkedin_org, googlebusiness…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"accounts","x-mcp-tool":"get-connect-url","x-zernio":["GET /v1/connect/{platform}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_url"]},"platform":{"type":"string"},"flow":{"type":"string"},"url":{"type":"string"},"auth_url":{"type":"string"},"state":{"type":"string"},"expires_at":{"type":"string","format":"date-time"}},"required":["object","url","state"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"completeConnect","summary":"Complete a connect flow with code and state","tags":["Accounts"],"description":"Headless completion: exchange the authorization `code` for the `state` returned by GET /connect/{platform}.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","state"],"properties":{"code":{"type":"string","minLength":1,"maxLength":4096},"state":{"type":"string","minLength":1,"maxLength":128},"iss":{"type":"string","maxLength":500},"profile_id":{"type":"string"},"guild_id":{"type":"string","maxLength":40},"permissions":{"type":"string","maxLength":40}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"path","name":"platform","required":true,"description":"Network or connect flow (x, facebook, linkedin_org, googlebusiness…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"complete-connect","x-idempotent":true,"x-zernio":["POST /v1/connect/{platform}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/{platform}/credentials":{"post":{"operationId":"connectWithCredentials","summary":"Connect an account with credentials","tags":["Accounts"],"description":"Bluesky (identifier + app_password), Mastodon (instance + access_token), Discord (webhook_url).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"profile_id":{"type":"string"},"redirect_url":{"type":["string","null"],"maxLength":2000,"description":"Absolute http(s) URL or app scheme"},"identifier":{"type":"string","maxLength":255},"password":{"type":"string","maxLength":500},"app_password":{"type":"string","maxLength":500},"auth_factor_token":{"type":"string","maxLength":100},"service":{"type":"string","maxLength":255},"instance":{"type":"string","maxLength":255},"access_token":{"type":"string","maxLength":4096},"webhook_url":{"type":"string","maxLength":500}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"path","name":"platform","required":true,"description":"Network or connect flow (x, facebook, linkedin_org, googlebusiness…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"connect-with-credentials","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/pending-data":{"get":{"operationId":"getPendingConnection","summary":"Get a pending connection","tags":["Accounts"],"description":"Targets waiting to be picked after a multi-target sign-in (token from the headless redirect or a picker step).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"token","required":false,"description":"Pending connection token (cpt_…)"},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"pending_token","required":false,"description":"Pending connection token (cpt_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"get-pending-connection","x-zernio":["GET /v1/connect/pending-data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["null","string"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"already_connected":{"type":"boolean"},"account_id":{"type":["null","string"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/select":{"post":{"operationId":"selectPendingConnection","summary":"Connect the selected targets of a pending connection","tags":["Accounts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["token"],"properties":{"token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"target_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500,"minItems":1},"board_id":{"type":"string","maxLength":100},"board_name":{"type":"string","maxLength":200}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"select-pending-connection","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/facebook/select-page":{"get":{"operationId":"listFacebookPageConnectTargets","summary":"List FacebookPage targets of a pending connection","tags":["Accounts"],"description":"Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as `token` or the `X-Connect-Token` header.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"token","required":false,"description":"Pending connection token (cpt_…)"},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"pending_token","required":false,"description":"Pending connection token (cpt_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-facebook-page-connect-targets","x-zernio":["GET /v1/connect/facebook/select-page"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["null","string"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"already_connected":{"type":"boolean"},"account_id":{"type":["null","string"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"selectFacebookPageConnectTargets","summary":"Connect the selected FacebookPage targets","tags":["Accounts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"pending_token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"profile_id":{"type":"string"},"redirect_url":{"type":["string","null"],"maxLength":2000,"description":"Absolute http(s) URL or app scheme"},"target_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"page_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"page_id":{"type":"string","maxLength":100}},"required":[]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"select-facebook-page-connect-targets","x-idempotent":true,"x-zernio":["POST /v1/connect/facebook/select-page"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/instagram/select-account":{"get":{"operationId":"listInstagramAccountConnectTargets","summary":"List InstagramAccount targets of a pending connection","tags":["Accounts"],"description":"Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as `token` or the `X-Connect-Token` header.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"token","required":false,"description":"Pending connection token (cpt_…)"},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"pending_token","required":false,"description":"Pending connection token (cpt_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-instagram-account-connect-targets","x-zernio":["GET /v1/connect/instagram/select-account"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["null","string"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"already_connected":{"type":"boolean"},"account_id":{"type":["null","string"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"selectInstagramAccountConnectTargets","summary":"Connect the selected InstagramAccount targets","tags":["Accounts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"pending_token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"profile_id":{"type":"string"},"redirect_url":{"type":["string","null"],"maxLength":2000,"description":"Absolute http(s) URL or app scheme"},"target_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"account_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"page_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"page_id":{"type":"string","maxLength":100}},"required":[]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"select-instagram-account-connect-targets","x-idempotent":true,"x-zernio":["POST /v1/connect/instagram/select-account"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/linkedin/organizations":{"get":{"operationId":"listLinkedinOrganizationConnectTargets","summary":"List LinkedinOrganization targets of a pending connection","tags":["Accounts"],"description":"Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as `token` or the `X-Connect-Token` header.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"token","required":false,"description":"Pending connection token (cpt_…)"},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"pending_token","required":false,"description":"Pending connection token (cpt_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-linkedin-organization-connect-targets","x-zernio":["GET /v1/connect/linkedin/organizations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["null","string"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"already_connected":{"type":"boolean"},"account_id":{"type":["null","string"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/linkedin/select-organization":{"post":{"operationId":"selectLinkedinOrganizationConnectTargets","summary":"Connect the selected LinkedinOrganization targets","tags":["Accounts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"pending_token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"profile_id":{"type":"string"},"redirect_url":{"type":["string","null"],"maxLength":2000,"description":"Absolute http(s) URL or app scheme"},"target_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"organization_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"include_personal":{"type":"boolean"},"selections":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"properties":{"account_type":{"type":"string","enum":["personal","organization"]},"organization_id":{"type":"string","maxLength":200}}}}},"required":[]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"select-linkedin-organization-connect-targets","x-idempotent":true,"x-zernio":["POST /v1/connect/linkedin/select-organization"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/pinterest/select-board":{"get":{"operationId":"listPinterestBoardConnectTargets","summary":"List PinterestBoard targets of a pending connection","tags":["Accounts"],"description":"Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as `token` or the `X-Connect-Token` header.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"token","required":false,"description":"Pending connection token (cpt_…)"},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"pending_token","required":false,"description":"Pending connection token (cpt_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-pinterest-board-connect-targets","x-zernio":["GET /v1/connect/pinterest/select-board"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["null","string"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"already_connected":{"type":"boolean"},"account_id":{"type":["null","string"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"selectPinterestBoardConnectTargets","summary":"Connect the selected PinterestBoard targets","tags":["Accounts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"pending_token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"profile_id":{"type":"string"},"redirect_url":{"type":["string","null"],"maxLength":2000,"description":"Absolute http(s) URL or app scheme"},"target_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"board_id":{"type":"string","maxLength":100},"board_name":{"type":"string","maxLength":200}},"required":["board_id"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"select-pinterest-board-connect-targets","x-idempotent":true,"x-zernio":["POST /v1/connect/pinterest/select-board"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/googlebusiness/locations":{"get":{"operationId":"listGoogleBusinessLocationConnectTargets","summary":"List GoogleBusinessLocation targets of a pending connection","tags":["Accounts"],"description":"Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as `token` or the `X-Connect-Token` header.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"token","required":false,"description":"Pending connection token (cpt_…)"},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"pending_token","required":false,"description":"Pending connection token (cpt_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-google-business-location-connect-targets","x-zernio":["GET /v1/connect/googlebusiness/locations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["null","string"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"already_connected":{"type":"boolean"},"account_id":{"type":["null","string"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/googlebusiness/select-location":{"post":{"operationId":"selectGoogleBusinessLocationConnectTargets","summary":"Connect the selected GoogleBusinessLocation targets","tags":["Accounts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"pending_token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"profile_id":{"type":"string"},"redirect_url":{"type":["string","null"],"maxLength":2000,"description":"Absolute http(s) URL or app scheme"},"target_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"location_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"location_id":{"type":"string","maxLength":200}},"required":[]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"select-google-business-location-connect-targets","x-idempotent":true,"x-zernio":["POST /v1/connect/googlebusiness/select-location"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/snapchat/select-profile":{"get":{"operationId":"listSnapchatProfileConnectTargets","summary":"List SnapchatProfile targets of a pending connection","tags":["Accounts"],"description":"Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as `token` or the `X-Connect-Token` header.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"token","required":false,"description":"Pending connection token (cpt_…)"},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"pending_token","required":false,"description":"Pending connection token (cpt_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-snapchat-profile-connect-targets","x-zernio":["GET /v1/connect/snapchat/select-profile"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["null","string"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"already_connected":{"type":"boolean"},"account_id":{"type":["null","string"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"selectSnapchatProfileConnectTargets","summary":"Connect the selected SnapchatProfile targets","tags":["Accounts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"pending_token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"profile_id":{"type":"string"},"redirect_url":{"type":["string","null"],"maxLength":2000,"description":"Absolute http(s) URL or app scheme"},"target_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500},"public_profile_id":{"type":"string","maxLength":100}},"required":[]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"select-snapchat-profile-connect-targets","x-idempotent":true,"x-zernio":["POST /v1/connect/snapchat/select-profile"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/bluesky/credentials":{"post":{"operationId":"connectBlueskyCredentials","summary":"Connect Bluesky with an app password","tags":["Accounts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["identifier"],"properties":{"identifier":{"type":"string","minLength":1,"maxLength":255},"app_password":{"type":"string","minLength":1,"maxLength":500},"password":{"type":"string","minLength":1,"maxLength":500},"auth_factor_token":{"type":"string","maxLength":100},"profile_id":{"type":"string"},"redirect_url":{"type":["string","null"],"maxLength":2000,"description":"Absolute http(s) URL or app scheme"},"state":{"type":"string","maxLength":200,"description":"Ignored (Zernio compatibility)"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"connect-bluesky-credentials","x-idempotent":true,"x-zernio":["POST /v1/connect/bluesky/credentials"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/discord":{"post":{"operationId":"connectDiscordChannels","summary":"Connect Discord channels","tags":["Accounts"],"description":"Bind channels of a guild where the Socialit bot is installed (or of a pending Discord install `token`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"guild_id":{"type":"string","maxLength":40},"channel_id":{"type":"string","maxLength":40},"channel_ids":{"type":"array","items":{"type":"string","maxLength":40},"maxItems":25},"profile_id":{"type":"string"},"token":{"type":"string","minLength":1,"maxLength":128,"description":"Pending connection token (cpt_…)"},"redirect_url":{"type":["string","null"],"maxLength":2000,"description":"Absolute http(s) URL or app scheme"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"connect-discord-channels","x-idempotent":true,"x-zernio":["POST /v1/connect/discord"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_result"]},"status":{"type":"string","enum":["connected","pending_selection"]},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string","enum":["profile","page","organization","channel"]},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"publishing_paused":{"type":"boolean","description":"Beyond the plan account allowance: publishing is paused"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","platform","status"]}},"failed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}},"pending":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["connect_pending"]},"token":{"type":"string"},"platform":{"type":"string"},"flow":{"type":"string"},"profile_id":{"type":["string","null"]},"step":{"type":"string"},"multiple":{"type":"boolean"},"user_profile":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]}}},"targets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"account_type":{"type":"string"},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"already_connected":{"type":"boolean"},"account_id":{"type":["string","null"]},"details":{"type":"object","additionalProperties":true}}}},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"privacy":{"type":["string","null"]}}}},"expires_at":{"type":"string","format":"date-time"}},"required":["object","token","step","targets"]},{"type":"null"}]},"redirect_url":{"type":["null","string"]}},"required":["object","status","accounts"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/links":{"get":{"operationId":"listConnectLinks","summary":"List hosted connect links","tags":["Accounts"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","expires_at","name"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string","enum":["active","expired","revoked","exhausted"]},"in":"query","name":"status","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"list-connect-links","x-feature":"hostedConnect","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["connect_link"]},"id":{"type":"string"},"name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"url":{"type":"string"},"platforms":{"type":["null","array"],"items":{"type":"string"}},"branding":{"type":"object","properties":{"name":{"type":["null","string"]},"logo_url":{"type":["null","string"]},"primary_color":{"type":["null","string"]},"accent_color":{"type":["null","string"]},"background_color":{"type":["null","string"]}}},"redirect_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","expired","revoked","exhausted"]},"max_uses":{"type":["null","integer"]},"use_count":{"type":"integer"},"last_used_at":{"type":["null","string"],"format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"revoked_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","url","status"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createConnectLink","summary":"Create a hosted connect link","tags":["Accounts"],"description":"A branded page where your customer connects their accounts to one profile, then lands on `redirect_url` with `account_ids`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["profile_id"],"properties":{"profile_id":{"type":"string"},"name":{"type":["string","null"],"maxLength":100},"platforms":{"type":["array","null"],"items":{"type":"string","maxLength":40},"maxItems":40},"branding":{"type":"object","additionalProperties":false,"properties":{"name":{"type":["string","null"],"maxLength":60},"logo_url":{"type":["string","null"],"maxLength":1000},"primary_color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$","description":"Hex color #RRGGBB"},"accent_color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$","description":"Hex color #RRGGBB"},"background_color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$","description":"Hex color #RRGGBB"}}},"redirect_url":{"type":["string","null"],"maxLength":2000,"description":"Absolute http(s) URL or app scheme"},"expires_in":{"type":"integer","minimum":300,"maximum":2592000},"expires_at":{"type":"string","format":"date-time"},"max_uses":{"type":["integer","null"],"minimum":1,"maximum":10000}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"accounts","x-mcp-tool":"create-connect-link","x-idempotent":true,"x-feature":"hostedConnect","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_link"]},"id":{"type":"string"},"name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"url":{"type":"string"},"platforms":{"type":["null","array"],"items":{"type":"string"}},"branding":{"type":"object","properties":{"name":{"type":["null","string"]},"logo_url":{"type":["null","string"]},"primary_color":{"type":["null","string"]},"accent_color":{"type":["null","string"]},"background_color":{"type":["null","string"]}}},"redirect_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","expired","revoked","exhausted"]},"max_uses":{"type":["null","integer"]},"use_count":{"type":"integer"},"last_used_at":{"type":["null","string"],"format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"revoked_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","url","status"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/links/{id}":{"get":{"operationId":"getConnectLink","summary":"Get a hosted connect link","tags":["Accounts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"cl_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"connectLink id (cl_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"accounts","x-mcp-tool":"get-connect-link","x-feature":"hostedConnect","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_link"]},"id":{"type":"string"},"name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"url":{"type":"string"},"platforms":{"type":["null","array"],"items":{"type":"string"}},"branding":{"type":"object","properties":{"name":{"type":["null","string"]},"logo_url":{"type":["null","string"]},"primary_color":{"type":["null","string"]},"accent_color":{"type":["null","string"]},"background_color":{"type":["null","string"]}}},"redirect_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","expired","revoked","exhausted"]},"max_uses":{"type":["null","integer"]},"use_count":{"type":"integer"},"last_used_at":{"type":["null","string"],"format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"revoked_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["object","id","url","status"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"revokeConnectLink","summary":"Revoke a hosted connect link","tags":["Accounts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"cl_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"connectLink id (cl_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"accounts","x-mcp-tool":"revoke-connect-link","x-feature":"hostedConnect","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["connect_link"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-reviews":{"get":{"operationId":"listGmbReviews","summary":"List Google Business reviews","tags":["Platform tools"],"description":"Reviews of the location with average rating and total count (cursor paging, ≤50 per page). Optional `location_id` targets another location of the same Google login.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":2048},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["update_time desc","updateTime desc","rating","rating desc"]},"in":"query","name":"order_by","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-gmb-reviews","x-zernio":["GET /v1/accounts/{accountId}/gmb-reviews"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"average_rating":{"type":["null","number"]},"total_review_count":{"type":["null","integer"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_review"]},"id":{"type":"string"},"name":{"type":["null","string"]},"location_id":{"type":["null","string"]},"rating":{"type":["null","integer"]},"text":{"type":["null","string"]},"text_translated":{"type":["null","string"]},"text_original":{"type":["null","string"]},"author":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"]},"author_is_anonymous":{"type":"boolean"},"created_at":{"type":["null","string"]},"updated_at":{"type":["null","string"]},"has_reply":{"type":"boolean"},"reply":{"type":["null","string"]},"reply_updated_at":{"type":["null","string"]},"reply_state":{"type":["null","string"]},"reply_policy_violation":{"type":["null","object","string"],"additionalProperties":true},"reply_url":{"type":["null","string"]},"has_photos":{"type":"boolean"},"photo_count":{"type":"integer"},"media":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]}}}}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-reviews/batch":{"post":{"operationId":"batchGetGmbReviews","summary":"Batch get Google Business reviews","tags":["Platform tools"],"description":"Reviews across up to 50 locations of the same Google account in one call.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"location_ids":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","minLength":1,"maxLength":300}},"google_account_id":{"type":"string","maxLength":300},"limit":{"type":"integer","minimum":1,"maximum":50},"cursor":{"type":"string","maxLength":2048},"order_by":{"type":"string","enum":["update_time desc","updateTime desc","rating","rating desc"]},"ignore_rating_only_reviews":{"type":"boolean"}},"required":["location_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"batch-get-gmb-reviews","x-zernio":["POST /v1/accounts/{accountId}/gmb-reviews/batch"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"google_account_id":{"type":["null","string"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_location_review"]},"location_id":{"type":["null","string"]},"review":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_review"]},"id":{"type":"string"},"name":{"type":["null","string"]},"location_id":{"type":["null","string"]},"rating":{"type":["null","integer"]},"text":{"type":["null","string"]},"text_translated":{"type":["null","string"]},"text_original":{"type":["null","string"]},"author":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"]},"author_is_anonymous":{"type":"boolean"},"created_at":{"type":["null","string"]},"updated_at":{"type":["null","string"]},"has_reply":{"type":"boolean"},"reply":{"type":["null","string"]},"reply_updated_at":{"type":["null","string"]},"reply_state":{"type":["null","string"]},"reply_policy_violation":{"type":["null","object","string"],"additionalProperties":true},"reply_url":{"type":["null","string"]},"has_photos":{"type":"boolean"},"photo_count":{"type":"integer"},"media":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]}}}}}}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-reviews/{reviewId}":{"get":{"operationId":"getGmbReview","summary":"Get a Google Business review","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"reviewId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-gmb-review","x-zernio":["GET /v1/accounts/{accountId}/gmb-reviews/{reviewId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_review"]},"id":{"type":"string"},"name":{"type":["null","string"]},"location_id":{"type":["null","string"]},"rating":{"type":["null","integer"]},"text":{"type":["null","string"]},"text_translated":{"type":["null","string"]},"text_original":{"type":["null","string"]},"author":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"]},"author_is_anonymous":{"type":"boolean"},"created_at":{"type":["null","string"]},"updated_at":{"type":["null","string"]},"has_reply":{"type":"boolean"},"reply":{"type":["null","string"]},"reply_updated_at":{"type":["null","string"]},"reply_state":{"type":["null","string"]},"reply_policy_violation":{"type":["null","object","string"],"additionalProperties":true},"reply_url":{"type":["null","string"]},"has_photos":{"type":"boolean"},"photo_count":{"type":"integer"},"media":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply":{"post":{"operationId":"replyToGmbReview","summary":"Reply to a Google Business review","tags":["Platform tools"],"description":"Creates or overwrites the owner reply (≤4096 bytes). Set `automated: true` for replies sent without a human pressing send (AI agents, workflows); they need the location opt-in (PATCH …/gmb-automation) and are audited. Emits `review.replied`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"comment":{"type":"string","minLength":1,"maxLength":4096},"automated":{"type":"boolean","default":false,"description":"true when no human pressed send (AI agents, workflows, auto-responders); needs the location opt-in"},"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"}},"required":["comment"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"reviewId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"platform_tools","x-mcp-tool":"reply-to-gmb-review","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_review_reply"]},"review_id":{"type":"string"},"name":{"type":["null","string"]},"comment":{"type":["null","string"]},"updated_at":{"type":["null","string"]},"reply_state":{"type":["null","string"]},"automated":{"type":"boolean"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteGmbReviewReply","summary":"Delete a Google Business review reply","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"reviewId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"platform_tools","x-mcp-tool":"delete-gmb-review-reply","x-zernio":["DELETE /v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_review_reply"]},"review_id":{"type":"string"},"name":{"type":["null","string"]},"comment":{"type":["null","string"]},"updated_at":{"type":["null","string"]},"reply_state":{"type":["null","string"]},"automated":{"type":"boolean"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-automation":{"get":{"operationId":"getGmbAutomation","summary":"Get the Google Business automation opt-in","tags":["Platform tools"],"description":"Whether the business opted in to automated review replies / listing edits for the location (Google policy).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-gmb-automation","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_automation"]},"id":{"type":["null","string"]},"account_id":{"type":"string"},"location_id":{"type":"string"},"automated_review_replies":{"type":"boolean"},"automated_listing_edits":{"type":"boolean"},"consent_text":{"type":["null","string"]},"opted_in_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"opted_in_at":{"type":["null","string"]},"updated_at":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateGmbAutomation","summary":"Update the Google Business automation opt-in","tags":["Platform tools"],"description":"Record (or revoke) the business’s express opt-in for automated review replies and listing edits on a location. Every change is written to the automation audit log.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"automated_review_replies":{"type":"boolean"},"automated_listing_edits":{"type":"boolean"},"consent_text":{"type":["string","null"],"maxLength":2000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"update-gmb-automation","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_automation"]},"id":{"type":["null","string"]},"account_id":{"type":"string"},"location_id":{"type":"string"},"automated_review_replies":{"type":"boolean"},"automated_listing_edits":{"type":"boolean"},"consent_text":{"type":["null","string"]},"opted_in_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"opted_in_at":{"type":["null","string"]},"updated_at":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-automation/audit-log":{"get":{"operationId":"listGmbAutomationAudit","summary":"List the Google Business automation audit log","tags":["Platform tools"],"description":"Opt-in changes and automated actions (automated review replies) for the account, newest first.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["opt_in_review_replies","opt_out_review_replies","opt_in_listing_edits","opt_out_listing_edits","automated_review_reply"]},"in":"query","name":"action","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-gmb-automation-audit","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_automation_audit"]},"id":{"type":"string"},"account_id":{"type":"string"},"location_id":{"type":"string"},"action":{"type":"string"},"actor":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"details":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-location-details":{"get":{"operationId":"getGmbLocationDetails","summary":"Get Google Business location details","tags":["Platform tools"],"description":"The Business Information Location (title, address, hours, categories, profile, phone, website…) plus status flags. Optional `location_id` targets another location of the same Google login.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","maxLength":2000},"in":"query","name":"read_mask","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-gmb-location-details","x-zernio":["GET /v1/accounts/{accountId}/gmb-location-details"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_location_details"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"flags":{"type":["null","object"],"additionalProperties":true},"location":{"type":"object","additionalProperties":true},"update_mask":{"type":["null","array"],"items":{"type":"string"}},"validate_only":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateGmbLocationDetails","summary":"Update Google Business location details","tags":["Platform tools"],"description":"PATCH native Location fields (snake_case). `update_mask` is inferred from the body keys when omitted; `validate_only` dry-runs. Title / address / category edits may trigger re-verification (see `warnings`). Rate limited to 10 edits/min/location.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"minProperties":1,"description":"Native Business Information Location fields (snake_case) plus update_mask / validate_only / location_id","properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"update_mask":{"anyOf":[{"type":"string","maxLength":2000},{"type":"array","items":{"type":"string"}}]},"validate_only":{"type":"boolean"},"title":{"type":"string"},"regular_hours":{"type":"object","additionalProperties":true},"special_hours":{"type":"object","additionalProperties":true},"more_hours":{"type":"array","items":{"type":"object","additionalProperties":true}},"profile":{"type":"object","additionalProperties":true},"website_uri":{"type":"string"},"phone_numbers":{"type":"object","additionalProperties":true},"categories":{"type":"object","additionalProperties":true},"service_items":{"type":"array","items":{"type":"object","additionalProperties":true}},"store_code":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"storefront_address":{"type":"object","additionalProperties":true},"service_area":{"type":"object","additionalProperties":true},"open_info":{"type":"object","additionalProperties":true},"latlng":{"type":"object","additionalProperties":true},"ad_words_location_extensions":{"type":"object","additionalProperties":true}}}}},"description":"Native Business Information Location fields (snake_case) plus update_mask / validate_only / location_id"},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"update-gmb-location-details","x-zernio":["PUT /v1/accounts/{accountId}/gmb-location-details"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_location_details"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"flags":{"type":["null","object"],"additionalProperties":true},"location":{"type":"object","additionalProperties":true},"update_mask":{"type":["null","array"],"items":{"type":"string"}},"validate_only":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-attributes":{"get":{"operationId":"getGmbAttributes","summary":"Get Google Business attributes","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-gmb-attributes","x-zernio":["GET /v1/accounts/{accountId}/gmb-attributes"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_attributes"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"attributes":{"type":"array","items":{"type":"object","additionalProperties":true}},"attribute_mask":{"type":["null","array"],"items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateGmbAttributes","summary":"Update Google Business attributes","tags":["Platform tools"],"description":"`attribute_mask` defaults to the given attribute names; masked names missing from `attributes` are cleared.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"attributes":{"type":"array","maxItems":500,"items":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","minLength":1},"values":{"type":"array"},"repeated_enum_value":{"type":"object","additionalProperties":true},"uri_values":{"type":"array"}},"required":["name"]}},"attribute_mask":{"anyOf":[{"type":"string","maxLength":5000},{"type":"array","items":{"type":"string"}}]}},"required":["attributes"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"update-gmb-attributes","x-zernio":["PUT /v1/accounts/{accountId}/gmb-attributes"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_attributes"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"attributes":{"type":"array","items":{"type":"object","additionalProperties":true}},"attribute_mask":{"type":["null","array"],"items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-attribute-metadata":{"get":{"operationId":"getGmbAttributeMetadata","summary":"Get Google Business attribute metadata","tags":["Platform tools"],"description":"Attributes available for the location, or for a category (`category_name` + `region_code`).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","maxLength":300},"in":"query","name":"category_name","required":false},{"schema":{"type":"string","maxLength":8},"in":"query","name":"region_code","required":false},{"schema":{"type":"string","maxLength":35},"in":"query","name":"language_code","required":false},{"schema":{"type":"boolean"},"in":"query","name":"show_all","required":false},{"schema":{"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":2048},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-gmb-attribute-metadata","x-zernio":["GET /v1/accounts/{accountId}/gmb-attribute-metadata"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-services":{"get":{"operationId":"getGmbServices","summary":"Get Google Business services","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-gmb-services","x-zernio":["GET /v1/accounts/{accountId}/gmb-services"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_services"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"services":{"type":"array","items":{"type":"object","additionalProperties":true}},"categories":{"type":["null","object"],"additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"replaceGmbServices","summary":"Replace Google Business services","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"service_items":{"type":"array","maxItems":500,"items":{"type":"object","additionalProperties":true}}},"required":["service_items"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"replace-gmb-services","x-zernio":["PUT /v1/accounts/{accountId}/gmb-services"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_services"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"services":{"type":"array","items":{"type":"object","additionalProperties":true}},"categories":{"type":["null","object"],"additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-food-menus":{"get":{"operationId":"getGmbFoodMenus","summary":"Get Google Business food menus","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-gmb-food-menus","x-zernio":["GET /v1/accounts/{accountId}/gmb-food-menus"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_food_menus"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"name":{"type":["null","string"]},"menus":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateGmbFoodMenus","summary":"Update Google Business food menus","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"menus":{"type":"array","items":{"type":"object","additionalProperties":true}},"update_mask":{"type":"string","maxLength":500}},"required":["menus"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"update-gmb-food-menus","x-zernio":["PUT /v1/accounts/{accountId}/gmb-food-menus"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_food_menus"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"name":{"type":["null","string"]},"menus":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-media":{"get":{"operationId":"listGmbMedia","summary":"List Google Business photos and videos","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":2048},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-gmb-media","x-zernio":["GET /v1/accounts/{accountId}/gmb-media"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"total":{"type":["null","integer"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["gmb_media"]},"id":{"type":"string"},"name":{"type":["null","string"]},"media_format":{"type":["null","string"]},"source_url":{"type":["null","string"]},"google_url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"description":{"type":["null","string"]},"create_time":{"type":["null","string"]},"location_association":{"type":["null","object"],"additionalProperties":true},"dimensions":{"type":["null","object"],"additionalProperties":true},"insights":{"type":["null","object"],"additionalProperties":true},"attribution":{"type":["null","object"],"additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"uploadGmbMedia","summary":"Upload a Google Business photo or video","tags":["Platform tools"],"description":"Upload by public URL (photos 10 KB–5 MB, ≥250 px; videos ≤30 s, ≤75 MB).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"source_url":{"type":"string","minLength":8,"maxLength":4096,"pattern":"^https?://"},"media_format":{"type":"string","enum":["PHOTO","VIDEO"]},"category":{"type":"string","enum":["CATEGORY_UNSPECIFIED","COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL"]},"description":{"type":"string","maxLength":1000}},"required":["source_url"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"platform_tools","x-mcp-tool":"upload-gmb-media","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-media"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["gmb_media"]},"id":{"type":"string"},"name":{"type":["null","string"]},"media_format":{"type":["null","string"]},"source_url":{"type":["null","string"]},"google_url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"description":{"type":["null","string"]},"create_time":{"type":["null","string"]},"location_association":{"type":["null","object"],"additionalProperties":true},"dimensions":{"type":["null","object"],"additionalProperties":true},"insights":{"type":["null","object"],"additionalProperties":true},"attribution":{"type":["null","object"],"additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteGmbMedia","summary":"Delete a Google Business photo or video","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"query","name":"media_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"platform_tools","x-mcp-tool":"delete-gmb-media","x-zernio":["DELETE /v1/accounts/{accountId}/gmb-media"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_media"]},"id":{"type":"string"},"name":{"type":["null","string"]},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-place-actions":{"get":{"operationId":"listGmbPlaceActions","summary":"List Google Business action links","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":2048},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","maxLength":500},"in":"query","name":"filter","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-gmb-place-actions","x-zernio":["GET /v1/accounts/{accountId}/gmb-place-actions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["gmb_place_action_link"]},"id":{"type":"string"},"name":{"type":["null","string"]},"uri":{"type":["null","string"]},"place_action_type":{"type":["null","string"]},"is_preferred":{"type":["null","boolean"]},"is_editable":{"type":["null","boolean"]},"provider_type":{"type":["null","string"]},"create_time":{"type":["null","string"]},"update_time":{"type":["null","string"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createGmbPlaceAction","summary":"Create a Google Business action link","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"uri":{"type":"string","minLength":8,"maxLength":4096,"pattern":"^https?://"},"place_action_type":{"type":"string","enum":["APPOINTMENT","ONLINE_APPOINTMENT","DINING_RESERVATION","FOOD_ORDERING","FOOD_DELIVERY","FOOD_TAKEOUT","SHOP_ONLINE","SOLOPRENEUR_APPOINTMENT"]},"is_preferred":{"type":"boolean"}},"required":["uri","place_action_type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"platform_tools","x-mcp-tool":"create-gmb-place-action","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-place-actions"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["gmb_place_action_link"]},"id":{"type":"string"},"name":{"type":["null","string"]},"uri":{"type":["null","string"]},"place_action_type":{"type":["null","string"]},"is_preferred":{"type":["null","boolean"]},"is_editable":{"type":["null","boolean"]},"provider_type":{"type":["null","string"]},"create_time":{"type":["null","string"]},"update_time":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateGmbPlaceAction","summary":"Update a Google Business action link","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"name":{"type":"string","minLength":1,"maxLength":500},"uri":{"type":"string","minLength":8,"maxLength":4096,"pattern":"^https?://"},"place_action_type":{"type":"string","enum":["APPOINTMENT","ONLINE_APPOINTMENT","DINING_RESERVATION","FOOD_ORDERING","FOOD_DELIVERY","FOOD_TAKEOUT","SHOP_ONLINE","SOLOPRENEUR_APPOINTMENT"]},"is_preferred":{"type":"boolean"}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"update-gmb-place-action","x-zernio":["PATCH /v1/accounts/{accountId}/gmb-place-actions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["gmb_place_action_link"]},"id":{"type":"string"},"name":{"type":["null","string"]},"uri":{"type":["null","string"]},"place_action_type":{"type":["null","string"]},"is_preferred":{"type":["null","boolean"]},"is_editable":{"type":["null","boolean"]},"provider_type":{"type":["null","string"]},"create_time":{"type":["null","string"]},"update_time":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteGmbPlaceAction","summary":"Delete a Google Business action link","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"query","name":"name","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"platform_tools","x-mcp-tool":"delete-gmb-place-action","x-zernio":["DELETE /v1/accounts/{accountId}/gmb-place-actions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_place_action_link"]},"id":{"type":"string"},"name":{"type":["null","string"]},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-verifications":{"get":{"operationId":"getGmbVerifications","summary":"Get Google Business verification state","tags":["Platform tools"],"description":"Voice of Merchant state, a summary (`live`, `needs_verification`, …) and the verifications of the location.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"query","name":"location_id","required":false,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-gmb-verifications","x-zernio":["GET /v1/accounts/{accountId}/gmb-verifications"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_verification_state"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"summary":{"type":"object","properties":{"status":{"type":"string"},"can_edit":{"type":"boolean"},"message":{"type":["null","string"]}}},"voice_of_merchant_state":{"type":"object","additionalProperties":true},"verifications":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"startGmbVerification","summary":"Start a Google Business verification","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"method":{"type":"string","enum":["ADDRESS","EMAIL","PHONE_CALL","SMS","AUTO","TRUSTED_PARTNER","VETTED_PARTNER"]},"language_code":{"type":"string","maxLength":35},"phone_number":{"type":"string","maxLength":40},"email_address":{"type":"string","maxLength":320},"mailer_contact":{"type":"object","additionalProperties":true},"context":{"type":"object","additionalProperties":true},"trusted_partner_token":{"type":"string","maxLength":2000}},"required":["method"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"platform_tools","x-mcp-tool":"start-gmb-verification","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-verifications"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_verification"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"verification":{"type":["null","object"],"additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-verifications/options":{"post":{"operationId":"fetchGmbVerificationOptions","summary":"Fetch Google Business verification options","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"language_code":{"type":"string","minLength":2,"maxLength":35},"context":{"type":"object","additionalProperties":true}},"required":["language_code"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"fetch-gmb-verification-options","x-zernio":["POST /v1/accounts/{accountId}/gmb-verifications/options"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_verification_options"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"options":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-verifications/{verificationId}/complete":{"post":{"operationId":"completeGmbVerification","summary":"Complete a Google Business verification","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"location_id":{"type":"string","minLength":1,"maxLength":300,"description":"Act on another location of the same Google login: `locations/{id}`, `accounts/{a}/locations/{l}` or a bare id"},"pin":{"type":"string","minLength":1,"maxLength":20}},"required":["pin"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"verificationId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"platform_tools","x-mcp-tool":"complete-gmb-verification","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-verifications/{verificationId}/complete"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_verification"]},"account_id":{"type":"string"},"location_id":{"type":["null","string"]},"verification":{"type":["null","object"],"additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-locations":{"get":{"operationId":"listGmbLocations","summary":"List Google Business locations of the login","tags":["Platform tools"],"description":"Every location the connected Google login manages (location picker), with the Socialit account already connected to each.","parameters":[{"schema":{"type":"string","maxLength":200},"in":"query","name":"search","required":false},{"schema":{"type":"string","maxLength":500},"in":"query","name":"filter","required":false},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":300},"in":"query","name":"google_account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-gmb-locations","x-zernio":["GET /v1/accounts/{accountId}/gmb-locations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"selected_location_id":{"type":["null","string"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["gmb_location"]},"id":{"type":"string"},"location_id":{"type":["null","string"]},"external_id":{"type":["null","string"]},"name":{"type":["null","string"]},"title":{"type":["null","string"]},"google_account_id":{"type":["null","string"]},"google_account_name":{"type":["null","string"]},"google_account_type":{"type":["null","string"]},"address":{"type":["null","string"]},"category":{"type":["null","string"]},"store_code":{"type":["null","string"]},"phone":{"type":["null","string"]},"website_uri":{"type":["null","string"]},"open_status":{"type":["null","string"]},"labels":{"type":["null","array"],"items":{"type":"string"}},"place_id":{"type":["null","string"]},"maps_uri":{"type":["null","string"]},"review_url":{"type":["null","string"]},"is_verified":{"type":["null","boolean"]},"has_pending_edits":{"type":["null","boolean"]},"has_google_updated":{"type":["null","boolean"]},"can_have_food_menus":{"type":["null","boolean"]},"can_operate_lodging_data":{"type":["null","boolean"]},"can_operate_local_post":{"type":["null","boolean"]},"can_modify_service_list":{"type":["null","boolean"]},"duplicate_location":{"type":["null","string","object"],"additionalProperties":true},"connected_account_id":{"type":["null","string"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"selectGmbLocation","summary":"Switch the Google Business location","tags":["Platform tools"],"description":"Point this account at another location of the same Google login. Emits `account.updated`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"selected_location_id":{"type":"string","minLength":1,"maxLength":300},"google_account_id":{"type":"string","maxLength":300}},"required":["selected_location_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"select-gmb-location","x-zernio":["PUT /v1/accounts/{accountId}/gmb-locations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_location_selection"]},"account_id":{"type":"string"},"message":{"type":"string"},"selected_location":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["gmb_location"]},"id":{"type":"string"},"location_id":{"type":["null","string"]},"external_id":{"type":["null","string"]},"name":{"type":["null","string"]},"title":{"type":["null","string"]},"google_account_id":{"type":["null","string"]},"google_account_name":{"type":["null","string"]},"google_account_type":{"type":["null","string"]},"address":{"type":["null","string"]},"category":{"type":["null","string"]},"store_code":{"type":["null","string"]},"phone":{"type":["null","string"]},"website_uri":{"type":["null","string"]},"open_status":{"type":["null","string"]},"labels":{"type":["null","array"],"items":{"type":"string"}},"place_id":{"type":["null","string"]},"maps_uri":{"type":["null","string"]},"review_url":{"type":["null","string"]},"is_verified":{"type":["null","boolean"]},"has_pending_edits":{"type":["null","boolean"]},"has_google_updated":{"type":["null","boolean"]},"can_have_food_menus":{"type":["null","boolean"]},"can_operate_lodging_data":{"type":["null","boolean"]},"can_operate_local_post":{"type":["null","boolean"]},"can_modify_service_list":{"type":["null","boolean"]},"duplicate_location":{"type":["null","string","object"],"additionalProperties":true},"connected_account_id":{"type":["null","string"]}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/gmb-locations/assign":{"post":{"operationId":"assignGmbLocation","summary":"Assign a Google Business location to a profile","tags":["Platform tools"],"description":"Connect another location of the same Google login as a new account in `profile_id` (201), or move it there when it is already connected in this workspace (200). Counts toward the plan account allowance. Emits `account.connected` / `account.updated`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"profile_id":{"type":"string","minLength":1,"maxLength":80},"selected_location_id":{"type":"string","minLength":1,"maxLength":300},"google_account_id":{"type":"string","maxLength":300}},"required":["profile_id","selected_location_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"platform_tools","x-mcp-tool":"assign-gmb-location","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-locations/assign"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_location_assignment"]},"message":{"type":"string"},"profile_id":{"type":"string"},"selected_location_id":{"type":["null","string"]},"account":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string"},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string"},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"]},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"]},"created_at":{"type":["null","string"]},"updated_at":{"type":["null","string"]}}}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["gmb_location_assignment"]},"message":{"type":"string"},"profile_id":{"type":"string"},"selected_location_id":{"type":["null","string"]},"account":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":"string"},"account_type":{"type":"string"},"profile_id":{"type":["null","string"]},"group_ids":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string"},"parent_external_id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_url":{"type":["null","string"]},"status":{"type":"string"},"is_active":{"type":"boolean"},"needs_reconnect":{"type":"boolean"},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"]},"default_config":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true},"followers_count":{"type":["null","integer"]},"followers_updated_at":{"type":["null","string"]},"created_at":{"type":["null","string"]},"updated_at":{"type":["null","string"]}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook-page":{"get":{"operationId":"listFacebookPages","summary":"List Facebook Pages of the connection","tags":["Platform tools"],"description":"Pages the connecting Facebook user granted, with the selected one and per-Page capabilities.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"refresh","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-facebook-pages","x-zernio":["GET /v1/accounts/{accountId}/facebook-page"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"selected_page_id":{"type":["null","string"]},"truncated":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["facebook_page"]},"id":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"category":{"type":["null","string"]},"picture":{"type":["null","string"]},"tasks":{"type":"array","items":{"type":"string"}},"can_publish":{"type":"boolean"},"can_message":{"type":"boolean"},"can_analyze":{"type":"boolean"}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"selectFacebookPage","summary":"Switch the Facebook Page","tags":["Platform tools"],"description":"Point this account at another Page the user manages (stores the Page token). Emits `account.updated`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"selected_page_id":{"type":"string","minLength":1,"maxLength":64}},"required":["selected_page_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"select-facebook-page","x-zernio":["PUT /v1/accounts/{accountId}/facebook-page"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["facebook_page_selection"]},"account_id":{"type":"string"},"message":{"type":"string"},"previous_page_id":{"type":["null","string"]},"selected_page":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/webhook-subscription":{"get":{"operationId":"getFacebookWebhookSubscription","summary":"Read the Facebook Page's webhook subscription","tags":["Platform tools"],"description":"Whether Socialit is subscribed to the Page (real-time comments, messages, leads) and which fields are missing.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-facebook-webhook-subscription","x-zernio":["GET /v1/accounts/{accountId}/webhook-subscription"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["facebook_webhook_subscription"]},"account_id":{"type":"string"},"page_id":{"type":"string"},"app_subscribed":{"type":"boolean"},"subscribed_fields":{"type":"array","items":{"type":"string"}},"missing_fields":{"type":"array","items":{"type":"string"}},"leadgen":{"type":"boolean"},"apps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]}}}},"warning":{"type":["null","string"]},"resubscribed":{"type":["null","boolean"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"resubscribeFacebookWebhooks","summary":"Re-subscribe the Facebook Page to Socialit webhooks","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":["object","null"],"additionalProperties":false,"properties":{"fields":{"type":"array","maxItems":50,"items":{"type":"string","pattern":"^[a-z_]{1,64}$"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"platform_tools","x-mcp-tool":"resubscribe-facebook-webhooks","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/webhook-subscription"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["facebook_webhook_subscription"]},"account_id":{"type":"string"},"page_id":{"type":"string"},"app_subscribed":{"type":"boolean"},"subscribed_fields":{"type":"array","items":{"type":"string"}},"missing_fields":{"type":"array","items":{"type":"string"}},"leadgen":{"type":"boolean"},"apps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]}}}},"warning":{"type":["null","string"]},"resubscribed":{"type":["null","boolean"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/business-partners":{"get":{"operationId":"listFacebookBusinessPartners","summary":"List partner businesses of the Page","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-facebook-business-partners","x-zernio":["GET /v1/accounts/{accountId}/business-partners"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"page":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"business":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":["null","string"]}}}}},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["facebook_business_partner"]},"id":{"type":"string"},"name":{"type":["null","string"]},"permitted_tasks":{"type":["null","array"],"items":{"type":"string"}}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"shareFacebookPageWithPartner","summary":"Share the Page with a partner business","tags":["Platform tools"],"description":"Grant a partner Business Manager tasks on the Page (default ADVERTISE + ANALYZE).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"business_id":{"type":"string","pattern":"^[0-9]{1,32}$"},"permitted_tasks":{"type":"array","minItems":1,"maxItems":40,"items":{"type":"string","pattern":"^[A-Z_]{2,64}$"}}},"required":["business_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"platform_tools","x-mcp-tool":"share-facebook-page-with-partner","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/business-partners"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["facebook_business_partner_share"]},"account_id":{"type":"string"},"page":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"business":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":["null","string"]}}}}},"partner":{"type":"object","properties":{"id":{"type":"string"},"permitted_tasks":{"type":"array","items":{"type":"string"}}}},"already_shared":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"revokeFacebookBusinessPartner","summary":"Revoke a partner business from the Page","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","pattern":"^[0-9]{1,32}$"},"in":"query","name":"business_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"platform_tools","x-mcp-tool":"revoke-facebook-business-partner","x-zernio":["DELETE /v1/accounts/{accountId}/business-partners"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["facebook_business_partner"]},"id":{"type":"string"},"page_id":{"type":["null","string"]},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin-organizations":{"get":{"operationId":"listLinkedinOrganizations","summary":"List LinkedIn organizations","tags":["Platform tools"],"description":"Organizations (Pages) the member has a role on, with posting/admin rights.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-linkedin-organizations","x-zernio":["GET /v1/accounts/{accountId}/linkedin-organizations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["linkedin_organization"]},"id":{"type":"string"},"urn":{"type":"string"},"name":{"type":["null","string"]},"localized_name":{"type":["null","string"]},"vanity_name":{"type":["null","string"]},"logo_url":{"type":["null","string"]},"roles":{"type":"array","items":{"type":"string"}},"can_post":{"type":"boolean"},"is_admin":{"type":"boolean"}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin-organization":{"patch":{"operationId":"switchLinkedinAccountType","summary":"Switch LinkedIn account type","tags":["Platform tools"],"description":"Post as the personal profile or as an organization the member administers. Emits `account.updated`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_type":{"type":"string","enum":["personal","organization"]},"selected_organization":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"integer"}]},"urn":{"type":"string"}},"additionalProperties":true}]}},"required":["account_type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"switch-linkedin-account-type","x-zernio":["PUT /v1/accounts/{accountId}/linkedin-organization"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["linkedin_account_type"]},"account_id":{"type":"string"},"account_type":{"type":"string"},"account_name":{"type":["null","string"]},"message":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin-mentions":{"get":{"operationId":"resolveLinkedinMention","summary":"Resolve a LinkedIn mention","tags":["Platform tools"],"description":"Turn a linkedin.com profile/company URL (or URN) into a mention (`@[Name](urn)`) for post content.","parameters":[{"schema":{"type":"string","minLength":3,"maxLength":2000},"in":"query","name":"url","required":true},{"schema":{"type":"string","maxLength":200},"in":"query","name":"display_name","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"organization_urn","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"resolve-linkedin-mention","x-zernio":["GET /v1/accounts/{accountId}/linkedin-mentions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["linkedin_mention"]},"urn":{"type":"string"},"type":{"type":"string"},"display_name":{"type":["null","string"]},"mention_format":{"type":["null","string"]},"vanity_name":{"type":["null","string"]},"warning":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/stories":{"get":{"operationId":"listInstagramStories","summary":"List active Instagram stories","tags":["Platform tools"],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":2048},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-instagram-stories","x-zernio":["GET /v1/accounts/{accountId}/instagram/stories"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["instagram_story"]},"id":{"type":"string"},"media_type":{"type":["null","string"]},"media_product_type":{"type":["null","string"]},"media_url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"permalink":{"type":["null","string"]},"timestamp":{"type":["null","string"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"instagramStoriesCreate","summary":"Instagram: Create a Stories item","tags":["Focus · Instagram"],"description":"Publish Story/Stories (each media item becomes one Story). Active Stories (24 h). Insights are only readable while live; archived story metrics come from the story_insights webhook (Facebook Login). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/stories Generic route: `/v1/accounts/{accountId}/focus/stories`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"type":{"type":["string","null"],"enum":["image","video",null]},"alt_text":{"type":["string","null"],"maxLength":1000}}},"minItems":1,"maxItems":10},"user_tags":{"type":["array","null"],"items":{"type":"object","properties":{"username":{"type":"string"},"x":{"type":["number","null"]},"y":{"type":["number","null"]},"media_index":{"type":["integer","null"]}}}}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-stories-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO"]},"media_product_type":{"type":"string","enum":["STORY"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/stories/{storyId}/insights":{"get":{"operationId":"getInstagramStoryInsights","summary":"Get Instagram story insights","tags":["Platform tools"],"description":"Metrics of a live story (24 h). `source: unavailable` with `reason` when Instagram no longer serves them.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"path","name":"storyId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-instagram-story-insights","x-zernio":["GET /v1/accounts/{accountId}/instagram/stories/{storyId}/insights"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_story_insights"]},"story_id":{"type":"string"},"source":{"type":"string"},"reason":{"type":["null","string"]},"views":{"type":"integer"},"reach":{"type":"integer"},"replies":{"type":"integer"},"shares":{"type":"integer"},"profile_visits":{"type":"integer"},"follows":{"type":"integer"},"total_interactions":{"type":"integer"},"navigation":{"type":"integer"},"taps_forward":{"type":"integer"},"taps_back":{"type":"integer"},"exits":{"type":"integer"},"swipes_forward":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/publishing-limit":{"get":{"operationId":"getInstagramPublishingLimit","summary":"Get Instagram publishing limit","tags":["Platform tools"],"description":"Rolling 24 h content publishing quota (usage, total, remaining).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-instagram-publishing-limit","x-zernio":["GET /v1/accounts/{accountId}/instagram/publishing-limit"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_publishing_limit"]},"account_id":{"type":"string"},"quota_usage":{"type":"integer"},"quota_total":{"type":"integer"},"quota_duration_seconds":{"type":"integer"},"remaining":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/audio":{"get":{"operationId":"searchInstagramAudio","summary":"Search Instagram audio","tags":["Platform tools"],"description":"Reels audio search (trending when `q` is omitted). Needs a Facebook-Login Instagram connection.","parameters":[{"schema":{"type":"string","enum":["music","original_sound"],"default":"music"},"in":"query","name":"audio_type","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"q","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":2048},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"search-instagram-audio","x-zernio":["GET /v1/accounts/{accountId}/instagram/audio"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_audio"]},"audio_id":{"type":"string"},"title":{"type":["null","string"]},"duration_in_ms":{"type":["null","integer"]},"audio_type":{"type":["null","string"]},"display_artist":{"type":["null","string"]},"ig_username":{"type":["null","string"]},"profile_picture_url":{"type":["null","string"]},"download_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"cover_artwork_url":{"type":["null","string"]},"is_ads_eligible":{"type":["null","boolean"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/audio/{audioId}":{"get":{"operationId":"getInstagramAudio","summary":"Get Instagram audio metadata","tags":["Platform tools"],"description":"Re-validates a track and refreshes its preview URL (expires after ~1.5 days).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"path","name":"audioId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-instagram-audio","x-zernio":["GET /v1/accounts/{accountId}/instagram/audio/{audioId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_audio"]},"audio_id":{"type":"string"},"title":{"type":["null","string"]},"duration_in_ms":{"type":["null","integer"]},"audio_type":{"type":["null","string"]},"display_artist":{"type":["null","string"]},"ig_username":{"type":["null","string"]},"profile_picture_url":{"type":["null","string"]},"download_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"cover_artwork_url":{"type":["null","string"]},"is_ads_eligible":{"type":["null","boolean"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/business-discovery":{"get":{"operationId":"instagramBusinessDiscovery","summary":"Look up a public Instagram Business account","tags":["Platform tools"],"description":"Public profile and recent media of another Business/Creator account (competitor research).","parameters":[{"schema":{"type":"string","pattern":"^@?[A-Za-z0-9._]{1,30}$"},"in":"query","name":"username","required":true},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":12},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":2048},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"instagram-business-discovery","x-zernio":["GET /v1/accounts/{accountId}/instagram/business-discovery"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_business_discovery"]},"profile":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"ig_id":{"type":["null","integer","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"biography":{"type":["null","string"]},"website":{"type":["null","string"]},"profile_picture_url":{"type":["null","string"]},"followers_count":{"type":["null","integer"]},"follows_count":{"type":["null","integer"]},"media_count":{"type":["null","integer"]}}},"media":{"type":"array","items":{"type":"object","additionalProperties":true}},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/follow-status/{userId}":{"get":{"operationId":"getInstagramFollowStatus","summary":"Check whether an Instagram user follows the account","tags":["Platform tools"],"description":"Follow relationship for an Instagram-scoped user id (IGSID). Meta only answers for users who messaged the account; otherwise `unavailable_reason` is set.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"refresh","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"path","name":"userId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-instagram-follow-status","x-zernio":["GET /v1/accounts/{accountId}/follow-status/{userId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_follow_status"]},"account_id":{"type":"string"},"user_id":{"type":"string"},"is_follower":{"type":["null","boolean"]},"is_followed_by_account":{"type":["null","boolean"]},"follower_count":{"type":["null","integer"]},"is_verified":{"type":["null","boolean"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"unavailable_reason":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest-boards":{"get":{"operationId":"listPinterestBoards","summary":"List Pinterest boards","tags":["Platform tools"],"description":"Every board of the Pinterest account plus the stored default board.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-pinterest-boards","x-zernio":["GET /v1/accounts/{accountId}/pinterest-boards"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"default_board_id":{"type":["null","string"]},"default_board_name":{"type":["null","string"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["pinterest_board"]},"id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]},"url":{"type":["null","string"]},"pin_count":{"type":["null","integer"]},"follower_count":{"type":["null","integer"]},"collaborator_count":{"type":["null","integer"]},"is_ads_only":{"type":["null","boolean"]},"image_cover_url":{"type":["null","string"]},"owner_username":{"type":["null","string"]},"created_at":{"type":["null","string"]},"board_pins_modified_at":{"type":["null","string"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createPinterestBoard","summary":"Create a Pinterest board","tags":["Platform tools"],"description":"SECRET boards need the `boards:write_secret` scope.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":180},"description":{"type":"string","maxLength":500},"privacy":{"type":"string","enum":["PUBLIC","PROTECTED","SECRET"]}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"platform_tools","x-mcp-tool":"create-pinterest-board","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/pinterest-boards"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["pinterest_board"]},"id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]},"url":{"type":["null","string"]},"pin_count":{"type":["null","integer"]},"follower_count":{"type":["null","integer"]},"collaborator_count":{"type":["null","integer"]},"is_ads_only":{"type":["null","boolean"]},"image_cover_url":{"type":["null","string"]},"owner_username":{"type":["null","string"]},"created_at":{"type":["null","string"]},"board_pins_modified_at":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"setDefaultPinterestBoard","summary":"Set the default Pinterest board","tags":["Platform tools"],"description":"Used when a post does not name a board. Emits `account.updated`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"default_board_id":{"type":"string","minLength":1,"maxLength":64},"default_board_name":{"type":"string","maxLength":180}},"required":["default_board_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"set-default-pinterest-board","x-zernio":["PUT /v1/accounts/{accountId}/pinterest-boards"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["pinterest_default_board"]},"account_id":{"type":"string"},"default_board_id":{"type":"string"},"default_board_name":{"type":["null","string"]},"message":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube-playlists":{"get":{"operationId":"listYoutubePlaylists","summary":"List YouTube playlists","tags":["Platform tools"],"description":"Every playlist of the channel plus the stored default playlist.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-youtube-playlists","x-zernio":["GET /v1/accounts/{accountId}/youtube-playlists"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"default_playlist_id":{"type":["null","string"]},"default_playlist_name":{"type":["null","string"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["youtube_playlist"]},"id":{"type":"string"},"title":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]},"item_count":{"type":["null","integer"]},"thumbnail_url":{"type":["null","string"]},"published_at":{"type":["null","string"]},"url":{"type":["null","string"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createYoutubePlaylist","summary":"Create a YouTube playlist","tags":["Platform tools"],"description":"Costs 50 quota units; not idempotent upstream (list before retrying).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","minLength":1,"maxLength":150},"description":{"type":"string","maxLength":5000},"privacy":{"type":"string","enum":["private","public","unlisted"],"default":"private"},"default_language":{"type":"string","maxLength":35}},"required":["title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"platform_tools","x-mcp-tool":"create-youtube-playlist","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/youtube-playlists"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["youtube_playlist"]},"id":{"type":"string"},"title":{"type":["null","string"]},"description":{"type":["null","string"]},"privacy":{"type":["null","string"]},"item_count":{"type":["null","integer"]},"thumbnail_url":{"type":["null","string"]},"published_at":{"type":["null","string"]},"url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"setDefaultYoutubePlaylist","summary":"Set the default YouTube playlist","tags":["Platform tools"],"description":"Pre-fills the composer playlist. Emits `account.updated`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"default_playlist_id":{"type":"string","minLength":1,"maxLength":64},"default_playlist_name":{"type":"string","maxLength":150}},"required":["default_playlist_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"set-default-youtube-playlist","x-zernio":["PUT /v1/accounts/{accountId}/youtube-playlists"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["youtube_default_playlist"]},"account_id":{"type":"string"},"default_playlist_id":{"type":"string"},"default_playlist_name":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube-captions":{"get":{"operationId":"getYoutubeTranscript","summary":"Get a YouTube video transcript","tags":["Platform tools"],"description":"Caption track of a video on the channel as text + timed cues (optionally SRT/VTT, or translated with `tlang`).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"video_id","required":true},{"schema":{"type":"string","maxLength":35},"in":"query","name":"language","required":false},{"schema":{"type":"string","enum":["json","srt","vtt"],"default":"json"},"in":"query","name":"format","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"track_id","required":false},{"schema":{"type":"string","maxLength":35},"in":"query","name":"tlang","required":false},{"schema":{"type":"boolean"},"in":"query","name":"refresh","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-youtube-transcript","x-zernio":["GET /v1/accounts/{accountId}/youtube-captions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["youtube_transcript"]},"account_id":{"type":"string"},"video_id":{"type":"string"},"language":{"type":["null","string"]},"track_id":{"type":["null","string"]},"track_kind":{"type":["null","string"]},"source":{"type":"string"},"fetched_at":{"type":["null","string"]},"text":{"type":["null","string"]},"cues":{"type":"array","items":{"type":"object","properties":{"start":{"type":["null","number"]},"end":{"type":["null","number"]},"text":{"type":["null","string"]}}}},"srt":{"type":["null","string"]},"vtt":{"type":["null","string"]},"available_tracks":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit-subreddits":{"get":{"operationId":"listRedditSubreddits","summary":"List Reddit subreddits","tags":["Platform tools"],"description":"Subreddits the user can post to (subscriber/contributor/moderator, plus the user profile) and the default subreddit.","parameters":[{"schema":{"type":"string","enum":["postable","subscriber","moderator","contributor"],"default":"postable"},"in":"query","name":"where","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-reddit-subreddits","x-zernio":["GET /v1/accounts/{accountId}/reddit-subreddits"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"default_subreddit":{"type":["null","string"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["reddit_subreddit"]},"id":{"type":["null","string"]},"name":{"type":["null","string"]},"prefixed_name":{"type":["null","string"]},"title":{"type":["null","string"]},"description":{"type":["null","string"]},"subscribers":{"type":["null","integer"]},"active_users":{"type":["null","integer"]},"type":{"type":["null","string"]},"over_18":{"type":["null","boolean"]},"quarantined":{"type":["null","boolean"]},"submission_type":{"type":["null","string"]},"post_types":{"type":"object","additionalProperties":true},"user_is_moderator":{"type":["null","boolean"]},"user_is_contributor":{"type":["null","boolean"]},"user_is_subscriber":{"type":["null","boolean"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"setDefaultRedditSubreddit","summary":"Set the default subreddit","tags":["Platform tools"],"description":"Validates the subreddit exists. Emits `account.updated`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"default_subreddit":{"type":"string","minLength":1,"maxLength":64}},"required":["default_subreddit"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"set-default-reddit-subreddit","x-zernio":["PUT /v1/accounts/{accountId}/reddit-subreddits"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["reddit_default_subreddit"]},"account_id":{"type":"string"},"default_subreddit":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit-subreddits/{subreddit}/rules":{"get":{"operationId":"getRedditSubredditRules","summary":"Get subreddit rules","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"path","name":"subreddit","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-reddit-subreddit-rules","x-zernio":["GET /v1/accounts/{accountId}/reddit-subreddits/{subreddit}/rules"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["reddit_subreddit_rules"]},"subreddit":{"type":"string"},"rules":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":["null","string"]},"priority":{"type":["null","integer"]},"short_name":{"type":["null","string"]},"description":{"type":["null","string"]},"violation_reason":{"type":["null","string"]},"kind":{"type":["null","string"]},"created_at":{"type":["null","string"]}}}},"site_rules":{"type":"array","items":{"type":"string"}},"site_rules_flow":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit-flairs":{"get":{"operationId":"listRedditFlairs","summary":"List subreddit post flairs","tags":["Platform tools"],"description":"`restricted: true` when the user cannot set link flair in that subreddit.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"subreddit","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-reddit-flairs","x-zernio":["GET /v1/accounts/{accountId}/reddit-flairs"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"subreddit":{"type":"string"},"restricted":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["reddit_flair"]},"id":{"type":"string"},"text":{"type":["null","string"]},"text_color":{"type":["null","string"]},"background_color":{"type":["null","string"]},"text_editable":{"type":"boolean"},"type":{"type":["null","string"]},"richtext":{"type":"array"},"mod_only":{"type":"boolean"},"allowable_content":{"type":["null","string"]},"max_emojis":{"type":["null","integer"]},"css_class":{"type":["null","string"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"setRedditPostFlair","summary":"Set a Reddit post flair","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"subreddit":{"type":"string","minLength":1,"maxLength":64},"post_id":{"type":"string","minLength":1,"maxLength":32},"flair_template_id":{"type":"string","minLength":1,"maxLength":64},"text":{"type":"string","maxLength":64}},"required":["post_id","flair_template_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"platform_tools","x-mcp-tool":"set-reddit-post-flair","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/reddit-flairs"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["reddit_post_flair"]},"account_id":{"type":"string"},"post_id":{"type":"string"},"flair_template_id":{"type":"string"},"text":{"type":["null","string"]},"success":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit-vote":{"post":{"operationId":"voteOnReddit","summary":"Vote on a Reddit post or comment","tags":["Platform tools"],"description":"One vote per call, triggered by an explicit human action (automated or bulk voting violates Reddit rules).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"thing_id":{"type":"string","minLength":2,"maxLength":32},"direction":{"type":"integer","enum":[1,0,-1]}},"required":["thing_id","direction"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"platform_tools","x-mcp-tool":"vote-on-reddit","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/reddit-vote"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["reddit_vote"]},"account_id":{"type":"string"},"thing_id":{"type":"string"},"direction":{"type":"integer"},"success":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/creator-info":{"get":{"operationId":"getTiktokCreatorInfo","summary":"Get TikTok creator info","tags":["Platform tools"],"description":"Latest creator_info for the Post-to-TikTok UX: privacy options, interaction locks, max duration, whether the creator can post now.","parameters":[{"schema":{"type":"string","enum":["video","photo"],"default":"video"},"in":"query","name":"media_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-tiktok-creator-info","x-zernio":["GET /v1/accounts/{accountId}/tiktok/creator-info"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tiktok_creator_info"]},"account_id":{"type":"string"},"lane":{"type":"string"},"creator":{"type":"object","properties":{"nickname":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"is_verified":{"type":["null","boolean"]},"can_post_more":{"type":"boolean"},"reason":{"type":["null","string","number"]}}},"privacy_levels":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":["null","string"]}}}},"posting_limits":{"type":"object","properties":{"max_video_duration_sec":{"type":["null","integer"]},"interaction_settings":{"type":"object","properties":{"allow_comment":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"required":{"type":"boolean"},"default":{"type":"boolean"},"label":{"type":["null","string"]}}},"allow_duet":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"required":{"type":"boolean"},"default":{"type":"boolean"},"label":{"type":["null","string"]}}},"allow_stitch":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"required":{"type":"boolean"},"default":{"type":"boolean"},"label":{"type":["null","string"]}}}}}}},"commercial_content_types":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":["null","string"]},"requires":{"type":["null","string"]}}}},"warning":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/composer":{"get":{"operationId":"getTiktokComposerRequirements","summary":"Get TikTok composer requirements","tags":["Platform tools"],"description":"Everything a \"Post to TikTok\" UI must render under the Content Sharing Guidelines, from live creator_info: creator nickname/avatar, privacy options (no default), interaction toggles (off by default, locked when the creator disabled them), commercial content disclosure, the exact declaration text, notices and limits. Re-fetch on every composer render.","parameters":[{"schema":{"type":"string","enum":["video","photo"],"default":"video"},"in":"query","name":"media_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-tiktok-composer-requirements","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tiktok_composer_requirements"]},"account_id":{"type":"string"},"lane":{"type":"string"},"media_type":{"type":"string"},"fetched_at":{"type":"string"},"creator":{"type":"object","properties":{"nickname":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"avatar_ttl_seconds":{"type":["null","integer"]},"must_display":{"type":"array","items":{"type":"string"}},"can_post":{"type":"boolean"},"cannot_post_reason":{"type":["null","string","number"]},"cannot_post_message":{"type":["null","string"]},"warning":{"type":["null","string"]}}},"privacy":{"type":"object","properties":{"options":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"allowed_with_branded_content":{"type":"boolean"}}}},"default":{"type":["null","string"]},"required":{"type":"boolean"},"control":{"type":"string"},"direct_post_forced":{"type":["null","string"]}}},"interactions":{"type":"object","properties":{"comment":{"type":["null","object"],"properties":{"label":{"type":"string"},"available":{"type":"boolean"},"disabled_by_creator":{"type":"boolean"},"default":{"type":"boolean"},"required_user_action":{"type":"boolean"}}},"duet":{"type":["null","object"],"properties":{"label":{"type":"string"},"available":{"type":"boolean"},"disabled_by_creator":{"type":"boolean"},"default":{"type":"boolean"},"required_user_action":{"type":"boolean"}}},"stitch":{"type":["null","object"],"properties":{"label":{"type":"string"},"available":{"type":"boolean"},"disabled_by_creator":{"type":"boolean"},"default":{"type":"boolean"},"required_user_action":{"type":"boolean"}}}}},"max_video_duration_sec":{"type":["null","integer"]},"commercial_content":{"type":"object","properties":{"toggle":{"type":"object","properties":{"label":{"type":"string"},"default":{"type":"boolean"}}},"options":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"maps_to":{"type":"string"},"notice":{"type":["null","string"]},"default":{"type":"boolean"},"disallowed_privacy":{"type":"array","items":{"type":"string"}},"disallowed_privacy_tooltip":{"type":"string"}}}},"multi_select":{"type":"boolean"},"both_selected_notice":{"type":["null","string"]},"selection_required_when_on":{"type":"boolean"},"publish_disabled_tooltip":{"type":"string"}}},"declaration":{"type":"object","properties":{"position":{"type":"string"},"default":{"type":"string"},"your_brand_only":{"type":"string"},"branded_content":{"type":"string"},"links":{"type":"object","properties":{"musicUsageConfirmation":{"type":"string"},"brandedContentPolicy":{"type":"string"}}}}},"notices":{"type":"object","properties":{"processing":{"type":"string"},"draft":{"type":"string"}}},"rules":{"type":"object","additionalProperties":{"type":"boolean"}},"limits":{"type":"object","properties":{"title_max":{"type":["null","integer"]},"description_max":{"type":["null","integer"]},"photos_max":{"type":["null","integer"]},"formats":{"type":"array","items":{"type":"string"}},"max_bytes":{"type":["null","integer"]},"posts_per_day":{"type":["null","integer"]},"pending_drafts":{"type":["null","integer"]}}},"features":{"type":"object","additionalProperties":{"type":"boolean"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/commercial-music":{"get":{"operationId":"listTiktokCommercialMusic","summary":"List trending TikTok commercial music","tags":["Platform tools"],"description":"Commercial Music Library tracks (TikTok Business connections).","parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$"},"in":"query","name":"country_code","required":false},{"schema":{"type":"string","maxLength":64},"in":"query","name":"genre","required":false},{"schema":{"type":"string","enum":["1DAY","7DAY","30DAY","90DAY"]},"in":"query","name":"date_range","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-tiktok-commercial-music","x-zernio":["GET /v1/accounts/{accountId}/tiktok/commercial-music"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["tiktok_music_track"]},"id":{"type":["null","string"]},"commercial_music_id":{"type":["null","string"]},"name":{"type":["null","string"]},"artist":{"type":["null","string"]},"duration_sec":{"type":["null","number"]},"genres":{"type":"array","items":{"type":"string"}},"preview_url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"rank":{"type":["null","integer"]},"trending_history":{"type":"array","items":{"type":"object","additionalProperties":true}},"clip":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"duration_sec":{"type":["null","number"]},"preview_url":{"type":["null","string"]}}}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/locations":{"get":{"operationId":"searchTiktokLocations","summary":"Search TikTok location tags","tags":["Platform tools"],"description":"Up to 20 location tags for posts (TikTok Business connections).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":100},"in":"query","name":"query","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"search-tiktok-locations","x-zernio":["GET /v1/accounts/{accountId}/tiktok/locations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tiktok_location"]},"id":{"type":["null","string"]},"name":{"type":["null","string"]},"address":{"type":["null","string"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky-settings":{"get":{"operationId":"getBlueskySettings","summary":"Get Bluesky account settings","tags":["Platform tools"],"description":"Posting defaults applied to every new Bluesky post (languages, reply/quote controls, labels, tags, auto facets/link cards).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-bluesky-settings","x-zernio":["GET /v1/accounts/{accountId}/bluesky-settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["bluesky_settings"]},"account_id":{"type":"string"},"default_langs":{"type":["null","array"],"items":{"type":"string"}},"default_threadgate":{"type":["null","array"],"items":{"type":"string"}},"default_postgate":{"type":["null","object"],"properties":{"disable_quotes":{"type":"boolean"}}},"default_labels":{"type":"array","items":{"type":"string"}},"default_tags":{"type":"array","items":{"type":"string"}},"auto_facets":{"type":"boolean"},"auto_link_cards":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateBlueskySettings","summary":"Update Bluesky account settings","tags":["Platform tools"],"description":"Partial update; only affects posts published afterwards. Emits `account.updated`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"default_langs":{"type":["array","null"],"maxItems":3,"items":{"type":"string","minLength":1,"maxLength":35}},"default_threadgate":{"type":["array","null"],"maxItems":5,"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"}},"default_postgate":{"type":["object","null"],"additionalProperties":false,"properties":{"disable_quotes":{"type":"boolean"}}},"default_labels":{"type":"array","maxItems":4,"items":{"type":"string","enum":["sexual","nudity","porn","graphic-media"]}},"default_tags":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":640}},"auto_facets":{"type":"boolean"},"auto_link_cards":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"update-bluesky-settings","x-zernio":["PATCH /v1/accounts/{accountId}/bluesky-settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["bluesky_settings"]},"account_id":{"type":"string"},"default_langs":{"type":["null","array"],"items":{"type":"string"}},"default_threadgate":{"type":["null","array"],"items":{"type":"string"}},"default_postgate":{"type":["null","object"],"properties":{"disable_quotes":{"type":"boolean"}}},"default_labels":{"type":"array","items":{"type":"string"}},"default_tags":{"type":"array","items":{"type":"string"}},"auto_facets":{"type":"boolean"},"auto_link_cards":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord-settings":{"get":{"operationId":"getDiscordSettings","summary":"Get Discord account settings","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-discord-settings","x-zernio":["GET /v1/accounts/{accountId}/discord-settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_settings"]},"account_id":{"type":"string"},"mode":{"type":"string"},"guild_id":{"type":["null","string"]},"guild_name":{"type":["null","string"]},"channel_id":{"type":["null","string"]},"channel_name":{"type":["null","string"]},"channel_type":{"type":["null","integer","string"]},"webhook_username":{"type":["null","string"]},"webhook_avatar_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateDiscordSettings","summary":"Update Discord account settings","tags":["Platform tools"],"description":"Webhook identity (username / avatar; empty clears) or, for bot connections, the posting channel in the same server. Emits `account.updated`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"webhook_username":{"type":["string","null"],"maxLength":80},"webhook_avatar_url":{"type":["string","null"],"maxLength":2048},"channel_id":{"type":"string","pattern":"^[0-9]{5,25}$"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"update-discord-settings","x-zernio":["PATCH /v1/accounts/{accountId}/discord-settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_settings"]},"account_id":{"type":"string"},"mode":{"type":"string"},"guild_id":{"type":["null","string"]},"guild_name":{"type":["null","string"]},"channel_id":{"type":["null","string"]},"channel_name":{"type":["null","string"]},"channel_type":{"type":["null","integer","string"]},"webhook_username":{"type":["null","string"]},"webhook_avatar_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord-channels":{"get":{"operationId":"listDiscordChannels","summary":"List Discord server channels","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","pattern":"^[0-9]+(,[0-9]+)*$"},"in":"query","name":"types","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-discord-channels","x-zernio":["GET /v1/accounts/{accountId}/discord-channels"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["discord_channel"]},"id":{"type":"string"},"name":{"type":["null","string"]},"type":{"type":"integer"},"type_name":{"type":["null","string"]},"parent_id":{"type":["null","string"]},"position":{"type":"integer"},"topic":{"type":["null","string"]},"nsfw":{"type":"boolean"},"postable":{"type":"boolean"}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/dms":{"post":{"operationId":"sendDiscordDm","summary":"Send a Discord direct message","tags":["Platform tools"],"description":"DM a server member from the Socialit bot. Runs on the Socialit Discord bot; `account_id` must be a bot-mode Discord account connected to that server.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"Social account id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"user_id":{"type":"string","pattern":"^[0-9]{5,25}$"},"content":{"type":"string","maxLength":2000},"embeds":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":true}},"attachments":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["image","video","gif","document"]},"url":{"type":"string","pattern":"^https?://","maxLength":4096},"filename":{"type":"string","maxLength":200},"mime_type":{"type":"string","maxLength":100},"size":{"type":"integer","minimum":0}},"required":["type","url"]}},"tts":{"type":"boolean"}},"required":["account_id","user_id"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"platform_tools","x-mcp-tool":"send-discord-dm","x-idempotent":true,"x-zernio":["POST /v1/discord/dms"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_dm"]},"account_id":{"type":"string"},"message_id":{"type":["null","string"]},"channel_id":{"type":["null","string"]},"url":{"type":["null","string"]},"timestamp":{"type":["null","string"]},"recipient":{"type":"object","properties":{"user_id":{"type":"string"},"platform":{"type":"string"}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/discord/guilds/{guildId}/roles":{"get":{"operationId":"listDiscordRoles","summary":"List Discord server roles","tags":["Platform tools"],"description":"Runs on the Socialit Discord bot; `account_id` must be a bot-mode Discord account connected to that server.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-discord-roles","x-zernio":["GET /v1/discord/guilds/{guildId}/roles"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"guild_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["discord_role"]},"id":{"type":"string"},"name":{"type":["null","string"]},"color":{"type":"integer"},"position":{"type":"integer"},"permissions":{"type":["null","string"]},"permission_names":{"type":"array","items":{"type":"string"}},"managed":{"type":"boolean"},"mentionable":{"type":"boolean"},"hoist":{"type":"boolean"},"icon":{"type":["null","string"]},"unicode_emoji":{"type":["null","string"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createDiscordRole","summary":"Create a Discord server role","tags":["Platform tools"],"description":"Runs on the Socialit Discord bot; `account_id` must be a bot-mode Discord account connected to that server. Needs MANAGE_ROLES.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"color":{"anyOf":[{"type":"integer","minimum":0,"maximum":16777215},{"type":"string","pattern":"^#?[0-9A-Fa-f]{6}$"}]},"hoist":{"type":"boolean"},"mentionable":{"type":"boolean"},"permissions":{"anyOf":[{"type":"string","pattern":"^[0-9]{1,30}$"},{"type":"array","items":{"type":"string","pattern":"^[A-Z_]{2,64}$"}}]},"unicode_emoji":{"type":["string","null"],"maxLength":32},"reason":{"type":"string","maxLength":512}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"platform_tools","x-mcp-tool":"create-discord-role","x-idempotent":true,"x-zernio":["POST /v1/discord/guilds/{guildId}/roles"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["discord_role"]},"id":{"type":"string"},"name":{"type":["null","string"]},"color":{"type":"integer"},"position":{"type":"integer"},"permissions":{"type":["null","string"]},"permission_names":{"type":"array","items":{"type":"string"}},"managed":{"type":"boolean"},"mentionable":{"type":"boolean"},"hoist":{"type":"boolean"},"icon":{"type":["null","string"]},"unicode_emoji":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/guilds/{guildId}/roles/{roleId}":{"patch":{"operationId":"updateDiscordRole","summary":"Edit a Discord server role","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"color":{"anyOf":[{"type":"integer","minimum":0,"maximum":16777215},{"type":"string","pattern":"^#?[0-9A-Fa-f]{6}$"}]},"hoist":{"type":"boolean"},"mentionable":{"type":"boolean"},"permissions":{"anyOf":[{"type":"string","pattern":"^[0-9]{1,30}$"},{"type":"array","items":{"type":"string","pattern":"^[A-Z_]{2,64}$"}}]},"unicode_emoji":{"type":["string","null"],"maxLength":32},"reason":{"type":"string","maxLength":512}},"minProperties":1}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"roleId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"update-discord-role","x-zernio":["PATCH /v1/discord/guilds/{guildId}/roles/{roleId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["discord_role"]},"id":{"type":"string"},"name":{"type":["null","string"]},"color":{"type":"integer"},"position":{"type":"integer"},"permissions":{"type":["null","string"]},"permission_names":{"type":"array","items":{"type":"string"}},"managed":{"type":"boolean"},"mentionable":{"type":"boolean"},"hoist":{"type":"boolean"},"icon":{"type":["null","string"]},"unicode_emoji":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteDiscordRole","summary":"Delete a Discord server role","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","maxLength":512},"in":"query","name":"reason","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"roleId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"platform_tools","x-mcp-tool":"delete-discord-role","x-zernio":["DELETE /v1/discord/guilds/{guildId}/roles/{roleId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_role"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/guilds/{guildId}/members":{"get":{"operationId":"listDiscordMembers","summary":"List Discord server members","tags":["Platform tools"],"description":"Needs the privileged GUILD_MEMBERS intent; otherwise an empty list with `intent_missing: true`. Page with `after` = next_cursor.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"integer","minimum":1,"maximum":1000,"default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","pattern":"^[0-9]{5,25}$"},"in":"query","name":"after","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-discord-members","x-zernio":["GET /v1/discord/guilds/{guildId}/members"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"guild_id":{"type":"string"},"intent_missing":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["discord_member"]},"id":{"type":"string"},"username":{"type":["null","string"]},"global_name":{"type":["null","string"]},"nick":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar":{"type":["null","string"]},"bot":{"type":"boolean"},"roles":{"type":"array","items":{"type":"string"}},"joined_at":{"type":["null","string"]},"premium_since":{"type":["null","string"]},"pending":{"type":"boolean"},"communication_disabled_until":{"type":["null","string"]},"flags":{"type":"integer"}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/guilds/{guildId}/members/search":{"get":{"operationId":"searchDiscordMembers","summary":"Search Discord server members","tags":["Platform tools"],"description":"Prefix match on username / nickname (no privileged intent needed).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":100},"in":"query","name":"query","required":true},{"schema":{"type":"integer","minimum":1,"maximum":1000,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"search-discord-members","x-zernio":["GET /v1/discord/guilds/{guildId}/members/search"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"guild_id":{"type":"string"},"intent_missing":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["discord_member"]},"id":{"type":"string"},"username":{"type":["null","string"]},"global_name":{"type":["null","string"]},"nick":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar":{"type":["null","string"]},"bot":{"type":"boolean"},"roles":{"type":"array","items":{"type":"string"}},"joined_at":{"type":["null","string"]},"premium_since":{"type":["null","string"]},"pending":{"type":"boolean"},"communication_disabled_until":{"type":["null","string"]},"flags":{"type":"integer"}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/guilds/{guildId}/members/{userId}":{"get":{"operationId":"getDiscordMember","summary":"Get a Discord server member","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"userId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-discord-member","x-zernio":["GET /v1/discord/guilds/{guildId}/members/{userId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["discord_member"]},"id":{"type":"string"},"username":{"type":["null","string"]},"global_name":{"type":["null","string"]},"nick":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar":{"type":["null","string"]},"bot":{"type":"boolean"},"roles":{"type":"array","items":{"type":"string"}},"joined_at":{"type":["null","string"]},"premium_since":{"type":["null","string"]},"pending":{"type":"boolean"},"communication_disabled_until":{"type":["null","string"]},"flags":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}":{"put":{"operationId":"addDiscordMemberRole","summary":"Assign a role to a Discord member","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","maxLength":512},"in":"query","name":"reason","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"userId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"roleId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"platform_tools","x-mcp-tool":"add-discord-member-role","x-zernio":["PUT /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_member_role"]},"guild_id":{"type":"string"},"user_id":{"type":"string"},"role_id":{"type":"string"},"operation":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"removeDiscordMemberRole","summary":"Remove a role from a Discord member","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","maxLength":512},"in":"query","name":"reason","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"userId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"roleId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"platform_tools","x-mcp-tool":"remove-discord-member-role","x-zernio":["DELETE /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_member_role"]},"guild_id":{"type":"string"},"user_id":{"type":"string"},"role_id":{"type":"string"},"operation":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/channels/{channelId}/messages/{messageId}":{"delete":{"operationId":"deleteDiscordMessage","summary":"Delete a Discord channel message","tags":["Platform tools"],"description":"Runs on the Socialit Discord bot; `account_id` must be a bot-mode Discord account connected to that server. Deleting other users' messages needs MANAGE_MESSAGES.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","maxLength":512},"in":"query","name":"reason","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"channelId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"messageId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"platform_tools","x-mcp-tool":"delete-discord-message","x-zernio":["DELETE /v1/discord/channels/{channelId}/messages/{messageId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_message"]},"id":{"type":"string"},"channel_id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/channels/{channelId}/messages/{messageId}/crosspost":{"post":{"operationId":"crosspostDiscordMessage","summary":"Crosspost a Discord announcement","tags":["Platform tools"],"description":"Publish an announcement-channel message to every following server.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"channelId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"messageId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"platform_tools","x-mcp-tool":"crosspost-discord-message","x-idempotent":true,"x-zernio":["POST /v1/discord/channels/{channelId}/messages/{messageId}/crosspost"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_crosspost"]},"id":{"type":"string"},"channel_id":{"type":"string"},"message":{"type":"object","additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/channels/{channelId}/threads":{"post":{"operationId":"createDiscordThread","summary":"Create a Discord public thread","tags":["Platform tools"],"description":"From a message when `message_id` is set, otherwise a standalone thread.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"message_id":{"type":"string","pattern":"^[0-9]{5,25}$"},"auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600},"reason":{"type":"string","maxLength":512}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"channelId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"platform_tools","x-mcp-tool":"create-discord-thread","x-idempotent":true,"x-zernio":["POST /v1/discord/channels/{channelId}/threads"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_thread"]},"id":{"type":"string"},"name":{"type":["null","string"]},"parent_id":{"type":["null","string"]},"thread":{"type":"object","additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/channels/{channelId}/pins":{"get":{"operationId":"listDiscordPins","summary":"List pinned Discord messages","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","maxLength":40},"in":"query","name":"before","required":false},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"channelId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-discord-pins","x-zernio":["GET /v1/discord/channels/{channelId}/pins"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"channel_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["discord_pinned_message"]},"id":{"type":"string"},"channel_id":{"type":["null","string"]},"content":{"type":["null","string"]},"timestamp":{"type":["null","string"]},"pinned_at":{"type":["null","string"]},"author":{"type":"object","additionalProperties":true},"attachments":{"type":"array","items":{"type":"object","additionalProperties":true}},"embeds":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/channels/{channelId}/pins/{messageId}":{"put":{"operationId":"pinDiscordMessage","summary":"Pin a Discord message","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","maxLength":512},"in":"query","name":"reason","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"channelId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"messageId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"platform_tools","x-mcp-tool":"pin-discord-message","x-zernio":["PUT /v1/discord/channels/{channelId}/pins/{messageId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_pin"]},"channel_id":{"type":"string"},"message_id":{"type":"string"},"pinned":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"unpinDiscordMessage","summary":"Unpin a Discord message","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","maxLength":512},"in":"query","name":"reason","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"channelId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"messageId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"platform_tools","x-mcp-tool":"unpin-discord-message","x-zernio":["DELETE /v1/discord/channels/{channelId}/pins/{messageId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_pin"]},"channel_id":{"type":"string"},"message_id":{"type":"string"},"pinned":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/guilds/{guildId}/events":{"get":{"operationId":"listDiscordEvents","summary":"List Discord scheduled events","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"boolean","default":true},"in":"query","name":"with_user_count","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"list-discord-events","x-zernio":["GET /v1/discord/guilds/{guildId}/events"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"account_id":{"type":"string"},"guild_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["discord_scheduled_event"]},"id":{"type":"string"},"guild_id":{"type":["null","string"]},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"starts_at":{"type":["null","string"]},"ends_at":{"type":["null","string"]},"status":{"type":["string","integer"]},"entity_type":{"type":["string","integer"]},"channel_id":{"type":["null","string"]},"location":{"type":["null","string"]},"user_count":{"type":["null","integer"]},"image":{"type":["null","string"]},"recurrence_rule":{"type":["null","object"],"additionalProperties":true},"creator_id":{"type":["null","string"]}}}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createDiscordEvent","summary":"Create a Discord scheduled event","tags":["Platform tools"],"description":"External (location + end time), voice or stage (channel) events; always server-only privacy.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"Social account id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":1000},"starts_at":{"type":"string","minLength":10,"maxLength":40},"ends_at":{"type":"string","minLength":10,"maxLength":40},"entity":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["external","voice","stage"]},"location":{"type":"string","maxLength":100},"channel_id":{"type":"string","pattern":"^[0-9]{5,25}$"},"ends_at":{"type":"string","minLength":10,"maxLength":40}},"required":["type"]},"image_data_uri":{"type":["string","null"],"maxLength":12000000,"description":"data: URI or https URL (null clears on update)"},"recurrence_rule":{"type":"object","additionalProperties":true},"reason":{"type":"string","maxLength":512}},"required":["account_id","name","starts_at","entity"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"platform_tools","x-mcp-tool":"create-discord-event","x-idempotent":true,"x-zernio":["POST /v1/discord/guilds/{guildId}/events"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_scheduled_event"]},"id":{"type":"string"},"guild_id":{"type":["null","string"]},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"starts_at":{"type":["null","string"]},"ends_at":{"type":["null","string"]},"status":{"type":["string","integer"]},"entity_type":{"type":["string","integer"]},"channel_id":{"type":["null","string"]},"location":{"type":["null","string"]},"user_count":{"type":["null","integer"]},"image":{"type":["null","string"]},"recurrence_rule":{"type":["null","object"],"additionalProperties":true},"creator_id":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/discord/guilds/{guildId}/events/{eventId}":{"get":{"operationId":"getDiscordEvent","summary":"Get a Discord scheduled event","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"boolean","default":true},"in":"query","name":"with_user_count","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"eventId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"platform_tools","x-mcp-tool":"get-discord-event","x-zernio":["GET /v1/discord/guilds/{guildId}/events/{eventId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_scheduled_event"]},"id":{"type":"string"},"guild_id":{"type":["null","string"]},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"starts_at":{"type":["null","string"]},"ends_at":{"type":["null","string"]},"status":{"type":["string","integer"]},"entity_type":{"type":["string","integer"]},"channel_id":{"type":["null","string"]},"location":{"type":["null","string"]},"user_count":{"type":["null","integer"]},"image":{"type":["null","string"]},"recurrence_rule":{"type":["null","object"],"additionalProperties":true},"creator_id":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateDiscordEvent","summary":"Update a Discord scheduled event","tags":["Platform tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"Social account id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":["string","null"],"maxLength":1000},"starts_at":{"type":"string","minLength":10,"maxLength":40},"ends_at":{"type":["string","null"],"maxLength":40},"location":{"type":"string","maxLength":100},"status":{"type":"string","enum":["scheduled","active","completed","cancelled"]},"image_data_uri":{"type":["string","null"],"maxLength":12000000,"description":"data: URI or https URL (null clears on update)"},"recurrence_rule":{"type":["object","null"],"additionalProperties":true},"reason":{"type":"string","maxLength":512}},"required":["account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"eventId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"platform_tools","x-mcp-tool":"update-discord-event","x-zernio":["PATCH /v1/discord/guilds/{guildId}/events/{eventId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_scheduled_event"]},"id":{"type":"string"},"guild_id":{"type":["null","string"]},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"starts_at":{"type":["null","string"]},"ends_at":{"type":["null","string"]},"status":{"type":["string","integer"]},"entity_type":{"type":["string","integer"]},"channel_id":{"type":["null","string"]},"location":{"type":["null","string"]},"user_count":{"type":["null","integer"]},"image":{"type":["null","string"]},"recurrence_rule":{"type":["null","object"],"additionalProperties":true},"creator_id":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteDiscordEvent","summary":"Delete a Discord scheduled event","tags":["Platform tools"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","maxLength":512},"in":"query","name":"reason","required":false},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"guildId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"eventId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"platform_tools","x-mcp-tool":"delete-discord-event","x-zernio":["DELETE /v1/discord/guilds/{guildId}/events/{eventId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["discord_scheduled_event"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts":{"get":{"operationId":"listPosts","summary":"List posts","tags":["Posts"],"description":"Posts with their per-account postings. Filters: status (repeatable), profile_id, account_id, platform, queue_id, tag, search, created_by, from/to on date_field, recycling.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","scheduled_at","published_at","status","updated_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"array","items":{"type":"string","maxLength":200}},"in":"query","name":"status","required":false,"description":"Status (repeatable or comma-separated): draft, pending_approval, scheduled, publishing, published, partially_published, failed, cancelled"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false},{"schema":{"type":"string"},"in":"query","name":"queue_id","required":false},{"schema":{"type":"string"},"in":"query","name":"tag","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"search","required":false},{"schema":{"type":"string"},"in":"query","name":"created_by","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false},{"schema":{"type":"string","enum":["scheduled_at","created_at","published_at"],"default":"scheduled_at"},"in":"query","name":"date_field","required":false},{"schema":{"type":"boolean"},"in":"query","name":"recycling","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"posts","x-mcp-tool":"list-posts","x-zernio":["GET /v1/posts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createPost","summary":"Create a post","tags":["Posts"],"description":"Create a draft, schedule it (scheduled_at + timezone), take the next queue slot (queue / queue_id) or publish now (publish_now). Targets: account_ids, targets (per-account overrides), profile_id or group_id (filtered by platforms). Network options go in platform_options.<network> (see GET /posts/platform-options). With workspace approvals on, members create posts in pending_approval.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"content":{"type":"string","maxLength":63206},"title":{"type":["string","null"],"maxLength":300},"account_ids":{"type":"array","maxItems":200,"items":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"profile_id":{"type":["string","null"],"maxLength":80},"group_id":{"type":"string","maxLength":80},"platforms":{"type":"array","maxItems":30,"items":{"type":"string","minLength":1,"maxLength":40,"description":"Platform (facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, discord, mastodon; aliases twitter, googlebusiness, meta)"}},"targets":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["account_id"],"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"content":{"type":"string","maxLength":63206},"media_ids":{"type":"array","maxItems":35,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"media_urls":{"type":"array","maxItems":35,"items":{},"description":"Public HTTPS URLs or { url, alt_text?, type? }"},"media":{"type":"array","maxItems":35,"items":{"type":"object","additionalProperties":false,"properties":{"media_id":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"url":{"type":"string","maxLength":2048},"alt_text":{"type":"string","maxLength":2000},"type":{"type":"string","enum":["image","video","gif","document"]}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":"string","maxLength":10000},"scheduled_at":{"type":"string","maxLength":40}}}},"media_ids":{"type":"array","maxItems":35,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"media_urls":{"type":"array","maxItems":35,"items":{},"description":"Public HTTPS URLs or { url, alt_text?, type? }"},"media":{"type":"array","maxItems":35,"items":{"type":"object","additionalProperties":false,"properties":{"media_id":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"url":{"type":"string","maxLength":2048},"alt_text":{"type":"string","maxLength":2000},"type":{"type":"string","enum":["image","video","gif","document"]}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["string","null"],"maxLength":10000},"thread_items":{"type":"array","maxItems":25,"items":{"type":"object","additionalProperties":false,"required":["content"],"properties":{"content":{"type":"string","maxLength":63206},"media_ids":{"type":"array","maxItems":10,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}}}}},"quote_post_id":{"type":["string","null"],"maxLength":80},"quote_url":{"type":["string","null"],"maxLength":2048},"reply_to_url":{"type":["string","null"],"maxLength":2048},"scheduled_at":{"type":["string","null"],"maxLength":40,"description":"ISO 8601; without offset = wall clock in `timezone`"},"timezone":{"type":["string","null"],"maxLength":64},"publish_now":{"type":"boolean"},"queue":{"type":"boolean"},"queue_id":{"type":["string","null"],"maxLength":80},"draft":{"type":"boolean"},"tags":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":100}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["object","null"],"additionalProperties":false,"required":["enabled"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":"integer","minimum":1,"maximum":365},"interval_unit":{"type":"string","enum":["day","week","month"]},"start_at":{"type":"string","format":"date-time"},"max_count":{"type":["integer","null"],"minimum":1,"maximum":1000},"expires_at":{"type":["string","null"],"format":"date-time"},"content_variations":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":63206}}}},"note":{"type":"string","maxLength":5000}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"posts","x-mcp-tool":"create-post","x-idempotent":true,"x-zernio":["POST /v1/posts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/posts/platform-options":{"get":{"operationId":"getPostPlatformOptions","summary":"Publish option schemas per network","tags":["Posts"],"description":"JSON schema of `platform_options.<network>` for every network, from each network adapter.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"posts","x-mcp-tool":"get-post-platform-options","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["platform_options_schemas"]},"data":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/bulk-upload":{"post":{"operationId":"bulkUploadPosts","summary":"Bulk create posts from CSV","tags":["Posts"],"description":"multipart/form-data `file` (CSV, ≤ 5,000 rows, ≤ 10 MB) or JSON { csv }. `?dry_run=true` validates only. Columns: accounts, profile, platforms, content, title, media_urls, scheduled_at, timezone, publish_now, queue, queue_id, draft, first_comment, tags, content_<platform>, media_urls_<platform>, scheduled_at_<platform> (Zernio aliases accepted).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":["object","null"],"properties":{"csv":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"boolean","default":false},"in":"query","name":"dry_run","required":false},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"posts","x-mcp-tool":"bulk-upload-posts","x-idempotent":true,"x-rate-limit":{"max":20,"timeWindow":"1 minute"},"x-zernio":["POST /v1/posts/bulk-upload"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["bulk_upload"]},"dry_run":{"type":"boolean"},"total":{"type":"integer"},"valid":{"type":"integer"},"invalid":{"type":"integer"},"created":{"type":"integer"},"warnings":{"type":"array","items":{"type":"string"}},"results":{"type":"array","items":{"type":"object","properties":{"row":{"type":"integer"},"valid":{"type":"boolean"},"post_id":{"type":["null","string"]},"status":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}}}}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["bulk_upload"]},"dry_run":{"type":"boolean"},"total":{"type":"integer"},"valid":{"type":"integer"},"invalid":{"type":"integer"},"created":{"type":"integer"},"warnings":{"type":"array","items":{"type":"string"}},"results":{"type":"array","items":{"type":"object","properties":{"row":{"type":"integer"},"valid":{"type":"boolean"},"post_id":{"type":["null","string"]},"status":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}":{"get":{"operationId":"getPost","summary":"Get a post","tags":["Posts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"posts","x-mcp-tool":"get-post","x-zernio":["GET /v1/posts/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updatePost","summary":"Update a post","tags":["Posts"],"description":"Drafts, pending, scheduled, failed, partially published and cancelled posts. Published posts only accept recycle, tags, metadata and title. Targets/media sent replace the current ones.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"content":{"type":"string","maxLength":63206},"title":{"type":["string","null"],"maxLength":300},"account_ids":{"type":"array","maxItems":200,"items":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"profile_id":{"type":["string","null"],"maxLength":80},"group_id":{"type":"string","maxLength":80},"platforms":{"type":"array","maxItems":30,"items":{"type":"string","minLength":1,"maxLength":40,"description":"Platform (facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, discord, mastodon; aliases twitter, googlebusiness, meta)"}},"targets":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["account_id"],"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"content":{"type":"string","maxLength":63206},"media_ids":{"type":"array","maxItems":35,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"media_urls":{"type":"array","maxItems":35,"items":{},"description":"Public HTTPS URLs or { url, alt_text?, type? }"},"media":{"type":"array","maxItems":35,"items":{"type":"object","additionalProperties":false,"properties":{"media_id":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"url":{"type":"string","maxLength":2048},"alt_text":{"type":"string","maxLength":2000},"type":{"type":"string","enum":["image","video","gif","document"]}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":"string","maxLength":10000},"scheduled_at":{"type":"string","maxLength":40}}}},"media_ids":{"type":"array","maxItems":35,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"media_urls":{"type":"array","maxItems":35,"items":{},"description":"Public HTTPS URLs or { url, alt_text?, type? }"},"media":{"type":"array","maxItems":35,"items":{"type":"object","additionalProperties":false,"properties":{"media_id":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"url":{"type":"string","maxLength":2048},"alt_text":{"type":"string","maxLength":2000},"type":{"type":"string","enum":["image","video","gif","document"]}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["string","null"],"maxLength":10000},"thread_items":{"type":"array","maxItems":25,"items":{"type":"object","additionalProperties":false,"required":["content"],"properties":{"content":{"type":"string","maxLength":63206},"media_ids":{"type":"array","maxItems":10,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}}}}},"quote_post_id":{"type":["string","null"],"maxLength":80},"quote_url":{"type":["string","null"],"maxLength":2048},"reply_to_url":{"type":["string","null"],"maxLength":2048},"scheduled_at":{"type":["string","null"],"maxLength":40,"description":"ISO 8601; without offset = wall clock in `timezone`"},"timezone":{"type":["string","null"],"maxLength":64},"publish_now":{"type":"boolean"},"queue":{"type":"boolean"},"queue_id":{"type":["string","null"],"maxLength":80},"draft":{"type":"boolean"},"tags":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":100}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["object","null"],"additionalProperties":false,"required":["enabled"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":"integer","minimum":1,"maximum":365},"interval_unit":{"type":"string","enum":["day","week","month"]},"start_at":{"type":"string","format":"date-time"},"max_count":{"type":["integer","null"],"minimum":1,"maximum":1000},"expires_at":{"type":["string","null"],"format":"date-time"},"content_variations":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":63206}}}},"note":{"type":"string","maxLength":5000},"schedule":{"type":"boolean","description":"Schedule a draft at scheduled_at"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"posts","x-mcp-tool":"update-post","x-zernio":["PUT /v1/posts/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deletePost","summary":"Delete a post","tags":["Posts"],"description":"`delete_on_network=true` also deletes the published copies on the networks (failures are returned as warnings).","parameters":[{"schema":{"type":"boolean","default":false},"in":"query","name":"delete_on_network","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"posts","x-mcp-tool":"delete-post","x-zernio":["DELETE /v1/posts/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/schedule":{"post":{"operationId":"schedulePost","summary":"Schedule, queue or publish a draft","tags":["Posts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"scheduled_at":{"type":["string","null"],"maxLength":40,"description":"ISO 8601; without offset = wall clock in `timezone`"},"timezone":{"type":["string","null"],"maxLength":64},"publish_now":{"type":"boolean"},"queue":{"type":"boolean"},"queue_id":{"type":["string","null"],"maxLength":80}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"posts","x-mcp-tool":"schedule-post","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/cancel":{"post":{"operationId":"cancelPost","summary":"Cancel a scheduled post","tags":["Posts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"posts","x-mcp-tool":"cancel-post","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/retry":{"post":{"operationId":"retryPost","summary":"Retry failed postings","tags":["Posts"],"description":"Re-publish the failed postings of a failed or partially published post (optionally only `account_ids`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":["object","null"],"additionalProperties":false,"properties":{"account_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"posts","x-mcp-tool":"retry-post","x-idempotent":true,"x-zernio":["POST /v1/posts/{postId}/retry"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/unpublish":{"post":{"operationId":"unpublishPost","summary":"Delete a published post on the networks","tags":["Posts"],"description":"Delete the live post on one account (account_id / platform) or every published account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":["object","null"],"additionalProperties":false,"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Platform (facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, discord, mastodon; aliases twitter, googlebusiness, meta)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"posts","x-mcp-tool":"unpublish-post","x-idempotent":true,"x-zernio":["POST /v1/posts/{postId}/unpublish"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/edit":{"post":{"operationId":"editPublishedPost","summary":"Edit a published post on the network","tags":["Posts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["content"],"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Platform (facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, discord, mastodon; aliases twitter, googlebusiness, meta)"},"content":{"type":"string","minLength":1,"maxLength":63206},"media_ids":{"type":"array","maxItems":35,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"posts","x-mcp-tool":"edit-published-post","x-idempotent":true,"x-zernio":["POST /v1/posts/{postId}/edit"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/update-metadata":{"post":{"operationId":"updatePostMetadata","summary":"Update video metadata (YouTube)","tags":["Posts"],"description":"Title, description, tags, category, privacy, scheduled publish time, thumbnail and playlist of a YouTube video published by this post (or any `video_id` of the account).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Platform (facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, discord, mastodon; aliases twitter, googlebusiness, meta)"},"video_id":{"type":"string","maxLength":64},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"tags":{"type":"array","maxItems":500,"items":{"type":"string","maxLength":100}},"category_id":{"type":"string","maxLength":10},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":"string","format":"date-time"},"thumbnail_url":{"type":"string","maxLength":2048},"made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"playlist_id":{"type":"string","maxLength":64},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"default_language":{"type":"string","maxLength":20}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"posts","x-mcp-tool":"update-post-metadata","x-idempotent":true,"x-zernio":["POST /v1/posts/{postId}/update-metadata"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/duplicate":{"post":{"operationId":"duplicatePost","summary":"Duplicate a post","tags":["Posts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":["object","null"],"additionalProperties":false,"properties":{"scheduled_at":{"type":"string","maxLength":40},"account_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"posts","x-mcp-tool":"duplicate-post","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/approve":{"post":{"operationId":"approvePost","summary":"Approve a pending post","tags":["Posts"],"description":"Owners, admins and the approvers in publishing settings. Runs the requested action (schedule, publish now or queue).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":["object","null"],"additionalProperties":false,"properties":{"comment":{"type":"string","maxLength":5000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"posts","x-mcp-tool":"approve-post","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/reject":{"post":{"operationId":"rejectPost","summary":"Reject a pending post","tags":["Posts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":["object","null"],"additionalProperties":false,"properties":{"comment":{"type":"string","maxLength":5000},"reason":{"type":"string","maxLength":500}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"posts","x-mcp-tool":"reject-post","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post"]},"id":{"type":"string"},"status":{"type":"string","enum":["draft","pending_approval","scheduled","publishing","published","partially_published","failed","cancelled"]},"content":{"type":"string"},"title":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"position":{"type":"integer"}}}},"postings":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"thread_items":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"}}}}},"quote_post_id":{"type":["null","string"]},"quote_url":{"type":["null","string"]},"reply_to_url":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"timezone":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"queue_id":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["null","object"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":["null","integer"]},"interval_unit":{"type":["null","string"]},"start_at":{"type":["null","string"]},"max_count":{"type":["null","integer"]},"expires_at":{"type":["null","string"]},"content_variations":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"next_at":{"type":["null","string"],"format":"date-time"},"last_at":{"type":["null","string"],"format":"date-time"}}},"recycled_from_post_id":{"type":["null","string"]},"approval":{"type":["null","object"],"properties":{"status":{"type":"string","enum":["pending","approved","rejected"]},"requested_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"requested_at":{"type":["null","string"]},"decided_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"decided_at":{"type":["null","string"]},"comment":{"type":["null","string"]},"requested_action":{"type":["null","string"]}}},"error":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"notes_count":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/notes":{"get":{"operationId":"listPostNotes","summary":"List internal notes of a post","tags":["Posts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"posts","x-mcp-tool":"list-post-notes","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["post_note"]},"id":{"type":"string"},"post_id":{"type":"string"},"kind":{"type":"string","enum":["note","approval","rejection","system"]},"body":{"type":"string"},"author":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createPostNote","summary":"Add an internal note to a post","tags":["Posts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["body"],"properties":{"body":{"type":"string","minLength":1,"maxLength":5000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"posts","x-mcp-tool":"create-post-note","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_note"]},"id":{"type":"string"},"post_id":{"type":"string"},"kind":{"type":"string","enum":["note","approval","rejection","system"]},"body":{"type":"string"},"author":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/posts/{id}/notes/{noteId}":{"patch":{"operationId":"updatePostNote","summary":"Edit a post note","tags":["Posts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["body"],"properties":{"body":{"type":"string","minLength":1,"maxLength":5000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pnt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"noteId","required":true,"description":"postNote id (pnt_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"posts","x-mcp-tool":"update-post-note","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_note"]},"id":{"type":"string"},"post_id":{"type":"string"},"kind":{"type":"string","enum":["note","approval","rejection","system"]},"body":{"type":"string"},"author":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deletePostNote","summary":"Delete a post note","tags":["Posts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pst_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"post id (pst_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"pnt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"noteId","required":true,"description":"postNote id (pnt_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"posts","x-mcp-tool":"delete-post-note","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_note"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/postings":{"get":{"operationId":"listPostings","summary":"List postings","tags":["Posts"],"description":"One row per post × account with its publish status, network id, URL and error.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","published_at","updated_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"posts","x-mcp-tool":"list-postings","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/postings/{id}":{"get":{"operationId":"getPosting","summary":"Get a posting","tags":["Posts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"socialPosting id (sp_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"posts","x-mcp-tool":"get-posting","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["posting"]},"id":{"type":"string"},"post_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account_name":{"type":["null","string"]},"account_username":{"type":["null","string"]},"account_avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["pending","processing","published","failed","cancelled"]},"content":{"type":["null","string"]},"media_ids":{"type":["null","array"],"items":{"type":"string"}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"external_id":{"type":["null","string"]},"url":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"error_category":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}},"result":{"type":"object","additionalProperties":true},"credits_charged":{"type":["null","integer"]},"attempts":{"type":"integer"},"unpublished_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/publishing/settings":{"get":{"operationId":"getPublishingSettings","summary":"Get publishing settings","tags":["Posts"],"description":"Approval workflow settings and the plan publishing limits.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"posts","x-mcp-tool":"get-publishing-settings","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["publishing_settings"]},"require_approval":{"type":"boolean"},"approver_ids":{"type":"array","items":{"type":"string"}},"default_timezone":{"type":["null","string"]},"posts_per_account_per_day":{"type":["null","integer"]},"posts_per_month":{"type":["null","integer"]},"posts_this_month":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updatePublishingSettings","summary":"Update publishing settings","tags":["Posts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"require_approval":{"type":"boolean"},"approver_ids":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":80,"description":"user id (usr_…)","examples":["usr_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"default_timezone":{"type":["string","null"],"maxLength":64}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"posts","x-mcp-tool":"update-publishing-settings","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["publishing_settings"]},"require_approval":{"type":"boolean"},"approver_ids":{"type":"array","items":{"type":"string"}},"default_timezone":{"type":["null","string"]},"posts_per_account_per_day":{"type":["null","integer"]},"posts_per_month":{"type":["null","integer"]},"posts_this_month":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/queues":{"get":{"operationId":"listQueues","summary":"List queues","tags":["Queues"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"boolean"},"in":"query","name":"standalone","required":false},{"schema":{"type":"boolean"},"in":"query","name":"active","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"queues","x-mcp-tool":"list-queues","x-zernio":["GET /v1/queue/slots"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["queue"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"timezone":{"type":"string"},"active":{"type":"boolean"},"default":{"type":"boolean"},"slots":{"type":"array","items":{"type":"object","properties":{"day_of_week":{"type":"integer"},"time":{"type":"string"}}}},"next_slots":{"type":"array","items":{"type":"string"}},"posts_count":{"type":"integer"},"reshuffled_count":{"type":"integer"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createQueue","summary":"Create a queue","tags":["Queues"],"description":"The first queue of a profile (or of the standalone bucket) becomes its default.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"profile_id":{"type":["string","null"],"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":100},"timezone":{"type":"string","maxLength":64},"slots":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["day_of_week","time"],"properties":{"day_of_week":{"type":"integer","minimum":0,"maximum":6},"time":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"active":{"type":"boolean"},"default":{"type":"boolean"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"queues","x-mcp-tool":"create-queue","x-idempotent":true,"x-zernio":["POST /v1/queue/slots"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["queue"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"timezone":{"type":"string"},"active":{"type":"boolean"},"default":{"type":"boolean"},"slots":{"type":"array","items":{"type":"object","properties":{"day_of_week":{"type":"integer"},"time":{"type":"string"}}}},"next_slots":{"type":"array","items":{"type":"string"}},"posts_count":{"type":"integer"},"reshuffled_count":{"type":"integer"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/queues/preview":{"get":{"operationId":"previewQueue","summary":"Preview upcoming free slots","tags":["Queues"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"queue_id","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"count","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"queues","x-mcp-tool":"preview-queue","x-zernio":["GET /v1/queue/preview"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["queue_preview"]},"queue_id":{"type":"string"},"profile_id":{"type":["null","string"]},"timezone":{"type":"string"},"slots":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/queues/next-slot":{"get":{"operationId":"getNextQueueSlot","summary":"Get the next free slot","tags":["Queues"],"description":"Informational: to book a slot create the post with `queue: true` (slot assignment is atomic there).","parameters":[{"schema":{"type":"string"},"in":"query","name":"queue_id","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"queues","x-mcp-tool":"get-next-queue-slot","x-zernio":["GET /v1/queue/next-slot"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["queue_slot"]},"queue_id":{"type":"string"},"profile_id":{"type":["null","string"]},"timezone":{"type":"string"},"slot":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/queues/{id}":{"get":{"operationId":"getQueue","summary":"Get a queue","tags":["Queues"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"que_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"queue id (que_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"queues","x-mcp-tool":"get-queue","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["queue"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"timezone":{"type":"string"},"active":{"type":"boolean"},"default":{"type":"boolean"},"slots":{"type":"array","items":{"type":"object","properties":{"day_of_week":{"type":"integer"},"time":{"type":"string"}}}},"next_slots":{"type":"array","items":{"type":"string"}},"posts_count":{"type":"integer"},"reshuffled_count":{"type":"integer"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateQueue","summary":"Update a queue","tags":["Queues"],"description":"Rename, change timezone or slots, (de)activate, set as default; `reshuffle_existing` moves already-queued posts onto the new slots.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"timezone":{"type":"string","maxLength":64},"slots":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["day_of_week","time"],"properties":{"day_of_week":{"type":"integer","minimum":0,"maximum":6},"time":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}}}},"active":{"type":"boolean"},"default":{"type":"boolean"},"set_as_default":{"type":"boolean","description":"Zernio alias of default"},"reshuffle_existing":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"que_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"queue id (que_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"queues","x-mcp-tool":"update-queue","x-zernio":["PUT /v1/queue/slots"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["queue"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"timezone":{"type":"string"},"active":{"type":"boolean"},"default":{"type":"boolean"},"slots":{"type":"array","items":{"type":"object","properties":{"day_of_week":{"type":"integer"},"time":{"type":"string"}}}},"next_slots":{"type":"array","items":{"type":"string"}},"posts_count":{"type":"integer"},"reshuffled_count":{"type":"integer"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteQueue","summary":"Delete a queue","tags":["Queues"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"que_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"queue id (que_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"queues","x-mcp-tool":"delete-queue","x-zernio":["DELETE /v1/queue/slots"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["queue"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/media/presign":{"post":{"operationId":"presignMediaUpload","summary":"Get an upload URL","tags":["Media"],"description":"Returns a URL to PUT the file to (S3/R2 bucket when configured, else the API). Reference the returned media id (or public_url) in posts.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["filename","content_type"],"properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_type":{"type":"string","minLength":3,"maxLength":100},"size":{"type":"integer","minimum":0},"folder":{"type":"string","maxLength":200},"tags":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":100}},"alt_text":{"type":"string","maxLength":2000}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"media","x-mcp-tool":"presign-media-upload","x-idempotent":true,"x-zernio":["POST /v1/media/presign"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["media_upload"]},"media":{"type":"object","properties":{"object":{"type":"string","enum":["media"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","processing","ready","failed"]},"type":{"type":"string"},"name":{"type":["null","string"]},"file_name":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"caption":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"folder":{"type":["null","string"]},"storage":{"type":"string","enum":["local","s3","external"]},"source_url":{"type":["null","string"]},"used_in_posts":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}},"upload_url":{"type":"string"},"method":{"type":"string","enum":["PUT"]},"headers":{"type":"object","additionalProperties":{"type":"string"}},"public_url":{"type":["null","string"]},"expires_in":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/media/upload-direct":{"post":{"operationId":"uploadMediaDirect","summary":"Upload a file","tags":["Media"],"description":"multipart/form-data with a `file` field (+ optional folder, alt_text, tags). Image ≤ 20 MB, GIF ≤ 15 MB, video ≤ 500 MB, document/audio ≤ 100 MB.","security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"media","x-mcp-tool":null,"x-idempotent":true,"x-zernio":["POST /v1/media/upload-direct"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["media"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","processing","ready","failed"]},"type":{"type":"string"},"name":{"type":["null","string"]},"file_name":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"caption":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"folder":{"type":["null","string"]},"storage":{"type":"string","enum":["local","s3","external"]},"source_url":{"type":["null","string"]},"used_in_posts":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/media":{"post":{"operationId":"createMediaFromUrl","summary":"Register media from a public URL","tags":["Media"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","minLength":8,"maxLength":2048},"name":{"type":"string","maxLength":255},"type":{"type":"string","enum":["image","video","gif","document","audio"]},"alt_text":{"type":"string","maxLength":2000},"caption":{"type":"string","maxLength":5000},"tags":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":100}},"folder":{"type":"string","maxLength":200}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"media","x-mcp-tool":"create-media-from-url","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["media"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","processing","ready","failed"]},"type":{"type":"string"},"name":{"type":["null","string"]},"file_name":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"caption":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"folder":{"type":["null","string"]},"storage":{"type":"string","enum":["local","s3","external"]},"source_url":{"type":["null","string"]},"used_in_posts":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listMediaLibrary","summary":"List the media library","tags":["Media"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","size","name"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","enum":["image","video","gif","document","audio"]},"in":"query","name":"type","required":false},{"schema":{"type":"string","enum":["pending","processing","ready","failed"]},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"folder","required":false},{"schema":{"type":"string"},"in":"query","name":"tag","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"search","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"media","x-mcp-tool":"list-media-library","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["media"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","processing","ready","failed"]},"type":{"type":"string"},"name":{"type":["null","string"]},"file_name":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"caption":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"folder":{"type":["null","string"]},"storage":{"type":"string","enum":["local","s3","external"]},"source_url":{"type":["null","string"]},"used_in_posts":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/media/usage":{"get":{"operationId":"getMediaUsage","summary":"Media storage usage","tags":["Media"],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"media","x-mcp-tool":"get-media-usage","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["media_usage"]},"used_bytes":{"type":"integer"},"limit_bytes":{"type":["null","integer"]},"files":{"type":"integer"},"by_type":{"type":"object","additionalProperties":{"type":"integer"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/media/folders":{"get":{"operationId":"listMediaFolders","summary":"List media folders","tags":["Media"],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"media","x-mcp-tool":"list-media-folders","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["media_folder"]},"name":{"type":"string"},"count":{"type":"integer"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/media/{id}":{"get":{"operationId":"getMediaItem","summary":"Get media","tags":["Media"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"media id (med_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"media","x-mcp-tool":"get-media-item","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["media"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","processing","ready","failed"]},"type":{"type":"string"},"name":{"type":["null","string"]},"file_name":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"caption":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"folder":{"type":["null","string"]},"storage":{"type":"string","enum":["local","s3","external"]},"source_url":{"type":["null","string"]},"used_in_posts":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateMediaItem","summary":"Update media","tags":["Media"],"description":"Name, alt text, caption, tags and folder.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":255},"alt_text":{"type":["string","null"],"maxLength":2000},"caption":{"type":["string","null"],"maxLength":5000},"tags":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":100}},"folder":{"type":["string","null"],"maxLength":200}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"media id (med_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"media","x-mcp-tool":"update-media-item","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["media"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","processing","ready","failed"]},"type":{"type":"string"},"name":{"type":["null","string"]},"file_name":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"caption":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"folder":{"type":["null","string"]},"storage":{"type":"string","enum":["local","s3","external"]},"source_url":{"type":["null","string"]},"used_in_posts":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteMediaItem","summary":"Delete media","tags":["Media"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"media id (med_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"media","x-mcp-tool":"delete-media-item","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["media"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/media/{id}/complete":{"post":{"operationId":"completeMediaUpload","summary":"Finalize a presigned upload","tags":["Media"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"media id (med_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"media","x-mcp-tool":"complete-media-upload","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["media"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","processing","ready","failed"]},"type":{"type":"string"},"name":{"type":["null","string"]},"file_name":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"preview_url":{"type":["null","string"]},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration":{"type":["null","integer"]},"alt_text":{"type":["null","string"]},"caption":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"folder":{"type":["null","string"]},"storage":{"type":"string","enum":["local","s3","external"]},"source_url":{"type":["null","string"]},"used_in_posts":{"type":"integer"},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/templates":{"get":{"operationId":"listTemplates","summary":"List templates","tags":["Templates"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name","updated_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","maxLength":200},"in":"query","name":"search","required":false},{"schema":{"type":"string"},"in":"query","name":"tag","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"templates","x-mcp-tool":"list-templates","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["template"]},"id":{"type":"string"},"name":{"type":"string"},"alias":{"type":["null","string"]},"content":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"position":{"type":"integer"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createTemplate","summary":"Create a template","tags":["Templates"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","content"],"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"alias":{"type":["string","null"],"maxLength":100},"content":{"type":"string","maxLength":63206},"media_ids":{"type":"array","maxItems":35,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["string","null"],"maxLength":10000},"tags":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":100}}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"templates","x-mcp-tool":"create-template","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["template"]},"id":{"type":"string"},"name":{"type":"string"},"alias":{"type":["null","string"]},"content":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"position":{"type":"integer"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/templates/{id}":{"get":{"operationId":"getTemplate","summary":"Get a template","tags":["Templates"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"tem_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"template id (tem_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"templates","x-mcp-tool":"get-template","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["template"]},"id":{"type":"string"},"name":{"type":"string"},"alias":{"type":["null","string"]},"content":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"position":{"type":"integer"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateTemplate","summary":"Update a template","tags":["Templates"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"alias":{"type":["string","null"],"maxLength":100},"content":{"type":"string","maxLength":63206},"media_ids":{"type":"array","maxItems":35,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["string","null"],"maxLength":10000},"tags":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":100}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"tem_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"template id (tem_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"templates","x-mcp-tool":"update-template","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["template"]},"id":{"type":"string"},"name":{"type":"string"},"alias":{"type":["null","string"]},"content":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"type":{"type":"string"},"url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"position":{"type":"integer"}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteTemplate","summary":"Delete a template","tags":["Templates"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"tem_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"template id (tem_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"templates","x-mcp-tool":"delete-template","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["template"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/tools/validate/post-length":{"post":{"operationId":"validatePostLength","summary":"Character counts per network","tags":["Tools"],"description":"Weighted counts (X: URLs = 23, emoji/CJK = 2; `x_premium` = 25,000).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","maxLength":100000},"platforms":{"type":"array","items":{"type":"string","minLength":1,"maxLength":40,"description":"Platform (facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, discord, mastodon; aliases twitter, googlebusiness, meta)"}}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"tools","x-mcp-tool":"validate-post-length","x-zernio":["POST /v1/tools/validate/post-length"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_length"]},"text_length":{"type":"integer"},"platforms":{"type":"object","additionalProperties":{"type":"object","properties":{"length":{"type":"integer"},"limit":{"type":"integer"},"remaining":{"type":"integer"},"valid":{"type":"boolean"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/tools/validate/post":{"post":{"operationId":"validatePost","summary":"Validate a post for its target networks","tags":["Tools"],"description":"Same body as POST /posts; nothing is created. Runs shared limits, each network validator and platform_options schemas.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"content":{"type":"string","maxLength":63206},"title":{"type":["string","null"],"maxLength":300},"account_ids":{"type":"array","maxItems":200,"items":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"profile_id":{"type":["string","null"],"maxLength":80},"group_id":{"type":"string","maxLength":80},"platforms":{"type":"array","maxItems":30,"items":{"type":"string","minLength":1,"maxLength":40,"description":"Platform (facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, discord, mastodon; aliases twitter, googlebusiness, meta)"}},"targets":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["account_id"],"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"socialAccount id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"content":{"type":"string","maxLength":63206},"media_ids":{"type":"array","maxItems":35,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"media_urls":{"type":"array","maxItems":35,"items":{},"description":"Public HTTPS URLs or { url, alt_text?, type? }"},"media":{"type":"array","maxItems":35,"items":{"type":"object","additionalProperties":false,"properties":{"media_id":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"url":{"type":"string","maxLength":2048},"alt_text":{"type":"string","maxLength":2000},"type":{"type":"string","enum":["image","video","gif","document"]}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":"string","maxLength":10000},"scheduled_at":{"type":"string","maxLength":40}}}},"media_ids":{"type":"array","maxItems":35,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"media_urls":{"type":"array","maxItems":35,"items":{},"description":"Public HTTPS URLs or { url, alt_text?, type? }"},"media":{"type":"array","maxItems":35,"items":{"type":"object","additionalProperties":false,"properties":{"media_id":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"url":{"type":"string","maxLength":2048},"alt_text":{"type":"string","maxLength":2000},"type":{"type":"string","enum":["image","video","gif","document"]}}}},"platform_options":{"type":"object","additionalProperties":true},"first_comment":{"type":["string","null"],"maxLength":10000},"thread_items":{"type":"array","maxItems":25,"items":{"type":"object","additionalProperties":false,"required":["content"],"properties":{"content":{"type":"string","maxLength":63206},"media_ids":{"type":"array","maxItems":10,"items":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}}}}},"quote_post_id":{"type":["string","null"],"maxLength":80},"quote_url":{"type":["string","null"],"maxLength":2048},"reply_to_url":{"type":["string","null"],"maxLength":2048},"scheduled_at":{"type":["string","null"],"maxLength":40,"description":"ISO 8601; without offset = wall clock in `timezone`"},"timezone":{"type":["string","null"],"maxLength":64},"publish_now":{"type":"boolean"},"queue":{"type":"boolean"},"queue_id":{"type":["string","null"],"maxLength":80},"draft":{"type":"boolean"},"tags":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":100}},"metadata":{"type":"object","additionalProperties":true},"strict":{"type":"boolean"},"recycle":{"type":["object","null"],"additionalProperties":false,"required":["enabled"],"properties":{"enabled":{"type":"boolean"},"interval":{"type":"integer","minimum":1,"maximum":365},"interval_unit":{"type":"string","enum":["day","week","month"]},"start_at":{"type":"string","format":"date-time"},"max_count":{"type":["integer","null"],"minimum":1,"maximum":1000},"expires_at":{"type":["string","null"],"format":"date-time"},"content_variations":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":63206}}}},"note":{"type":"string","maxLength":5000}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"tools","x-mcp-tool":"validate-post","x-zernio":["POST /v1/tools/validate/post"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_validation"]},"valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"code":{"type":"string"},"message":{"type":"string"},"param":{"type":["null","string"]}}}},"warnings":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"code":{"type":"string"},"message":{"type":"string"},"param":{"type":["null","string"]}}}},"targets":{"type":"array","items":{"type":"object","properties":{"account_id":{"type":["null","string"]},"platform":{"type":"string"},"valid":{"type":"boolean"},"length":{"type":["null","integer"]},"limit":{"type":["null","integer"]},"errors":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/tools/validate/media":{"post":{"operationId":"validateMediaUrl","summary":"Validate a media URL or library item","tags":["Tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":2048},"media_id":{"type":"string","minLength":1,"maxLength":80,"description":"media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"platforms":{"type":"array","items":{"type":"string","minLength":1,"maxLength":40,"description":"Platform (facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, discord, mastodon; aliases twitter, googlebusiness, meta)"}}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"tools","x-mcp-tool":"validate-media-url","x-zernio":["POST /v1/tools/validate/media"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["media_validation"]},"valid":{"type":"boolean"},"url":{"type":["null","string"]},"content_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"size_formatted":{"type":["null","string"]},"type":{"type":["null","string"]},"platforms":{"type":"object","additionalProperties":{"type":"object","properties":{"valid":{"type":"boolean"},"max_bytes":{"type":["null","integer"]},"errors":{"type":"array","items":{"type":"string"}}}}},"errors":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/tools/validate/subreddit":{"get":{"operationId":"validateSubreddit","summary":"Check a subreddit","tags":["Tools"],"description":"Existence, posting restrictions, rules and post requirements, through a connected Reddit account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":100},"in":"query","name":"name","required":true},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"tools","x-mcp-tool":"validate-subreddit","x-zernio":["GET /v1/tools/validate/subreddit"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["subreddit_validation"]},"name":{"type":"string"},"exists":{"type":"boolean"},"valid":{"type":"boolean"},"subreddit":{"type":["null","object"],"additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/tools/tiktok/download":{"get":{"operationId":"downloadTikTokVideo","summary":"TikTok video metadata","tags":["Tools"],"description":"Metadata and embed only: TikTok's official APIs don't allow downloading videos (`download_url` is always null).","parameters":[{"schema":{"type":"string","minLength":10,"maxLength":2048},"in":"query","name":"url","required":true},{"schema":{"type":"string","enum":["download","metadata"]},"in":"query","name":"action","required":false},{"schema":{"type":"string"},"in":"query","name":"format_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"tools","x-mcp-tool":"download-tik-tok-video","x-zernio":["GET /v1/tools/tiktok/download"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tiktok_video"]},"url":{"type":"string"},"video_id":{"type":["null","string"]},"author":{"type":["null","string"]},"title":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"embed_html":{"type":["null","string"]},"download_url":{"type":["null","string"]},"unavailable_reason":{"type":["null","string"]},"formats":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/feedback":{"post":{"operationId":"submitFeedback","summary":"Send feedback to the Socialit team","tags":["Tools"],"description":"Bugs, missing features and docs issues; built for AI agents too.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["type","summary"],"properties":{"type":{"type":"string","enum":["bug","missing_feature","docs","other"]},"summary":{"type":"string","minLength":3,"maxLength":500},"details":{"type":"string","maxLength":10000},"endpoint":{"type":"string","maxLength":300},"request_id":{"type":"string","maxLength":100},"expected":{"type":"string","maxLength":5000},"actual":{"type":"string","maxLength":5000},"agent":{"type":"string","maxLength":100}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"create","x-toolset":"tools","x-mcp-tool":"submit-feedback","x-idempotent":true,"x-rate-limit":{"max":20,"timeWindow":"1 hour"},"x-zernio":["POST /v1/feedback"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["feedback"]},"id":{"type":"string"},"type":{"type":"string"},"summary":{"type":"string"},"details":{"type":["null","string"]},"endpoint":{"type":["null","string"]},"request_id":{"type":["null","string"]},"expected":{"type":["null","string"]},"actual":{"type":["null","string"]},"agent":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/changelog":{"get":{"operationId":"listChangelog","summary":"API changelog","tags":["Tools"],"parameters":[{"schema":{"type":"string","enum":["new_feature","improvement","breaking_change","deprecation","fix"]},"in":"query","name":"type","required":false},{"schema":{"type":"string","enum":["low","medium","high"]},"in":"query","name":"impact","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false},{"schema":{"type":"string","maxLength":30},"in":"query","name":"before","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"tools","x-mcp-tool":"list-changelog","x-zernio":["GET /v1/changelog"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["changelog_entry"]},"id":{"type":"string"},"date":{"type":"string"},"type":{"type":"string"},"impact":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"platforms":{"type":"array","items":{"type":"string"}},"operations":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations":{"get":{"operationId":"listConversations","summary":"List conversations","tags":["Inbox"],"description":"Direct-message conversations of every connected account the caller can see, newest activity first. Filter by profile, account, platform, status, folder (message requests), assignee, label or unread.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["last_message_at","created_at","unread_count"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Only items of this profile (pro_…)"},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false,"description":"Only items of this account (sa_…)"},{"schema":{"type":"string","enum":["facebook","instagram","x","linkedin","threads","bluesky","pinterest","tiktok","youtube","google_business","reddit","snapchat","discord","mastodon","sms","rcs","imessage","twitter","googlebusiness","meta"]},"in":"query","name":"platform","required":false},{"schema":{"type":"string","enum":["open","active","archived","snoozed"]},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["inbox","requests"]},"in":"query","name":"folder","required":false},{"schema":{"type":"string"},"in":"query","name":"assignee_id","required":false,"description":"usr_… or \"none\" for unassigned"},{"schema":{"type":"string"},"in":"query","name":"label","required":false},{"schema":{"type":"boolean"},"in":"query","name":"unread","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"q","required":false,"description":"Participant name / username contains"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"list-conversations","x-zernio":["GET /v1/inbox/conversations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["conversation"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"participant":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"is_group":{"type":"boolean"},"folder":{"type":"string","enum":["inbox","requests"]},"status":{"type":"string","enum":["open","archived","snoozed"]},"snoozed_until":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"thread_owner":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"last_message_preview":{"type":["null","string"]},"last_message_direction":{"type":["null","string"],"enum":["inbound","outbound",null]},"last_message_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"]},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createConversation","summary":"Start a conversation","tags":["Inbox"],"description":"Open a direct-message thread with a user (X, Bluesky, Reddit, Discord, Mastodon). If a thread with that participant exists, the message is added to it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["account_id"],"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"Account id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"participant_id":{"type":"string","minLength":1,"maxLength":300},"participant_username":{"type":"string","minLength":1,"maxLength":300},"text":{"type":"string","minLength":1,"maxLength":20000},"media_ids":{"type":"array","maxItems":10,"items":{"type":"string","minLength":1,"maxLength":80,"description":"Media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"attachment_url":{"type":"string","format":"uri"},"attachment_type":{"type":"string","enum":["image","video","audio","file"]},"skip_dm_check":{"type":"boolean"},"template":{"type":"object","additionalProperties":true,"required":["name"],"properties":{"name":{"type":"string","minLength":1},"language":{"type":"string"},"params":{"type":"array","items":{"type":"string"}},"button_params":{"type":"array","items":{"type":"object","additionalProperties":true}},"cards":{"type":"array","items":{"type":"object","additionalProperties":true}},"header_media":{"type":"object","additionalProperties":true},"header_location":{"type":"object","additionalProperties":true}}},"category":{"type":"string","enum":["utility","marketing","authentication"]},"link_preview":{"type":"boolean"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"inbox","x-mcp-tool":"create-conversation","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversation"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"participant":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"is_group":{"type":"boolean"},"folder":{"type":"string","enum":["inbox","requests"]},"status":{"type":"string","enum":["open","archived","snoozed"]},"snoozed_until":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"thread_owner":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"last_message_preview":{"type":["null","string"]},"last_message_direction":{"type":["null","string"],"enum":["inbound","outbound",null]},"last_message_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"]},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"sent_message":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["message"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["string","null"]},"platform":{"type":["string","null"]},"external_id":{"type":["string","null"]},"direction":{"type":"string","enum":["inbound","outbound"]},"text":{"type":["string","null"]},"sender":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"username":{"type":["string","null"]},"avatar_url":{"type":["string","null"]},"verified_type":{"type":["string","null"]}}},"attachments":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"type":{"type":"string"},"url":{"type":["string","null"]},"mime_type":{"type":["string","null"]},"filename":{"type":["string","null"]},"size":{"type":["integer","null"]},"preview_url":{"type":["string","null"]},"media_id":{"type":["string","null"]},"refresh_url":{"type":["string","null"]}}}},"status":{"type":"string"},"error":{"type":["object","null"],"properties":{"code":{"type":["string","null"]},"message":{"type":["string","null"]}}},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"from_me":{"type":"boolean"},"sender_id":{"type":["string","null"]},"reacted_at":{"type":["string","null"],"format":"date-time"}}}},"reply_to_id":{"type":["string","null"]},"reply_to_external_id":{"type":["string","null"]},"is_edited":{"type":"boolean"},"edited_at":{"type":["string","null"],"format":"date-time"},"edit_count":{"type":"integer"},"edit_history":{"type":"array","items":{"type":"object","properties":{"text":{"type":["string","null"]},"edited_at":{"type":["string","null"],"format":"date-time"}}}},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["string","null"],"format":"date-time"},"sent_via":{"type":["string","null"]},"sent_by_user_id":{"type":["string","null"]},"sent_at":{"type":["string","null"],"format":"date-time"},"delivered_at":{"type":["string","null"],"format":"date-time"},"read_at":{"type":["string","null"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"}}},{"type":"null"}]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/inbox/conversations/search":{"get":{"operationId":"searchConversations","summary":"Search conversations","tags":["Inbox"],"description":"Search message text and participant identity (name, username, id). Each result carries up to 3 matching messages, most recent match first.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Only items of this profile (pro_…)"},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false,"description":"Only items of this account (sa_…)"},{"schema":{"type":"string","enum":["facebook","instagram","x","linkedin","threads","bluesky","pinterest","tiktok","youtube","google_business","reddit","snapchat","discord","mastodon","sms","rcs","imessage","twitter","googlebusiness","meta"]},"in":"query","name":"platform","required":false},{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"query","name":"q","required":false,"description":"Text to search in messages and participant identity"},{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"query","name":"query","required":false,"description":"Alias of q (Zernio)"},{"schema":{"type":"string","enum":["inbound","outbound","incoming","outgoing"]},"in":"query","name":"direction","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"search-conversations","x-zernio":["GET /v1/inbox/conversations/search"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["conversation_search_result"]},"conversation":{"type":"object","properties":{"object":{"type":"string","enum":["conversation"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"participant":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"is_group":{"type":"boolean"},"folder":{"type":"string","enum":["inbox","requests"]},"status":{"type":"string","enum":["open","archived","snoozed"]},"snoozed_until":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"thread_owner":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"last_message_preview":{"type":["null","string"]},"last_message_direction":{"type":["null","string"],"enum":["inbound","outbound",null]},"last_message_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"]},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}},"match_count":{"type":"integer"},"matches":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":["null","string"]},"direction":{"type":"string","enum":["inbound","outbound"]},"sent_at":{"type":["null","string"],"format":"date-time"}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations/{conversationId}":{"get":{"operationId":"getConversation","summary":"Get a conversation","tags":["Inbox"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"Conversation id (conv_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-conversation","x-zernio":["GET /v1/inbox/conversations/{conversationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversation"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"participant":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"is_group":{"type":"boolean"},"folder":{"type":"string","enum":["inbox","requests"]},"status":{"type":"string","enum":["open","archived","snoozed"]},"snoozed_until":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"thread_owner":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"last_message_preview":{"type":["null","string"]},"last_message_direction":{"type":["null","string"],"enum":["inbound","outbound",null]},"last_message_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"]},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateConversation","summary":"Update a conversation","tags":["Inbox"],"description":"Archive, reopen or snooze a conversation, assign it to a workspace member, set labels or link a contact.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"status":{"type":"string","enum":["open","active","archived","snoozed"]},"snoozed_until":{"type":["string","null"],"format":"date-time"},"assignee_id":{"type":["string","null"]},"labels":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":50}},"contact_id":{"type":["string","null"]},"account_id":{"type":"string","description":"Ignored (Zernio compatibility)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"Conversation id (conv_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"inbox","x-mcp-tool":"update-conversation","x-zernio":["PUT /v1/inbox/conversations/{conversationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversation"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"participant":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"is_group":{"type":"boolean"},"folder":{"type":"string","enum":["inbox","requests"]},"status":{"type":"string","enum":["open","archived","snoozed"]},"snoozed_until":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"thread_owner":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"last_message_preview":{"type":["null","string"]},"last_message_direction":{"type":["null","string"],"enum":["inbound","outbound",null]},"last_message_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"]},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations/{conversationId}/accept":{"post":{"operationId":"acceptConversation","summary":"Accept a message request","tags":["Inbox"],"description":"Accept a Facebook / Instagram (or Bluesky) message request by replying to it; the thread moves to the inbox folder.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":20000},"account_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"Conversation id (conv_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"inbox","x-mcp-tool":"accept-conversation","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/accept"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["message"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"external_id":{"type":["null","string"]},"direction":{"type":"string","enum":["inbound","outbound"]},"text":{"type":["null","string"]},"sender":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"attachments":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"type":{"type":"string"},"url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"filename":{"type":["null","string"]},"size":{"type":["null","integer"]},"preview_url":{"type":["null","string"]},"media_id":{"type":["null","string"]},"refresh_url":{"type":["null","string"]}}}},"status":{"type":"string"},"error":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"message":{"type":["null","string"]}}},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"from_me":{"type":"boolean"},"sender_id":{"type":["null","string"]},"reacted_at":{"type":["null","string"],"format":"date-time"}}}},"reply_to_id":{"type":["null","string"]},"reply_to_external_id":{"type":["null","string"]},"is_edited":{"type":"boolean"},"edited_at":{"type":["null","string"],"format":"date-time"},"edit_count":{"type":"integer"},"edit_history":{"type":"array","items":{"type":"object","properties":{"text":{"type":["null","string"]},"edited_at":{"type":["null","string"],"format":"date-time"}}}},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"sent_via":{"type":["null","string"]},"sent_by_user_id":{"type":["null","string"]},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"read_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations/{conversationId}/read":{"post":{"operationId":"markConversationRead","summary":"Mark a conversation as read","tags":["Inbox"],"description":"Marks every unread inbound message as read and sends read receipts where the network supports them (Messenger, Instagram, Bluesky, TikTok, Reddit, Mastodon).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"Conversation id (conv_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"mark-conversation-read","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/read"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversation"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"participant":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"is_group":{"type":"boolean"},"folder":{"type":"string","enum":["inbox","requests"]},"status":{"type":"string","enum":["open","archived","snoozed"]},"snoozed_until":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"thread_owner":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"last_message_preview":{"type":["null","string"]},"last_message_direction":{"type":["null","string"],"enum":["inbound","outbound",null]},"last_message_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"]},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations/{conversationId}/unread":{"post":{"operationId":"markConversationUnread","summary":"Mark a conversation as unread","tags":["Inbox"],"description":"Flags the conversation unread in Socialit (no network call).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"Conversation id (conv_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"mark-conversation-unread","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversation"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"participant":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"is_group":{"type":"boolean"},"folder":{"type":"string","enum":["inbox","requests"]},"status":{"type":"string","enum":["open","archived","snoozed"]},"snoozed_until":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"thread_owner":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"last_message_preview":{"type":["null","string"]},"last_message_direction":{"type":["null","string"],"enum":["inbound","outbound",null]},"last_message_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"]},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations/{conversationId}/typing":{"post":{"operationId":"sendTypingIndicator","summary":"Send a typing indicator","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"Conversation id (conv_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"send-typing-indicator","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/typing"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["typing_indicator"]},"conversation_id":{"type":"string"},"sent":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations/{conversationId}/thread-control":{"post":{"operationId":"changeThreadControl","summary":"Change who answers a conversation","tags":["Inbox"],"description":"Meta's handover protocol: take, pass, release or request thread control.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["action"],"properties":{"action":{"type":"string","enum":["release","take","pass","request"]},"target":{"type":"string","enum":["ai_agent"]},"target_app_id":{"type":"string","maxLength":100},"metadata":{"type":"string","maxLength":1000},"account_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"Conversation id (conv_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"change-thread-control","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/thread-control"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["thread_control"]},"conversation_id":{"type":"string"},"owner":{"type":["null","string"]},"owner_app_id":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations/{conversationId}/messages":{"get":{"operationId":"listMessages","summary":"List messages","tags":["Inbox"],"description":"Messages of a conversation, oldest first by default (`order=desc` for the latest). `refresh=true` pulls the newest messages from the network first.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["sent_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","enum":["inbound","outbound"]},"in":"query","name":"direction","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"refresh","required":false,"description":"Pull the latest messages from the network first"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"Conversation id (conv_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"list-messages","x-zernio":["GET /v1/inbox/conversations/{conversationId}/messages"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["message"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"external_id":{"type":["null","string"]},"direction":{"type":"string","enum":["inbound","outbound"]},"text":{"type":["null","string"]},"sender":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"attachments":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"type":{"type":"string"},"url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"filename":{"type":["null","string"]},"size":{"type":["null","integer"]},"preview_url":{"type":["null","string"]},"media_id":{"type":["null","string"]},"refresh_url":{"type":["null","string"]}}}},"status":{"type":"string"},"error":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"message":{"type":["null","string"]}}},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"from_me":{"type":"boolean"},"sender_id":{"type":["null","string"]},"reacted_at":{"type":["null","string"],"format":"date-time"}}}},"reply_to_id":{"type":["null","string"]},"reply_to_external_id":{"type":["null","string"]},"is_edited":{"type":"boolean"},"edited_at":{"type":["null","string"],"format":"date-time"},"edit_count":{"type":"integer"},"edit_history":{"type":"array","items":{"type":"object","properties":{"text":{"type":["null","string"]},"edited_at":{"type":["null","string"],"format":"date-time"}}}},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"sent_via":{"type":["null","string"]},"sent_by_user_id":{"type":["null","string"]},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"read_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"sendMessage","summary":"Send a message","tags":["Inbox"],"description":"Send text, media (`media_ids` from the media library or a public `attachment_url`), quick replies, buttons, templates, interactive messages, locations or contacts. Support varies by network.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"text":{"type":"string","minLength":1,"maxLength":20000},"media_ids":{"type":"array","maxItems":10,"items":{"type":"string","minLength":1,"maxLength":80,"description":"Media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"attachment_url":{"type":"string","format":"uri"},"attachment_type":{"type":"string","enum":["image","video","audio","file"]},"attachment_name":{"type":"string","maxLength":255},"quick_replies":{"type":"array","maxItems":13,"items":{"type":"object","additionalProperties":false,"required":["title","payload"],"properties":{"title":{"type":"string","minLength":1,"maxLength":20},"payload":{"type":"string","maxLength":1000},"image_url":{"type":"string"}}}},"buttons":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":false,"required":["type","title"],"properties":{"type":{"type":"string","enum":["url","postback","phone"]},"title":{"type":"string","minLength":1,"maxLength":20},"url":{"type":"string"},"payload":{"type":"string"},"phone":{"type":"string"}}}},"template":{"type":"object","additionalProperties":true},"messaging_type":{"type":"string","enum":["RESPONSE","UPDATE","MESSAGE_TAG"]},"message_tag":{"type":"string","enum":["CONFIRMED_EVENT_UPDATE","POST_PURCHASE_UPDATE","ACCOUNT_UPDATE","HUMAN_AGENT"]},"reply_to":{"type":"string","maxLength":300},"subject":{"type":"string","maxLength":300},"account_id":{"type":"string","description":"Ignored (Zernio compatibility)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"Conversation id (conv_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"inbox","x-mcp-tool":"send-message","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/messages"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["message"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"external_id":{"type":["null","string"]},"direction":{"type":"string","enum":["inbound","outbound"]},"text":{"type":["null","string"]},"sender":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"attachments":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"type":{"type":"string"},"url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"filename":{"type":["null","string"]},"size":{"type":["null","integer"]},"preview_url":{"type":["null","string"]},"media_id":{"type":["null","string"]},"refresh_url":{"type":["null","string"]}}}},"status":{"type":"string"},"error":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"message":{"type":["null","string"]}}},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"from_me":{"type":"boolean"},"sender_id":{"type":["null","string"]},"reacted_at":{"type":["null","string"],"format":"date-time"}}}},"reply_to_id":{"type":["null","string"]},"reply_to_external_id":{"type":["null","string"]},"is_edited":{"type":"boolean"},"edited_at":{"type":["null","string"],"format":"date-time"},"edit_count":{"type":"integer"},"edit_history":{"type":"array","items":{"type":"object","properties":{"text":{"type":["null","string"]},"edited_at":{"type":["null","string"],"format":"date-time"}}}},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"sent_via":{"type":["null","string"]},"sent_by_user_id":{"type":["null","string"]},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"read_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations/{conversationId}/messages/{messageId}":{"delete":{"operationId":"deleteMessage","summary":"Delete a message","tags":["Inbox"],"description":"Delete / unsend a message (X, Bluesky for self, Reddit).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"conversation id (conv_…)"},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"messageId","required":true,"description":"Message id (msg_…) or the network message id"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"delete-message","x-zernio":["DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["message"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions":{"post":{"operationId":"addMessageReaction","summary":"React to a message","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["emoji"],"properties":{"emoji":{"type":"string","minLength":1,"maxLength":64},"account_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"conversation id (conv_…)"},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"messageId","required":true,"description":"Message id (msg_…) or the network message id"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"add-message-reaction","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["message"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"external_id":{"type":["null","string"]},"direction":{"type":"string","enum":["inbound","outbound"]},"text":{"type":["null","string"]},"sender":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"attachments":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"type":{"type":"string"},"url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"filename":{"type":["null","string"]},"size":{"type":["null","integer"]},"preview_url":{"type":["null","string"]},"media_id":{"type":["null","string"]},"refresh_url":{"type":["null","string"]}}}},"status":{"type":"string"},"error":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"message":{"type":["null","string"]}}},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"from_me":{"type":"boolean"},"sender_id":{"type":["null","string"]},"reacted_at":{"type":["null","string"],"format":"date-time"}}}},"reply_to_id":{"type":["null","string"]},"reply_to_external_id":{"type":["null","string"]},"is_edited":{"type":"boolean"},"edited_at":{"type":["null","string"],"format":"date-time"},"edit_count":{"type":"integer"},"edit_history":{"type":"array","items":{"type":"object","properties":{"text":{"type":["null","string"]},"edited_at":{"type":["null","string"],"format":"date-time"}}}},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"sent_via":{"type":["null","string"]},"sent_by_user_id":{"type":["null","string"]},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"read_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"removeMessageReaction","summary":"Remove a reaction","tags":["Inbox"],"parameters":[{"schema":{"type":"string","maxLength":64},"in":"query","name":"emoji","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"conversation id (conv_…)"},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"messageId","required":true,"description":"Message id (msg_…) or the network message id"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"remove-message-reaction","x-zernio":["DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["message"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"external_id":{"type":["null","string"]},"direction":{"type":"string","enum":["inbound","outbound"]},"text":{"type":["null","string"]},"sender":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"attachments":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"type":{"type":"string"},"url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"filename":{"type":["null","string"]},"size":{"type":["null","integer"]},"preview_url":{"type":["null","string"]},"media_id":{"type":["null","string"]},"refresh_url":{"type":["null","string"]}}}},"status":{"type":"string"},"error":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"message":{"type":["null","string"]}}},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"from_me":{"type":"boolean"},"sender_id":{"type":["null","string"]},"reacted_at":{"type":["null","string"],"format":"date-time"}}}},"reply_to_id":{"type":["null","string"]},"reply_to_external_id":{"type":["null","string"]},"is_edited":{"type":"boolean"},"edited_at":{"type":["null","string"],"format":"date-time"},"edit_count":{"type":"integer"},"edit_history":{"type":"array","items":{"type":"object","properties":{"text":{"type":["null","string"]},"edited_at":{"type":["null","string"],"format":"date-time"}}}},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"sent_via":{"type":["null","string"]},"sent_by_user_id":{"type":["null","string"]},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"read_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/conversations/{conversationId}/messages/{messageId}/attachments/{index}":{"get":{"operationId":"getMessageAttachment","summary":"Resolve a message attachment","tags":["Inbox"],"description":"A media URL that works now: re-mints expired Instagram / Messenger URLs, downloads X DM media. `format=redirect` (default) answers 302; `format=json` returns the URL.","parameters":[{"schema":{"type":"string","enum":["redirect","json"],"default":"redirect"},"in":"query","name":"format","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"conversationId","required":true,"description":"conversation id (conv_…)"},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"messageId","required":true,"description":"Message id"},{"schema":{"type":"integer","minimum":0,"maximum":50},"in":"path","name":"index","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-message-attachment","x-zernio":["GET /v1/inbox/conversations/{conversationId}/messages/{messageId}/attachments/{index}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["message_attachment"]},"message_id":{"type":"string"},"index":{"type":"integer"},"type":{"type":"string"},"url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"refreshed":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/posts":{"get":{"operationId":"listInboxPosts","summary":"List posts with comments","tags":["Inbox"],"description":"Posts of every connected account with their comment counters, most recent comment first.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["last_comment_at","published_at","comment_count"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Only items of this profile (pro_…)"},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false,"description":"Only items of this account (sa_…)"},{"schema":{"type":"string","enum":["facebook","instagram","x","linkedin","threads","bluesky","pinterest","tiktok","youtube","google_business","reddit","snapchat","discord","mastodon","sms","rcs","imessage","twitter","googlebusiness","meta","metaads"]},"in":"query","name":"platform","required":false},{"schema":{"type":"integer","minimum":0},"in":"query","name":"min_comments","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"boolean"},"in":"query","name":"unread","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"list-inbox-posts","x-zernio":["GET /v1/inbox/comments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["inbox_post"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"post_id":{"type":["null","string"]},"content":{"type":["null","string"]},"picture_url":{"type":["null","string"]},"permalink":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"comment_count":{"type":"integer"},"unread_comment_count":{"type":"integer"},"like_count":{"type":"integer"},"last_comment_at":{"type":["null","string"],"format":"date-time"},"cid":{"type":["null","string"]},"subreddit":{"type":["null","string"]},"is_ad":{"type":"boolean"},"ad_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/posts/{postId}":{"get":{"operationId":"getInboxPost","summary":"Get a commented post","tags":["Inbox"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"postId","required":true,"description":"Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-inbox-post","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["inbox_post"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"post_id":{"type":["null","string"]},"content":{"type":["null","string"]},"picture_url":{"type":["null","string"]},"permalink":{"type":["null","string"]},"published_at":{"type":["null","string"],"format":"date-time"},"comment_count":{"type":"integer"},"unread_comment_count":{"type":"integer"},"like_count":{"type":"integer"},"last_comment_at":{"type":["null","string"],"format":"date-time"},"cid":{"type":["null","string"]},"subreddit":{"type":["null","string"]},"is_ad":{"type":"boolean"},"ad_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/posts/{postId}/comments":{"get":{"operationId":"listPostComments","summary":"List a post's comments","tags":["Inbox"],"description":"Comments of one post, fetched from the network (default) and stored. `comment_id` lists that comment's replies.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["commented_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"comment_id","required":false,"description":"Only replies of this comment (cmt_… or network id)"},{"schema":{"type":"string"},"in":"query","name":"subreddit","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"refresh","required":false,"description":"Fetch from the network first (default true)"},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"postId","required":true,"description":"Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"list-post-comments","x-zernio":["GET /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createComment","summary":"Comment on a post or reply to a comment","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"account_id":{"type":"string"},"text":{"type":"string","minLength":1,"maxLength":10000},"comment_id":{"type":"string","description":"Reply to this comment (cmt_… or network id)"},"attachment_url":{"type":"string","format":"uri"},"media_ids":{"type":"array","maxItems":10,"items":{"type":"string","minLength":1,"maxLength":80,"description":"Media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"parent_cid":{"type":"string"},"root_uri":{"type":"string"},"root_cid":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"postId","required":true,"description":"Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"inbox","x-mcp-tool":"create-comment","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/posts/{postId}/like":{"post":{"operationId":"likePost","summary":"Like a post","tags":["Inbox"],"description":"Like (or react to) a post as any connected account, including posts of other accounts (LinkedIn, X, Facebook, YouTube, Bluesky, Instagram).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["account_id"],"properties":{"account_id":{"type":"string","minLength":1,"maxLength":80,"description":"Account id (sa_…)","examples":["sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]},"reaction_type":{"type":"string","enum":["LIKE","PRAISE","EMPATHY","INTEREST","APPRECIATION","ENTERTAINMENT"]},"cid":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"postId","required":true,"description":"Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"like-post","x-idempotent":true,"x-zernio":["POST /v1/inbox/posts/{postId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_like"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"account_id":{"type":"string"},"liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"already_reacted":{"type":"boolean"},"reaction_type":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"unlikePost","summary":"Unlike a post","tags":["Inbox"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"query","name":"account_id","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string"},"in":"query","name":"like_uri","required":false},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"postId","required":true,"description":"Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"unlike-post","x-zernio":["DELETE /v1/inbox/posts/{postId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["post_like"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"account_id":{"type":"string"},"liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"already_reacted":{"type":"boolean"},"reaction_type":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/comments":{"get":{"operationId":"listComments","summary":"List comments","tags":["Inbox"],"description":"Comment feed across every post (triage view): filter by read state, status, hidden, assignee, label, author.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["commented_at","like_count"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Only items of this profile (pro_…)"},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false,"description":"Only items of this account (sa_…)"},{"schema":{"type":"string","enum":["facebook","instagram","x","linkedin","threads","bluesky","pinterest","tiktok","youtube","google_business","reddit","snapchat","discord","mastodon","sms","rcs","imessage","twitter","googlebusiness","meta"]},"in":"query","name":"platform","required":false},{"schema":{"type":"string"},"in":"query","name":"inbox_post_id","required":false},{"schema":{"type":"string","enum":["open","archived"]},"in":"query","name":"status","required":false},{"schema":{"type":"boolean"},"in":"query","name":"read","required":false},{"schema":{"type":"boolean"},"in":"query","name":"hidden","required":false},{"schema":{"type":"string"},"in":"query","name":"assignee_id","required":false},{"schema":{"type":"string"},"in":"query","name":"label","required":false},{"schema":{"type":"boolean"},"in":"query","name":"is_owner","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"list-comments","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/comments/{commentId}":{"get":{"operationId":"getComment","summary":"Get a comment","tags":["Inbox"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"like_uri","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-comment","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateComment","summary":"Edit or triage a comment","tags":["Inbox"],"description":"`text` edits the comment on the network (Reddit, and own comments on Facebook / YouTube / LinkedIn); `read`, `status`, `assignee_id`, `labels` are Socialit triage fields.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"text":{"type":"string","minLength":1,"maxLength":10000},"content":{"type":"string","minLength":1,"maxLength":10000},"read":{"type":"boolean"},"status":{"type":"string","enum":["open","archived"]},"assignee_id":{"type":["string","null"]},"labels":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":50}},"account_id":{"type":"string"},"platform":{"type":"string","description":"Ignored (Zernio compatibility)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"inbox","x-mcp-tool":"update-comment","x-zernio":["PATCH /v1/inbox/comments/{postId}/{commentId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteComment","summary":"Delete a comment","tags":["Inbox"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"like_uri","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"delete-comment","x-zernio":["DELETE /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/comments/{commentId}/replies":{"post":{"operationId":"replyToComment","summary":"Reply to a comment","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":10000},"attachment_url":{"type":"string","format":"uri"},"media_ids":{"type":"array","maxItems":10,"items":{"type":"string","minLength":1,"maxLength":80,"description":"Media id (med_…)","examples":["med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"]}},"account_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"inbox","x-mcp-tool":"reply-to-comment","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/comments/{commentId}/moderation":{"post":{"operationId":"setCommentModeration","summary":"Set comment moderation status","tags":["Inbox"],"description":"YouTube: publish, reject or hold a comment for review, optionally banning the author.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["moderation_status"],"properties":{"moderation_status":{"type":"string","enum":["published","rejected","held_for_review","heldForReview"]},"ban_author":{"type":"boolean"},"account_id":{"type":"string"},"platform":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"set-comment-moderation","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}/{commentId}/moderation"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/comments/{commentId}/hide":{"post":{"operationId":"hideComment","summary":"Hide a comment","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string"},"post_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"hide-comment","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}/{commentId}/hide"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"unhideComment","summary":"Unhide a comment","tags":["Inbox"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"like_uri","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"unhide-comment","x-zernio":["DELETE /v1/inbox/comments/{postId}/{commentId}/hide"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/comments/{commentId}/pin":{"post":{"operationId":"pinComment","summary":"Pin a comment","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string"},"post_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"pin-comment","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}/{commentId}/pin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"unpinComment","summary":"Unpin a comment","tags":["Inbox"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"like_uri","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"unpin-comment","x-zernio":["DELETE /v1/inbox/comments/{postId}/{commentId}/pin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/comments/{commentId}/like":{"post":{"operationId":"likeComment","summary":"Like a comment","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string"},"reaction_type":{"type":"string","enum":["LIKE","PRAISE","EMPATHY","INTEREST","APPRECIATION","ENTERTAINMENT"]},"cid":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"like-comment","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"unlikeComment","summary":"Unlike a comment","tags":["Inbox"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"like_uri","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"unlike-comment","x-zernio":["DELETE /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"inbox_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"external_post_id":{"type":"string"},"external_id":{"type":"string"},"parent_id":{"type":["null","string"]},"external_parent_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]},"is_owner":{"type":"boolean"}}},"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"]}}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_hidden":{"type":"boolean"},"is_pinned":{"type":"boolean"},"is_liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"cid":{"type":["null","string"]},"moderation_status":{"type":["null","string"]},"is_edited":{"type":"boolean"},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"can_reply":{"type":"boolean"},"can_delete":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_like":{"type":"boolean"},"url":{"type":["null","string"]},"commented_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/comments/{commentId}/private-reply":{"post":{"operationId":"sendPrivateReply","summary":"Send a private reply","tags":["Inbox"],"description":"Direct-message the author of a comment (Facebook, Instagram; one reply per comment within 7 days).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":2000},"quick_replies":{"type":"array","maxItems":13,"items":{"type":"object","additionalProperties":false,"required":["title","payload"],"properties":{"title":{"type":"string","minLength":1,"maxLength":20},"payload":{"type":"string","maxLength":1000},"image_url":{"type":"string"}}}},"buttons":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":false,"required":["type","title"],"properties":{"type":{"type":"string","enum":["url","postback","phone"]},"title":{"type":"string","minLength":1,"maxLength":20},"url":{"type":"string"},"payload":{"type":"string"},"phone":{"type":"string"}}}},"account_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"commentId","required":true,"description":"Comment id (cmt_…) or the network comment id (with account_id)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"inbox","x-mcp-tool":"send-private-reply","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}/{commentId}/private-reply"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["message"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"external_id":{"type":["null","string"]},"direction":{"type":"string","enum":["inbound","outbound"]},"text":{"type":["null","string"]},"sender":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"attachments":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"type":{"type":"string"},"url":{"type":["null","string"]},"mime_type":{"type":["null","string"]},"filename":{"type":["null","string"]},"size":{"type":["null","integer"]},"preview_url":{"type":["null","string"]},"media_id":{"type":["null","string"]},"refresh_url":{"type":["null","string"]}}}},"status":{"type":"string"},"error":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"message":{"type":["null","string"]}}},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"from_me":{"type":"boolean"},"sender_id":{"type":["null","string"]},"reacted_at":{"type":["null","string"],"format":"date-time"}}}},"reply_to_id":{"type":["null","string"]},"reply_to_external_id":{"type":["null","string"]},"is_edited":{"type":"boolean"},"edited_at":{"type":["null","string"],"format":"date-time"},"edit_count":{"type":"integer"},"edit_history":{"type":"array","items":{"type":"object","properties":{"text":{"type":["null","string"]},"edited_at":{"type":["null","string"],"format":"date-time"}}}},"is_deleted":{"type":"boolean"},"deleted_at":{"type":["null","string"],"format":"date-time"},"sent_via":{"type":["null","string"]},"sent_by_user_id":{"type":["null","string"]},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"read_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/reviews":{"get":{"operationId":"listReviews","summary":"List reviews","tags":["Inbox"],"description":"Facebook recommendations and Google Business reviews, newest first, with a rating summary.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["reviewed_at","rating"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Only items of this profile (pro_…)"},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false,"description":"Only items of this account (sa_…)"},{"schema":{"type":"string","enum":["facebook","instagram","x","linkedin","threads","bluesky","pinterest","tiktok","youtube","google_business","reddit","snapchat","discord","mastodon","sms","rcs","imessage","twitter","googlebusiness","meta"]},"in":"query","name":"platform","required":false},{"schema":{"type":"integer","minimum":1,"maximum":5},"in":"query","name":"min_rating","required":false},{"schema":{"type":"integer","minimum":1,"maximum":5},"in":"query","name":"max_rating","required":false},{"schema":{"type":"boolean"},"in":"query","name":"has_reply","required":false},{"schema":{"type":"string","enum":["open","archived"]},"in":"query","name":"status","required":false},{"schema":{"type":"boolean"},"in":"query","name":"read","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"refresh","required":false,"description":"Fetch the latest reviews from the networks first"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"list-reviews","x-zernio":["GET /v1/inbox/reviews"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["review"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"location_id":{"type":["null","string"]},"location_name":{"type":["null","string"]},"reviewer":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"rating":{"type":["null","integer"]},"recommendation":{"type":["null","string"]},"text":{"type":["null","string"]},"photos":{"type":"array","items":{"type":"object","properties":{"url":{"type":["null","string"]}}}},"has_reply":{"type":"boolean"},"reply":{"type":["null","object"],"properties":{"external_id":{"type":["null","string"]},"text":{"type":["null","string"]},"replied_at":{"type":["null","string"],"format":"date-time"}}},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"]},"reviewed_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"summary":{"type":"object","properties":{"total_reviews":{"type":"integer"},"average_rating":{"type":["null","number"]}}}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/reviews/{reviewId}":{"get":{"operationId":"getReview","summary":"Get a review","tags":["Inbox"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"reviewId","required":true,"description":"Review id (rev_…) or the network review id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-review","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["review"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"location_id":{"type":["null","string"]},"location_name":{"type":["null","string"]},"reviewer":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"rating":{"type":["null","integer"]},"recommendation":{"type":["null","string"]},"text":{"type":["null","string"]},"photos":{"type":"array","items":{"type":"object","properties":{"url":{"type":["null","string"]}}}},"has_reply":{"type":"boolean"},"reply":{"type":["null","object"],"properties":{"external_id":{"type":["null","string"]},"text":{"type":["null","string"]},"replied_at":{"type":["null","string"],"format":"date-time"}}},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"]},"reviewed_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateReview","summary":"Triage a review","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"read":{"type":"boolean"},"status":{"type":"string","enum":["open","archived"]},"assignee_id":{"type":["string","null"]},"labels":{"type":"array","maxItems":20,"items":{"type":"string","minLength":1,"maxLength":50}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"reviewId","required":true,"description":"Review id (rev_…) or the network review id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"inbox","x-mcp-tool":"update-review","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["review"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"location_id":{"type":["null","string"]},"location_name":{"type":["null","string"]},"reviewer":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"rating":{"type":["null","integer"]},"recommendation":{"type":["null","string"]},"text":{"type":["null","string"]},"photos":{"type":"array","items":{"type":"object","properties":{"url":{"type":["null","string"]}}}},"has_reply":{"type":"boolean"},"reply":{"type":["null","object"],"properties":{"external_id":{"type":["null","string"]},"text":{"type":["null","string"]},"replied_at":{"type":["null","string"],"format":"date-time"}}},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"]},"reviewed_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/reviews/{reviewId}/reply":{"post":{"operationId":"replyToReview","summary":"Reply to a review","tags":["Inbox"],"description":"Post (or replace) the public reply to a review.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":4096},"account_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"reviewId","required":true,"description":"Review id (rev_…) or the network review id (with account_id)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"inbox","x-mcp-tool":"reply-to-review","x-idempotent":true,"x-zernio":["POST /v1/inbox/reviews/{reviewId}/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["review"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"location_id":{"type":["null","string"]},"location_name":{"type":["null","string"]},"reviewer":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"rating":{"type":["null","integer"]},"recommendation":{"type":["null","string"]},"text":{"type":["null","string"]},"photos":{"type":"array","items":{"type":"object","properties":{"url":{"type":["null","string"]}}}},"has_reply":{"type":"boolean"},"reply":{"type":["null","object"],"properties":{"external_id":{"type":["null","string"]},"text":{"type":["null","string"]},"replied_at":{"type":["null","string"],"format":"date-time"}}},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"]},"reviewed_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteReviewReply","summary":"Delete a review reply","tags":["Inbox"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":500},"in":"path","name":"reviewId","required":true,"description":"Review id (rev_…) or the network review id (with account_id)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"delete-review-reply","x-zernio":["DELETE /v1/inbox/reviews/{reviewId}/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["review"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"location_id":{"type":["null","string"]},"location_name":{"type":["null","string"]},"reviewer":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]}}},"rating":{"type":["null","integer"]},"recommendation":{"type":["null","string"]},"text":{"type":["null","string"]},"photos":{"type":"array","items":{"type":"object","properties":{"url":{"type":["null","string"]}}}},"has_reply":{"type":"boolean"},"reply":{"type":["null","object"],"properties":{"external_id":{"type":["null","string"]},"text":{"type":["null","string"]},"replied_at":{"type":["null","string"],"format":"date-time"}}},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"assignee_id":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"]},"reviewed_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/mentions":{"get":{"operationId":"listMentions","summary":"List mentions","tags":["Inbox"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["mentioned_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false,"description":"Only items of this profile (pro_…)"},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false,"description":"Only items of this account (sa_…)"},{"schema":{"type":"string","enum":["facebook","instagram","x","linkedin","threads","bluesky","pinterest","tiktok","youtube","google_business","reddit","snapchat","discord","mastodon","sms","rcs","imessage","twitter","googlebusiness","meta"]},"in":"query","name":"platform","required":false},{"schema":{"type":"string","enum":["post","comment","caption","story","reply","quote","tag"]},"in":"query","name":"kind","required":false},{"schema":{"type":"boolean"},"in":"query","name":"read","required":false},{"schema":{"type":"string","enum":["open","archived"]},"in":"query","name":"status","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"list-mentions","x-zernio":["GET /v1/inbox/mentions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["mention"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"kind":{"type":"string"},"text":{"type":["null","string"]},"permalink":{"type":["null","string"]},"author":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"media_id":{"type":["null","string"]},"comment_id":{"type":["null","string"]},"replied":{"type":"boolean"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"mentioned_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/mentions/{mentionId}":{"get":{"operationId":"getMention","summary":"Get a mention","tags":["Inbox"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"mtn_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"mentionId","required":true,"description":"Mention id (mtn_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-mention","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["mention"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"kind":{"type":"string"},"text":{"type":["null","string"]},"permalink":{"type":["null","string"]},"author":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"media_id":{"type":["null","string"]},"comment_id":{"type":["null","string"]},"replied":{"type":"boolean"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"mentioned_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateMention","summary":"Triage a mention","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"read":{"type":"boolean"},"status":{"type":"string","enum":["open","archived"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"mtn_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"mentionId","required":true,"description":"Mention id (mtn_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"inbox","x-mcp-tool":"update-mention","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["mention"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]}}},"external_id":{"type":"string"},"kind":{"type":"string"},"text":{"type":["null","string"]},"permalink":{"type":["null","string"]},"author":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"media_id":{"type":["null","string"]},"comment_id":{"type":["null","string"]},"replied":{"type":"boolean"},"status":{"type":"string","enum":["open","archived"]},"read":{"type":"boolean"},"mentioned_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/mentions/reply":{"post":{"operationId":"replyToMention","summary":"Reply to a mention","tags":["Inbox"],"description":"Reply to a stored mention (`mention_id`) or to an Instagram media / comment mention (`account_id` + `media_id` [+ `comment_id`]).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":2200},"mention_id":{"type":"string"},"account_id":{"type":"string"},"media_id":{"type":"string"},"comment_id":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"inbox","x-mcp-tool":"reply-to-mention","x-idempotent":true,"x-zernio":["POST /v1/inbox/mentions/reply"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["mention_reply"]},"id":{"type":["null","string"]},"mention_id":{"type":["null","string"]},"account_id":{"type":"string"},"media_id":{"type":["null","string"]},"comment_id":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/inbox/counts":{"get":{"operationId":"getInboxCounts","summary":"Inbox counters","tags":["Inbox"],"description":"Unread / open counters for badges.","parameters":[{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-inbox-counts","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["inbox_counts"]},"conversations":{"type":"object","properties":{"open":{"type":"integer"},"unread":{"type":"integer"},"unassigned":{"type":"integer"},"requests":{"type":"integer"}}},"comments":{"type":"object","properties":{"unread":{"type":"integer"}}},"reviews":{"type":"object","properties":{"unread":{"type":"integer"},"unanswered":{"type":"integer"}}},"mentions":{"type":"object","properties":{"unread":{"type":"integer"}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/inbox/sync":{"post":{"operationId":"syncInbox","summary":"Sync the inbox now","tags":["Inbox"],"description":"Queue an immediate pull from the networks that are polled (Reddit, YouTube, Bluesky, Mastodon, X, Threads, LinkedIn, Google Business, Facebook reviews, TikTok mentions).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["conversations","comments","reviews","mentions"]},"uniqueItems":true}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"inbox","x-mcp-tool":"sync-inbox","x-idempotent":true,"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["inbox_sync"]},"queued":{"type":"integer"},"accounts":{"type":"array","items":{"type":"string"}},"kinds":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/accounts/{accountId}/messenger-menu":{"get":{"operationId":"getMessengerMenu","summary":"Get persistent menu","tags":["Inbox"],"description":"Read the persistent menu of a Facebook or Instagram account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-messenger-menu","x-zernio":["GET /v1/accounts/{accountId}/messenger-menu"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_menu"]},"account_id":{"type":"string"},"persistent_menu":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"setMessengerMenu","summary":"Set persistent menu","tags":["Inbox"],"description":"Replace the persistent menu of a Facebook or Instagram account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["persistent_menu"],"properties":{"persistent_menu":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":true,"required":["call_to_actions"],"properties":{"locale":{"type":"string","default":"default"},"composer_input_disabled":{"type":"boolean"},"call_to_actions":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string","enum":["postback","web_url","nested"]},"title":{"type":"string","minLength":1,"maxLength":30},"payload":{"type":"string","maxLength":1000},"url":{"type":"string","maxLength":2000},"webview_height_ratio":{"type":"string"},"call_to_actions":{"type":"array","maxItems":5,"items":{"type":"object","additionalProperties":true}}}}}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"inbox","x-mcp-tool":"set-messenger-menu","x-zernio":["PUT /v1/accounts/{accountId}/messenger-menu"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_menu"]},"account_id":{"type":"string"},"persistent_menu":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteMessengerMenu","summary":"Delete persistent menu","tags":["Inbox"],"description":"Remove the persistent menu from a Facebook or Instagram account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"delete-messenger-menu","x-zernio":["DELETE /v1/accounts/{accountId}/messenger-menu"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_menu"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/messenger-get-started":{"get":{"operationId":"getMessengerGetStarted","summary":"Get Messenger Get Started button","tags":["Inbox"],"description":"Read the Messenger Get Started button of a Facebook account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-messenger-get-started","x-zernio":["GET /v1/accounts/{accountId}/messenger-get-started"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_get_started"]},"account_id":{"type":"string"},"payload":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"setMessengerGetStarted","summary":"Set Messenger Get Started button","tags":["Inbox"],"description":"Replace the Messenger Get Started button of a Facebook account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"payload":{"type":"string","minLength":1,"maxLength":1000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"inbox","x-mcp-tool":"set-messenger-get-started","x-zernio":["PUT /v1/accounts/{accountId}/messenger-get-started"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_get_started"]},"account_id":{"type":"string"},"payload":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteMessengerGetStarted","summary":"Delete Messenger Get Started button","tags":["Inbox"],"description":"Remove the Messenger Get Started button from a Facebook account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"delete-messenger-get-started","x-zernio":["DELETE /v1/accounts/{accountId}/messenger-get-started"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_get_started"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/messenger-greeting":{"get":{"operationId":"getMessengerGreeting","summary":"Get Messenger greeting text","tags":["Inbox"],"description":"Read the Messenger greeting text of a Facebook account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-messenger-greeting","x-zernio":["GET /v1/accounts/{accountId}/messenger-greeting"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_greeting"]},"account_id":{"type":"string"},"greeting":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"text":{"type":"string"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"setMessengerGreeting","summary":"Set Messenger greeting text","tags":["Inbox"],"description":"Replace the Messenger greeting text of a Facebook account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["greeting"],"properties":{"greeting":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["locale","text"],"properties":{"locale":{"type":"string","minLength":1},"text":{"type":"string","minLength":1,"maxLength":160}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"inbox","x-mcp-tool":"set-messenger-greeting","x-zernio":["PUT /v1/accounts/{accountId}/messenger-greeting"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_greeting"]},"account_id":{"type":"string"},"greeting":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"text":{"type":"string"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteMessengerGreeting","summary":"Delete Messenger greeting text","tags":["Inbox"],"description":"Remove the Messenger greeting text from a Facebook account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"delete-messenger-greeting","x-zernio":["DELETE /v1/accounts/{accountId}/messenger-greeting"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_greeting"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/messenger-ice-breakers":{"get":{"operationId":"getMessengerIceBreakers","summary":"Get Messenger ice breakers","tags":["Inbox"],"description":"Read the Messenger ice breakers of a Facebook account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-messenger-ice-breakers","x-zernio":["GET /v1/accounts/{accountId}/messenger-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_ice_breakers"]},"account_id":{"type":"string"},"ice_breakers":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"payload":{"type":"string"}}}}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"setMessengerIceBreakers","summary":"Set Messenger ice breakers","tags":["Inbox"],"description":"Replace the Messenger ice breakers of a Facebook account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ice_breakers"],"properties":{"ice_breakers":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["locale","call_to_actions"],"properties":{"locale":{"type":"string","minLength":1},"call_to_actions":{"type":"array","minItems":1,"maxItems":4,"items":{"type":"object","additionalProperties":false,"required":["question","payload"],"properties":{"question":{"type":"string","minLength":1,"maxLength":80},"payload":{"type":"string","minLength":1,"maxLength":1000}}}}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"inbox","x-mcp-tool":"set-messenger-ice-breakers","x-zernio":["PUT /v1/accounts/{accountId}/messenger-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_ice_breakers"]},"account_id":{"type":"string"},"ice_breakers":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string"},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"payload":{"type":"string"}}}}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteMessengerIceBreakers","summary":"Delete Messenger ice breakers","tags":["Inbox"],"description":"Remove the Messenger ice breakers from a Facebook account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"delete-messenger-ice-breakers","x-zernio":["DELETE /v1/accounts/{accountId}/messenger-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["messenger_ice_breakers"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram-ice-breakers":{"get":{"operationId":"getInstagramIceBreakers","summary":"Get Instagram ice breakers","tags":["Inbox"],"description":"Read the Instagram ice breakers of a Instagram account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-instagram-ice-breakers","x-zernio":["GET /v1/accounts/{accountId}/instagram-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_ice_breakers"]},"account_id":{"type":"string"},"ice_breakers":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"payload":{"type":"string"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"setInstagramIceBreakers","summary":"Set Instagram ice breakers","tags":["Inbox"],"description":"Replace the Instagram ice breakers of a Instagram account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ice_breakers"],"properties":{"ice_breakers":{"type":"array","minItems":1,"maxItems":4,"items":{"type":"object","additionalProperties":false,"required":["question","payload"],"properties":{"question":{"type":"string","minLength":1,"maxLength":80},"payload":{"type":"string","minLength":1,"maxLength":1000}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"inbox","x-mcp-tool":"set-instagram-ice-breakers","x-zernio":["PUT /v1/accounts/{accountId}/instagram-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_ice_breakers"]},"account_id":{"type":"string"},"ice_breakers":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"payload":{"type":"string"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteInstagramIceBreakers","summary":"Delete Instagram ice breakers","tags":["Inbox"],"description":"Remove the Instagram ice breakers from a Instagram account.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"delete-instagram-ice-breakers","x-zernio":["DELETE /v1/accounts/{accountId}/instagram-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_ice_breakers"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/retweets":{"post":{"operationId":"retweet","summary":"Repost (retweet) a post on X","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tweet_id"],"properties":{"tweet_id":{"type":"string","minLength":1,"maxLength":300}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"inbox","x-mcp-tool":"retweet","x-idempotent":true,"x-rate-limit":{"max":50,"timeWindow":"15 minutes"},"x-zernio":["POST /v1/twitter/retweet"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["x_retweet"]},"account_id":{"type":"string"},"tweet_id":{"type":"string"},"retweeted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/retweets/{tweetId}":{"delete":{"operationId":"unretweet","summary":"Undo a repost on X","tags":["Inbox"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"tweetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"unretweet","x-zernio":["DELETE /v1/twitter/retweet"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["x_retweet"]},"account_id":{"type":"string"},"tweet_id":{"type":"string"},"retweeted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/bookmarks":{"post":{"operationId":"bookmarkTweet","summary":"Bookmark a post on X","tags":["Inbox"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tweet_id"],"properties":{"tweet_id":{"type":"string","minLength":1,"maxLength":300}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"inbox","x-mcp-tool":"bookmark-tweet","x-idempotent":true,"x-rate-limit":{"max":50,"timeWindow":"15 minutes"},"x-zernio":["POST /v1/twitter/bookmark"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["x_bookmark"]},"account_id":{"type":"string"},"tweet_id":{"type":"string"},"bookmarked":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"operationId":"xBookmarksList","summary":"X: List Bookmarks","tags":["Focus · X"],"description":"GET /2/users/:id/bookmarks (or a folder). Your bookmarks, optionally inside a folder: a curation library for reposts and inspiration. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read, bookmark.read. Generic route: `/v1/accounts/{accountId}/focus/bookmarks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"folder_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-bookmarks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/bookmarks/{tweetId}":{"delete":{"operationId":"removeBookmark","summary":"Remove an X bookmark","tags":["Inbox"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"tweetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"remove-bookmark","x-zernio":["DELETE /v1/twitter/bookmark"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["x_bookmark"]},"account_id":{"type":"string"},"tweet_id":{"type":"string"},"bookmarked":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following":{"post":{"operationId":"followXUser","summary":"Follow a user on X","tags":["Inbox"],"description":"Follow (or request to follow a protected account). Requires X Enterprise access: otherwise 402 `enterprise_required`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["target_user_id"],"properties":{"target_user_id":{"type":"string","minLength":1,"maxLength":64}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"inbox","x-mcp-tool":"follow-x-user","x-idempotent":true,"x-rate-limit":{"max":50,"timeWindow":"15 minutes"},"x-zernio":["POST /v1/twitter/follow"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["x_follow"]},"account_id":{"type":"string"},"target_user_id":{"type":"string"},"following":{"type":"boolean"},"pending_follow":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"get":{"operationId":"xFollowingList","summary":"X: List Following","tags":["Focus · X"],"description":"GET /2/users/:id/following. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: follows.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/following`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":1000},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"user_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-following-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following/{targetUserId}":{"delete":{"operationId":"unfollowXUser","summary":"Unfollow a user on X","tags":["Inbox"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"path","name":"targetUserId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"inbox","x-mcp-tool":"unfollow-x-user","x-zernio":["DELETE /v1/twitter/follow"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["x_follow"]},"account_id":{"type":"string"},"target_user_id":{"type":"string"},"following":{"type":"boolean"},"pending_follow":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/search":{"get":{"operationId":"searchTweets","summary":"Search recent posts on X","tags":["Inbox"],"description":"Posts from the last 7 days matching an X search query (operators passed through).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"query","name":"query","required":true},{"schema":{"type":"integer","minimum":10,"maximum":100,"default":10},"in":"query","name":"limit","required":false},{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"query","name":"since_id","required":false},{"schema":{"type":"string","pattern":"^[0-9]+$"},"in":"query","name":"until_id","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start_time","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end_time","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["recency","relevancy"]},"in":"query","name":"sort_order","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"search-tweets","x-zernio":["GET /v1/twitter/search"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tweet"]},"id":{"type":"string"},"text":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"conversation_id":{"type":["null","string"]},"in_reply_to_tweet_id":{"type":["null","string"]},"lang":{"type":["null","string"]},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"retweet_count":{"type":"integer"},"quote_count":{"type":"integer"},"url":{"type":["null","string"]}}}},"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"previous_cursor":{"type":["null","string"]},"meta":{"type":"object","properties":{"result_count":{"type":"integer"},"newest_id":{"type":["null","string"]},"oldest_id":{"type":["null","string"]}}}},"required":["object","data","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/tweets/{tweetId}":{"get":{"operationId":"getTweet","summary":"Look up a post on X","tags":["Inbox"],"description":"`tweetId` is the numeric id or a URL-encoded post URL.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"tweetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-tweet","x-zernio":["GET /v1/twitter/tweet"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tweet"]},"id":{"type":"string"},"text":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"conversation_id":{"type":["null","string"]},"in_reply_to_tweet_id":{"type":["null","string"]},"lang":{"type":["null","string"]},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"verified_type":{"type":["null","string"]}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"retweet_count":{"type":"integer"},"quote_count":{"type":"integer"},"url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search":{"get":{"operationId":"searchReddit","summary":"Search Reddit posts","tags":["Inbox"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"query","name":"q","required":true},{"schema":{"type":"string","maxLength":100},"in":"query","name":"subreddit","required":false},{"schema":{"type":"boolean"},"in":"query","name":"restrict_sr","required":false},{"schema":{"type":"string","enum":["relevance","hot","top","new","comments"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"]},"in":"query","name":"t","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"search-reddit","x-zernio":["GET /v1/reddit/search"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["reddit_post"]},"id":{"type":"string"},"fullname":{"type":["null","string"]},"title":{"type":["null","string"]},"author":{"type":["null","string"]},"subreddit":{"type":["null","string"]},"url":{"type":["null","string"]},"permalink":{"type":["null","string"]},"selftext":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"num_comments":{"type":"integer"},"over_18":{"type":"boolean"},"stickied":{"type":"boolean"},"flair_text":{"type":["null","string"]},"is_gallery":{"type":"boolean"},"gallery_images":{"type":"array","items":{"type":"string"}}}}},"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"previous_cursor":{"type":["null","string"]}},"required":["object","data","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed":{"get":{"operationId":"getRedditFeed","summary":"Get a subreddit feed","tags":["Inbox"],"parameters":[{"schema":{"type":"string","maxLength":100},"in":"query","name":"subreddit","required":false},{"schema":{"type":"string","enum":["hot","new","top","rising"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"]},"in":"query","name":"t","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-reddit-feed","x-zernio":["GET /v1/reddit/feed"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["reddit_post"]},"id":{"type":"string"},"fullname":{"type":["null","string"]},"title":{"type":["null","string"]},"author":{"type":["null","string"]},"subreddit":{"type":["null","string"]},"url":{"type":["null","string"]},"permalink":{"type":["null","string"]},"selftext":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"num_comments":{"type":"integer"},"over_18":{"type":"boolean"},"stickied":{"type":"boolean"},"flair_text":{"type":["null","string"]},"is_gallery":{"type":"boolean"},"gallery_images":{"type":"array","items":{"type":"string"}}}}},"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"previous_cursor":{"type":["null","string"]}},"required":["object","data","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/posts/{postId}/comments":{"get":{"operationId":"getRedditPostComments","summary":"Get a Reddit post's comments","tags":["Inbox"],"parameters":[{"schema":{"type":"string","enum":["new","top","best","controversial","old","qa"]},"in":"query","name":"sort","required":false},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":64},"in":"query","name":"comment_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"path","name":"postId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"inbox","x-mcp-tool":"get-reddit-post-comments","x-zernio":["GET /v1/reddit/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["reddit_comment_thread"]},"post":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["reddit_post"]},"id":{"type":"string"},"fullname":{"type":["string","null"]},"title":{"type":["string","null"]},"author":{"type":["string","null"]},"subreddit":{"type":["string","null"]},"url":{"type":["string","null"]},"permalink":{"type":["string","null"]},"selftext":{"type":["string","null"]},"created_at":{"type":["string","null"],"format":"date-time"},"score":{"type":"integer"},"num_comments":{"type":"integer"},"over_18":{"type":"boolean"},"stickied":{"type":"boolean"},"flair_text":{"type":["string","null"]},"is_gallery":{"type":"boolean"},"gallery_images":{"type":"array","items":{"type":"string"}}}},{"type":"null"}]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["reddit_comment"]},"id":{"type":"string"},"fullname":{"type":["null","string"]},"parent_id":{"type":["null","string"]},"author":{"type":["null","string"]},"body":{"type":["null","string"]},"permalink":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"num_replies":{"type":"integer"},"depth":{"type":"integer"},"is_submitter":{"type":"boolean"},"edited":{"type":"boolean"},"stickied":{"type":"boolean"},"distinguished":{"type":["null","string"]}}}},"more":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/contacts":{"get":{"operationId":"listContacts","summary":"List contacts","tags":["Contacts"],"description":"Filter with `profile_id`, `account_id` (has a channel on that account), `platform`, `search` (name, email, company), `tag`, `tags` (comma-separated, any of), `is_subscribed`, `is_blocked`, and custom fields: `custom_fields.<slug>.<condition>=value` (conditions follow the field type; `match=or` applies).","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","updated_at","name","last_message_received_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false},{"schema":{"type":"string","maxLength":200},"in":"query","name":"search","required":false},{"schema":{"type":"string"},"in":"query","name":"tag","required":false},{"schema":{"type":"string"},"in":"query","name":"tags","required":false},{"schema":{"type":"string"},"in":"query","name":"is_subscribed","required":false},{"schema":{"type":"string"},"in":"query","name":"is_blocked","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"contacts","x-mcp-tool":"list-contacts","x-zernio":["GET /v1/contacts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["contact"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"email":{"type":["null","string"]},"company":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"is_blocked":{"type":"boolean"},"notes":{"type":["null","string"]},"custom_fields":{"type":"object","additionalProperties":true},"channels":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"contact_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_identifier":{"type":"string"},"display_identifier":{"type":["null","string"]},"is_subscribed":{"type":"boolean"},"conversation_id":{"type":["null","string"]},"last_active_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"messaging_window_open":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"conversation_ids":{"type":"array","items":{"type":"string"}},"messages_sent_count":{"type":"integer"},"messages_received_count":{"type":"integer"},"last_message_sent_at":{"type":["null","string"],"format":"date-time"},"last_message_received_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createContact","summary":"Create a contact","tags":["Contacts"],"description":"Optionally links a channel (`account_id` + `platform_identifier`). Phone identifiers are normalized to E.164. 409 `contact_channel_exists` when the identity already belongs to a contact.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"profile_id":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":200},"email":{"type":["string","null"],"maxLength":320},"company":{"type":["string","null"],"maxLength":200},"avatar_url":{"type":["string","null"],"maxLength":2048},"tags":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"is_subscribed":{"type":"boolean"},"notes":{"type":["string","null"],"maxLength":10000},"custom_fields":{"type":"object","additionalProperties":true},"account_id":{"type":"string"},"platform":{"type":"string","enum":["instagram","facebook","x","bluesky","reddit","discord","mastodon","tiktok","sms","rcs","imessage","twitter"]},"platform_identifier":{"type":"string","minLength":1,"maxLength":255},"display_identifier":{"type":"string","maxLength":255}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"contacts","x-mcp-tool":"create-contact","x-idempotent":true,"x-zernio":["POST /v1/contacts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"email":{"type":["null","string"]},"company":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"is_blocked":{"type":"boolean"},"notes":{"type":["null","string"]},"custom_fields":{"type":"object","additionalProperties":true},"channels":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"contact_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_identifier":{"type":"string"},"display_identifier":{"type":["null","string"]},"is_subscribed":{"type":"boolean"},"conversation_id":{"type":["null","string"]},"last_active_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"messaging_window_open":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"conversation_ids":{"type":"array","items":{"type":"string"}},"messages_sent_count":{"type":"integer"},"messages_received_count":{"type":"integer"},"last_message_sent_at":{"type":["null","string"],"format":"date-time"},"last_message_received_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/contacts/bulk":{"post":{"operationId":"bulkCreateContacts","summary":"Bulk create contacts","tags":["Contacts"],"description":"Up to 1000 rows. Duplicates (same channel identity, or same email in the profile) are skipped and their tags merged. Per-row errors come back in `errors` with HTTP 200.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["contacts"],"properties":{"profile_id":{"type":"string"},"account_id":{"type":"string"},"platform":{"type":"string","enum":["instagram","facebook","x","bluesky","reddit","discord","mastodon","tiktok","sms","rcs","imessage","twitter"]},"contacts":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"platform_identifier":{"type":"string","maxLength":255},"display_identifier":{"type":"string","maxLength":255},"email":{"type":["string","null"],"maxLength":320},"company":{"type":["string","null"],"maxLength":200},"tags":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}}}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"contacts","x-mcp-tool":"bulk-create-contacts","x-idempotent":true,"x-rate-limit":{"max":30,"timeWindow":"1 minute"},"x-zernio":["POST /v1/contacts/bulk"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact_bulk_result"]},"created":{"type":"integer"},"skipped":{"type":"integer"},"failed":{"type":"integer"},"total":{"type":"integer"},"errors":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"code":{"type":"string"},"message":{"type":"string"}}}},"contact_ids":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/contacts/bulk-tag":{"post":{"operationId":"bulkTagContacts","summary":"Bulk tag contacts","tags":["Contacts"],"description":"Add and/or remove tags on up to 1000 contacts. Emits `contact.tag_added` / `contact.tag_removed` per change (tag workflows start as for single updates). Unknown or inaccessible ids are listed in `missing`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["contact_ids"],"anyOf":[{"required":["add"]},{"required":["remove"]}],"properties":{"contact_ids":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"string","maxLength":64}},"add":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"remove":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"contacts","x-mcp-tool":"bulk-tag-contacts","x-idempotent":true,"x-rate-limit":{"max":30,"timeWindow":"1 minute"},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact_bulk_action"]},"action":{"type":"string","enum":["tag","delete"]},"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"},"contact_ids":{"type":"array","items":{"type":"string"},"description":"Contacts the action was applied to"},"missing":{"type":"array","items":{"type":"string"},"description":"Ids that are invalid, unknown or outside your profiles"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/contacts/bulk-delete":{"post":{"operationId":"bulkDeleteContacts","summary":"Bulk delete contacts","tags":["Contacts"],"description":"Delete up to 1000 contacts with their channels and field values. Emits `contact.deleted` for each. Unknown or inaccessible ids are listed in `missing`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["contact_ids"],"properties":{"contact_ids":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"string","maxLength":64}}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"contacts","x-mcp-tool":"bulk-delete-contacts","x-rate-limit":{"max":30,"timeWindow":"1 minute"},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact_bulk_action"]},"action":{"type":"string","enum":["tag","delete"]},"total":{"type":"integer"},"succeeded":{"type":"integer"},"failed":{"type":"integer"},"contact_ids":{"type":"array","items":{"type":"string"},"description":"Contacts the action was applied to"},"missing":{"type":"array","items":{"type":"string"},"description":"Ids that are invalid, unknown or outside your profiles"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/contacts/tags":{"get":{"operationId":"listContactTags","summary":"List contact tags","tags":["Contacts"],"description":"Tags in use with the number of contacts carrying each (most used first).","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"contacts","x-mcp-tool":"list-contact-tags","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["contact_tag"]},"tag":{"type":"string"},"count":{"type":"integer"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/contacts/{id}":{"get":{"operationId":"getContact","summary":"Get a contact","tags":["Contacts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"contact id (con_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"contacts","x-mcp-tool":"get-contact","x-zernio":["GET /v1/contacts/{contactId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"email":{"type":["null","string"]},"company":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"is_blocked":{"type":"boolean"},"notes":{"type":["null","string"]},"custom_fields":{"type":"object","additionalProperties":true},"channels":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"contact_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_identifier":{"type":"string"},"display_identifier":{"type":["null","string"]},"is_subscribed":{"type":"boolean"},"conversation_id":{"type":["null","string"]},"last_active_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"messaging_window_open":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"conversation_ids":{"type":"array","items":{"type":"string"}},"messages_sent_count":{"type":"integer"},"messages_received_count":{"type":"integer"},"last_message_sent_at":{"type":["null","string"],"format":"date-time"},"last_message_received_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateContact","summary":"Update a contact","tags":["Contacts"],"description":"`tags` replaces the set (emits contact.tag_added / tag_removed per change); `custom_fields` sets values (`null` clears). Unsubscribing exits sequences with `exit_on_unsubscribe`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"email":{"type":["string","null"],"maxLength":320},"company":{"type":["string","null"],"maxLength":200},"avatar_url":{"type":["string","null"],"maxLength":2048},"tags":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"is_subscribed":{"type":"boolean"},"notes":{"type":["string","null"],"maxLength":10000},"custom_fields":{"type":"object","additionalProperties":true},"is_blocked":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"contact id (con_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"contacts","x-mcp-tool":"update-contact","x-zernio":["PATCH /v1/contacts/{contactId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"email":{"type":["null","string"]},"company":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"is_blocked":{"type":"boolean"},"notes":{"type":["null","string"]},"custom_fields":{"type":"object","additionalProperties":true},"channels":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"contact_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_identifier":{"type":"string"},"display_identifier":{"type":["null","string"]},"is_subscribed":{"type":"boolean"},"conversation_id":{"type":["null","string"]},"last_active_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"messaging_window_open":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"conversation_ids":{"type":"array","items":{"type":"string"}},"messages_sent_count":{"type":"integer"},"messages_received_count":{"type":"integer"},"last_message_sent_at":{"type":["null","string"],"format":"date-time"},"last_message_received_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteContact","summary":"Delete a contact","tags":["Contacts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"contact id (con_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"contacts","x-mcp-tool":"delete-contact","x-zernio":["DELETE /v1/contacts/{contactId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/contacts/{id}/tags":{"post":{"operationId":"updateContactTags","summary":"Add or remove contact tags","tags":["Contacts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"add":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"remove":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"contact id (con_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"contacts","x-mcp-tool":"update-contact-tags","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"email":{"type":["null","string"]},"company":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"is_blocked":{"type":"boolean"},"notes":{"type":["null","string"]},"custom_fields":{"type":"object","additionalProperties":true},"channels":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"contact_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_identifier":{"type":"string"},"display_identifier":{"type":["null","string"]},"is_subscribed":{"type":"boolean"},"conversation_id":{"type":["null","string"]},"last_active_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"messaging_window_open":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"conversation_ids":{"type":"array","items":{"type":"string"}},"messages_sent_count":{"type":"integer"},"messages_received_count":{"type":"integer"},"last_message_sent_at":{"type":["null","string"],"format":"date-time"},"last_message_received_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/contacts/{id}/channels":{"get":{"operationId":"listContactChannels","summary":"List a contact's channels","tags":["Contacts"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"contact id (con_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"contacts","x-mcp-tool":"list-contact-channels","x-zernio":["GET /v1/contacts/{contactId}/channels"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"contact_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_identifier":{"type":"string"},"display_identifier":{"type":["null","string"]},"is_subscribed":{"type":"boolean"},"conversation_id":{"type":["null","string"]},"last_active_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"messaging_window_open":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createContactChannel","summary":"Link a channel to a contact","tags":["Contacts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["account_id","platform_identifier"],"properties":{"account_id":{"type":"string"},"platform":{"type":"string","enum":["instagram","facebook","x","bluesky","reddit","discord","mastodon","tiktok","sms","rcs","imessage","twitter"]},"platform_identifier":{"type":"string","minLength":1,"maxLength":255},"display_identifier":{"type":"string","maxLength":255},"is_subscribed":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"contact id (con_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"contacts","x-mcp-tool":"create-contact-channel","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"contact_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_identifier":{"type":"string"},"display_identifier":{"type":["null","string"]},"is_subscribed":{"type":"boolean"},"conversation_id":{"type":["null","string"]},"last_active_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"messaging_window_open":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/contacts/{id}/channels/{channelId}":{"patch":{"operationId":"updateContactChannel","summary":"Update a contact channel","tags":["Contacts"],"description":"Opt a channel in or out (`is_subscribed`) or change its display identifier.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"display_identifier":{"type":["string","null"],"maxLength":255},"is_subscribed":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"contact id (con_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ch_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"channelId","required":true,"description":"channel id (ch_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"contacts","x-mcp-tool":"update-contact-channel","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"contact_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_identifier":{"type":"string"},"display_identifier":{"type":["null","string"]},"is_subscribed":{"type":"boolean"},"conversation_id":{"type":["null","string"]},"last_active_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"messaging_window_open":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteContactChannel","summary":"Unlink a contact channel","tags":["Contacts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"contact id (con_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ch_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"channelId","required":true,"description":"channel id (ch_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"contacts","x-mcp-tool":"delete-contact-channel","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/contacts/{id}/fields/{slug}":{"put":{"operationId":"setContactFieldValue","summary":"Set a custom field value","tags":["Contacts"],"description":"The value is type-checked against the field definition (422 on mismatch). Emits contact.field_changed when the value changes.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["value"],"properties":{"value":{}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"contact id (con_…)"},{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"slug","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"contacts","x-mcp-tool":"set-contact-field-value","x-zernio":["PUT /v1/contacts/{contactId}/fields/{slug}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"email":{"type":["null","string"]},"company":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"is_blocked":{"type":"boolean"},"notes":{"type":["null","string"]},"custom_fields":{"type":"object","additionalProperties":true},"channels":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"contact_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_identifier":{"type":"string"},"display_identifier":{"type":["null","string"]},"is_subscribed":{"type":"boolean"},"conversation_id":{"type":["null","string"]},"last_active_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"messaging_window_open":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"conversation_ids":{"type":"array","items":{"type":"string"}},"messages_sent_count":{"type":"integer"},"messages_received_count":{"type":"integer"},"last_message_sent_at":{"type":["null","string"],"format":"date-time"},"last_message_received_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"clearContactFieldValue","summary":"Clear a custom field value","tags":["Contacts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"contact id (con_…)"},{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"slug","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"contacts","x-mcp-tool":"clear-contact-field-value","x-zernio":["DELETE /v1/contacts/{contactId}/fields/{slug}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["contact"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"email":{"type":["null","string"]},"company":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"is_blocked":{"type":"boolean"},"notes":{"type":["null","string"]},"custom_fields":{"type":"object","additionalProperties":true},"channels":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["contact_channel"]},"id":{"type":"string"},"contact_id":{"type":"string"},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"platform_identifier":{"type":"string"},"display_identifier":{"type":["null","string"]},"is_subscribed":{"type":"boolean"},"conversation_id":{"type":["null","string"]},"last_active_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"messaging_window_open":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"conversation_ids":{"type":"array","items":{"type":"string"}},"messages_sent_count":{"type":"integer"},"messages_received_count":{"type":"integer"},"last_message_sent_at":{"type":["null","string"],"format":"date-time"},"last_message_received_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/custom-fields":{"get":{"operationId":"listCustomFields","summary":"List custom fields","tags":["Custom Fields"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name","slug"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"type","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"custom_fields","x-mcp-tool":"list-custom-fields","x-zernio":["GET /v1/custom-fields"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["custom_field"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"slug":{"type":"string"},"type":{"type":"string","enum":["text","number","date","boolean","select"]},"options":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createCustomField","summary":"Create a custom field","tags":["Custom Fields"],"description":"`slug` defaults to the name in snake_case; 409 `slug_taken` when used. `options` are required for `select`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","type"],"properties":{"profile_id":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","minLength":1,"maxLength":120},"type":{"type":"string","enum":["text","number","date","boolean","select"]},"options":{"type":"array","maxItems":200,"items":{"type":"string","minLength":1,"maxLength":200}}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"custom_fields","x-mcp-tool":"create-custom-field","x-idempotent":true,"x-zernio":["POST /v1/custom-fields"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["custom_field"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"slug":{"type":"string"},"type":{"type":"string","enum":["text","number","date","boolean","select"]},"options":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/custom-fields/{id}":{"get":{"operationId":"getCustomField","summary":"Get a custom field","tags":["Custom Fields"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"cf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"customField id (cf_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"custom_fields","x-mcp-tool":"get-custom-field","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["custom_field"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"slug":{"type":"string"},"type":{"type":"string","enum":["text","number","date","boolean","select"]},"options":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateCustomField","summary":"Update a custom field","tags":["Custom Fields"],"description":"Name and options only (type and slug are immutable).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":120},"options":{"type":"array","maxItems":200,"items":{"type":"string","minLength":1,"maxLength":200}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"cf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"customField id (cf_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"custom_fields","x-mcp-tool":"update-custom-field","x-zernio":["PATCH /v1/custom-fields/{fieldId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["custom_field"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"name":{"type":"string"},"slug":{"type":"string"},"type":{"type":"string","enum":["text","number","date","boolean","select"]},"options":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteCustomField","summary":"Delete a custom field","tags":["Custom Fields"],"description":"Deletes the definition and every stored value.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"cf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"customField id (cf_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"custom_fields","x-mcp-tool":"delete-custom-field","x-zernio":["DELETE /v1/custom-fields/{fieldId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["custom_field"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/broadcasts":{"get":{"operationId":"listBroadcasts","summary":"List broadcasts","tags":["Broadcasts"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","scheduled_at","name"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"broadcasts","x-mcp-tool":"list-broadcasts","x-feature":"broadcasts","x-zernio":["GET /v1/broadcasts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["broadcast"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","scheduled","sending","completed","failed","cancelled"]},"message":{"type":"object","properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"segment_filters":{"type":["null","object"],"properties":{"tags":{"type":"array","items":{"type":"string"}},"tags_match":{"type":"string"},"exclude_tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}},"message_preview":{"type":["null","string"]},"rate_limit_per_minute":{"type":["null","integer"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"recipient_count":{"type":"integer"},"pending_count":{"type":"integer"},"sent_count":{"type":"integer"},"delivered_count":{"type":"integer"},"read_count":{"type":"integer"},"failed_count":{"type":"integer"},"skipped_count":{"type":"integer"},"last_error":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createBroadcast","summary":"Create a broadcast draft","tags":["Broadcasts"],"description":"`segment_filters` select recipients by tags, subscription and custom fields.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["account_id","name"],"properties":{"profile_id":{"type":"string"},"account_id":{"type":"string"},"platform":{"type":"string","enum":["instagram","facebook","x","bluesky","reddit","discord","mastodon","tiktok","sms","rcs","imessage","twitter"]},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":["string","null"],"maxLength":2000},"message":{"type":"object","additionalProperties":false,"properties":{"text":{"type":["string","null"],"maxLength":4096},"attachments":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":"string","minLength":1,"maxLength":2048},"filename":{"type":"string","maxLength":255}}}},"message_tag":{"type":["string","null"],"enum":["HUMAN_AGENT","CONFIRMED_EVENT_UPDATE","POST_PURCHASE_UPDATE","ACCOUNT_UPDATE",null]}}},"segment_filters":{"type":["object","null"],"additionalProperties":false,"properties":{"tags":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"tags_match":{"type":"string","enum":["any","all"]},"exclude_tags":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}},"rate_limit_per_minute":{"type":["integer","null"],"minimum":1,"maximum":6000}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"broadcasts","x-mcp-tool":"create-broadcast","x-idempotent":true,"x-feature":"broadcasts","x-zernio":["POST /v1/broadcasts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["broadcast"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","scheduled","sending","completed","failed","cancelled"]},"message":{"type":"object","properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"segment_filters":{"type":["null","object"],"properties":{"tags":{"type":"array","items":{"type":"string"}},"tags_match":{"type":"string"},"exclude_tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}},"message_preview":{"type":["null","string"]},"rate_limit_per_minute":{"type":["null","integer"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"recipient_count":{"type":"integer"},"pending_count":{"type":"integer"},"sent_count":{"type":"integer"},"delivered_count":{"type":"integer"},"read_count":{"type":"integer"},"failed_count":{"type":"integer"},"skipped_count":{"type":"integer"},"last_error":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/broadcasts/audience-preview":{"post":{"operationId":"previewBroadcastAudience","summary":"Preview a broadcast audience","tags":["Broadcasts"],"description":"Count (and sample) the contacts a segment reaches on an account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["account_id"],"properties":{"profile_id":{"type":"string"},"account_id":{"type":"string"},"segment_filters":{"type":["object","null"],"additionalProperties":false,"properties":{"tags":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"tags_match":{"type":"string","enum":["any","all"]},"exclude_tags":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"broadcasts","x-mcp-tool":"preview-broadcast-audience","x-feature":"broadcasts","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["audience_preview"]},"count":{"type":"integer"},"sample":{"type":"array","items":{"type":"object","properties":{"contact_id":{"type":"string"},"name":{"type":"string"},"platform_identifier":{"type":"string"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/broadcasts/{id}":{"get":{"operationId":"getBroadcast","summary":"Get a broadcast","tags":["Broadcasts"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"brd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"broadcast id (brd_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"broadcasts","x-mcp-tool":"get-broadcast","x-feature":"broadcasts","x-zernio":["GET /v1/broadcasts/{broadcastId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["broadcast"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","scheduled","sending","completed","failed","cancelled"]},"message":{"type":"object","properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"segment_filters":{"type":["null","object"],"properties":{"tags":{"type":"array","items":{"type":"string"}},"tags_match":{"type":"string"},"exclude_tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}},"message_preview":{"type":["null","string"]},"rate_limit_per_minute":{"type":["null","integer"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"recipient_count":{"type":"integer"},"pending_count":{"type":"integer"},"sent_count":{"type":"integer"},"delivered_count":{"type":"integer"},"read_count":{"type":"integer"},"failed_count":{"type":"integer"},"skipped_count":{"type":"integer"},"last_error":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateBroadcast","summary":"Update a broadcast","tags":["Broadcasts"],"description":"Only while `draft` or `scheduled` (409 `broadcast_not_editable`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":["string","null"],"maxLength":2000},"message":{"type":"object","additionalProperties":false,"properties":{"text":{"type":["string","null"],"maxLength":4096},"attachments":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":"string","minLength":1,"maxLength":2048},"filename":{"type":"string","maxLength":255}}}},"message_tag":{"type":["string","null"],"enum":["HUMAN_AGENT","CONFIRMED_EVENT_UPDATE","POST_PURCHASE_UPDATE","ACCOUNT_UPDATE",null]}}},"segment_filters":{"type":["object","null"],"additionalProperties":false,"properties":{"tags":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"tags_match":{"type":"string","enum":["any","all"]},"exclude_tags":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":64}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}},"rate_limit_per_minute":{"type":["integer","null"],"minimum":1,"maximum":6000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"brd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"broadcast id (brd_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"broadcasts","x-mcp-tool":"update-broadcast","x-feature":"broadcasts","x-zernio":["PATCH /v1/broadcasts/{broadcastId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["broadcast"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","scheduled","sending","completed","failed","cancelled"]},"message":{"type":"object","properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"segment_filters":{"type":["null","object"],"properties":{"tags":{"type":"array","items":{"type":"string"}},"tags_match":{"type":"string"},"exclude_tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}},"message_preview":{"type":["null","string"]},"rate_limit_per_minute":{"type":["null","integer"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"recipient_count":{"type":"integer"},"pending_count":{"type":"integer"},"sent_count":{"type":"integer"},"delivered_count":{"type":"integer"},"read_count":{"type":"integer"},"failed_count":{"type":"integer"},"skipped_count":{"type":"integer"},"last_error":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteBroadcast","summary":"Delete a broadcast","tags":["Broadcasts"],"description":"Not while sending (cancel first).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"brd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"broadcast id (brd_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"broadcasts","x-mcp-tool":"delete-broadcast","x-feature":"broadcasts","x-zernio":["DELETE /v1/broadcasts/{broadcastId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["broadcast"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/broadcasts/{id}/send":{"post":{"operationId":"sendBroadcast","summary":"Send a broadcast now","tags":["Broadcasts"],"description":"Resolves the segment when no recipients were added (422 `no_recipients` when nothing matches) and starts sending in rate-limited batches.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"brd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"broadcast id (brd_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"broadcasts","x-mcp-tool":"send-broadcast","x-idempotent":true,"x-feature":"broadcasts","x-zernio":["POST /v1/broadcasts/{broadcastId}/send"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["broadcast"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","scheduled","sending","completed","failed","cancelled"]},"message":{"type":"object","properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"segment_filters":{"type":["null","object"],"properties":{"tags":{"type":"array","items":{"type":"string"}},"tags_match":{"type":"string"},"exclude_tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}},"message_preview":{"type":["null","string"]},"rate_limit_per_minute":{"type":["null","integer"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"recipient_count":{"type":"integer"},"pending_count":{"type":"integer"},"sent_count":{"type":"integer"},"delivered_count":{"type":"integer"},"read_count":{"type":"integer"},"failed_count":{"type":"integer"},"skipped_count":{"type":"integer"},"last_error":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/broadcasts/{id}/schedule":{"post":{"operationId":"scheduleBroadcast","summary":"Schedule a broadcast","tags":["Broadcasts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["scheduled_at"],"properties":{"scheduled_at":{"type":"string","format":"date-time"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"brd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"broadcast id (brd_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"broadcasts","x-mcp-tool":"schedule-broadcast","x-idempotent":true,"x-feature":"broadcasts","x-zernio":["POST /v1/broadcasts/{broadcastId}/schedule"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["broadcast"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","scheduled","sending","completed","failed","cancelled"]},"message":{"type":"object","properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"segment_filters":{"type":["null","object"],"properties":{"tags":{"type":"array","items":{"type":"string"}},"tags_match":{"type":"string"},"exclude_tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}},"message_preview":{"type":["null","string"]},"rate_limit_per_minute":{"type":["null","integer"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"recipient_count":{"type":"integer"},"pending_count":{"type":"integer"},"sent_count":{"type":"integer"},"delivered_count":{"type":"integer"},"read_count":{"type":"integer"},"failed_count":{"type":"integer"},"skipped_count":{"type":"integer"},"last_error":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/broadcasts/{id}/cancel":{"post":{"operationId":"cancelBroadcast","summary":"Cancel a broadcast","tags":["Broadcasts"],"description":"Pending recipients become `skipped`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"brd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"broadcast id (brd_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"broadcasts","x-mcp-tool":"cancel-broadcast","x-feature":"broadcasts","x-zernio":["POST /v1/broadcasts/{broadcastId}/cancel"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["broadcast"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","scheduled","sending","completed","failed","cancelled"]},"message":{"type":"object","properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"segment_filters":{"type":["null","object"],"properties":{"tags":{"type":"array","items":{"type":"string"}},"tags_match":{"type":"string"},"exclude_tags":{"type":"array","items":{"type":"string"}},"is_subscribed":{"type":"boolean"},"custom_fields":{"type":"object","additionalProperties":true}}},"message_preview":{"type":["null","string"]},"rate_limit_per_minute":{"type":["null","integer"]},"scheduled_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"recipient_count":{"type":"integer"},"pending_count":{"type":"integer"},"sent_count":{"type":"integer"},"delivered_count":{"type":"integer"},"read_count":{"type":"integer"},"failed_count":{"type":"integer"},"skipped_count":{"type":"integer"},"last_error":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/broadcasts/{id}/recipients":{"get":{"operationId":"listBroadcastRecipients","summary":"List broadcast recipients","tags":["Broadcasts"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","sent_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"contact_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"brd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"broadcast id (brd_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"broadcasts","x-mcp-tool":"list-broadcast-recipients","x-feature":"broadcasts","x-zernio":["GET /v1/broadcasts/{broadcastId}/recipients"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["broadcast_recipient"]},"id":{"type":"string"},"broadcast_id":{"type":"string"},"contact_id":{"type":["null","string"]},"channel_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"platform_identifier":{"type":["null","string"]},"status":{"type":"string","enum":["pending","sent","delivered","read","failed","skipped"]},"message_id":{"type":["null","string"]},"error":{"type":["null","string"]},"error_code":{"type":["null","string"]},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"read_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"addBroadcastRecipients","summary":"Add broadcast recipients","tags":["Broadcasts"],"description":"By `contact_ids` and/or `use_segment`. Contacts without a subscribed channel on the account are skipped.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"contact_ids":{"type":"array","maxItems":10000,"items":{"type":"string"}},"phones":{"type":"array","maxItems":10000,"items":{"type":"string","maxLength":32}},"use_segment":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"brd_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"broadcast id (brd_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"broadcasts","x-mcp-tool":"add-broadcast-recipients","x-idempotent":true,"x-feature":"broadcasts","x-zernio":["POST /v1/broadcasts/{broadcastId}/recipients"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["broadcast_recipients_result"]},"added":{"type":"integer"},"skipped":{"type":"integer"},"recipient_count":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sequences":{"get":{"operationId":"listSequences","summary":"List sequences","tags":["Sequences"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"sequences","x-mcp-tool":"list-sequences","x-feature":"automations","x-zernio":["GET /v1/sequences"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["sequence"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"steps":{"type":"array","items":{"type":"object","properties":{"order":{"type":"integer"},"delay_minutes":{"type":"integer"},"message":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"condition":{"type":["null","object"],"properties":{"variable":{"type":"string"},"operator":{"type":"string"},"value":{},"on_false":{"type":"string"}}}}}},"steps_count":{"type":"integer"},"message_preview":{"type":["null","string"]},"exit_on_reply":{"type":"boolean"},"exit_on_unsubscribe":{"type":"boolean"},"stats":{"type":"object","properties":{"total_enrolled":{"type":"integer"},"active":{"type":"integer"},"paused":{"type":"integer"},"completed":{"type":"integer"},"exited":{"type":"integer"}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createSequence","summary":"Create a sequence","tags":["Sequences"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["account_id","name"],"properties":{"profile_id":{"type":"string"},"account_id":{"type":"string"},"platform":{"type":"string","enum":["instagram","facebook","x","bluesky","reddit","discord","mastodon","tiktok","sms","rcs","imessage","twitter"]},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":["string","null"],"maxLength":2000},"steps":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["order","delay_minutes"],"properties":{"order":{"type":"integer","minimum":1,"maximum":1000},"delay_minutes":{"type":"integer","minimum":0,"maximum":525600},"message":{"type":["object","null"],"additionalProperties":false,"properties":{"text":{"type":["string","null"],"maxLength":4096},"attachments":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":"string","minLength":1,"maxLength":2048},"filename":{"type":"string","maxLength":255}}}},"message_tag":{"type":["string","null"],"enum":["HUMAN_AGENT","CONFIRMED_EVENT_UPDATE","POST_PURCHASE_UPDATE","ACCOUNT_UPDATE",null]}}},"condition":{"type":["object","null"],"additionalProperties":false,"required":["variable","operator"],"properties":{"variable":{"type":"string","minLength":1,"maxLength":200},"operator":{"type":"string"},"value":{},"on_false":{"type":"string","enum":["skip","exit"]}}}}}},"exit_on_reply":{"type":"boolean"},"exit_on_unsubscribe":{"type":"boolean"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"sequences","x-mcp-tool":"create-sequence","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/sequences"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sequence"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"steps":{"type":"array","items":{"type":"object","properties":{"order":{"type":"integer"},"delay_minutes":{"type":"integer"},"message":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"condition":{"type":["null","object"],"properties":{"variable":{"type":"string"},"operator":{"type":"string"},"value":{},"on_false":{"type":"string"}}}}}},"steps_count":{"type":"integer"},"message_preview":{"type":["null","string"]},"exit_on_reply":{"type":"boolean"},"exit_on_unsubscribe":{"type":"boolean"},"stats":{"type":"object","properties":{"total_enrolled":{"type":"integer"},"active":{"type":"integer"},"paused":{"type":"integer"},"completed":{"type":"integer"},"exited":{"type":"integer"}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/sequences/{id}":{"get":{"operationId":"getSequence","summary":"Get a sequence","tags":["Sequences"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"sequence id (seq_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"sequences","x-mcp-tool":"get-sequence","x-feature":"automations","x-zernio":["GET /v1/sequences/{sequenceId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sequence"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"steps":{"type":"array","items":{"type":"object","properties":{"order":{"type":"integer"},"delay_minutes":{"type":"integer"},"message":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"condition":{"type":["null","object"],"properties":{"variable":{"type":"string"},"operator":{"type":"string"},"value":{},"on_false":{"type":"string"}}}}}},"steps_count":{"type":"integer"},"message_preview":{"type":["null","string"]},"exit_on_reply":{"type":"boolean"},"exit_on_unsubscribe":{"type":"boolean"},"stats":{"type":"object","properties":{"total_enrolled":{"type":"integer"},"active":{"type":"integer"},"paused":{"type":"integer"},"completed":{"type":"integer"},"exited":{"type":"integer"}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateSequence","summary":"Update a sequence","tags":["Sequences"],"description":"`steps` can only be replaced while `draft` or `paused` (409 `sequence_not_editable`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":["string","null"],"maxLength":2000},"steps":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["order","delay_minutes"],"properties":{"order":{"type":"integer","minimum":1,"maximum":1000},"delay_minutes":{"type":"integer","minimum":0,"maximum":525600},"message":{"type":["object","null"],"additionalProperties":false,"properties":{"text":{"type":["string","null"],"maxLength":4096},"attachments":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":"string","minLength":1,"maxLength":2048},"filename":{"type":"string","maxLength":255}}}},"message_tag":{"type":["string","null"],"enum":["HUMAN_AGENT","CONFIRMED_EVENT_UPDATE","POST_PURCHASE_UPDATE","ACCOUNT_UPDATE",null]}}},"condition":{"type":["object","null"],"additionalProperties":false,"required":["variable","operator"],"properties":{"variable":{"type":"string","minLength":1,"maxLength":200},"operator":{"type":"string"},"value":{},"on_false":{"type":"string","enum":["skip","exit"]}}}}}},"exit_on_reply":{"type":"boolean"},"exit_on_unsubscribe":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"sequence id (seq_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"sequences","x-mcp-tool":"update-sequence","x-feature":"automations","x-zernio":["PATCH /v1/sequences/{sequenceId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sequence"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"steps":{"type":"array","items":{"type":"object","properties":{"order":{"type":"integer"},"delay_minutes":{"type":"integer"},"message":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"condition":{"type":["null","object"],"properties":{"variable":{"type":"string"},"operator":{"type":"string"},"value":{},"on_false":{"type":"string"}}}}}},"steps_count":{"type":"integer"},"message_preview":{"type":["null","string"]},"exit_on_reply":{"type":"boolean"},"exit_on_unsubscribe":{"type":"boolean"},"stats":{"type":"object","properties":{"total_enrolled":{"type":"integer"},"active":{"type":"integer"},"paused":{"type":"integer"},"completed":{"type":"integer"},"exited":{"type":"integer"}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteSequence","summary":"Delete a sequence","tags":["Sequences"],"description":"Live enrollments exit with `sequence_deleted`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"sequence id (seq_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"sequences","x-mcp-tool":"delete-sequence","x-feature":"automations","x-zernio":["DELETE /v1/sequences/{sequenceId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sequence"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sequences/{id}/activate":{"post":{"operationId":"activateSequence","summary":"Activate a sequence","tags":["Sequences"],"description":"Paused enrollments resume (overdue steps are sent now).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"sequence id (seq_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"sequences","x-mcp-tool":"activate-sequence","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/sequences/{sequenceId}/activate"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sequence"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"steps":{"type":"array","items":{"type":"object","properties":{"order":{"type":"integer"},"delay_minutes":{"type":"integer"},"message":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"condition":{"type":["null","object"],"properties":{"variable":{"type":"string"},"operator":{"type":"string"},"value":{},"on_false":{"type":"string"}}}}}},"steps_count":{"type":"integer"},"message_preview":{"type":["null","string"]},"exit_on_reply":{"type":"boolean"},"exit_on_unsubscribe":{"type":"boolean"},"stats":{"type":"object","properties":{"total_enrolled":{"type":"integer"},"active":{"type":"integer"},"paused":{"type":"integer"},"completed":{"type":"integer"},"exited":{"type":"integer"}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sequences/{id}/pause":{"post":{"operationId":"pauseSequence","summary":"Pause a sequence","tags":["Sequences"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"sequence id (seq_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"sequences","x-mcp-tool":"pause-sequence","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/sequences/{sequenceId}/pause"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sequence"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"steps":{"type":"array","items":{"type":"object","properties":{"order":{"type":"integer"},"delay_minutes":{"type":"integer"},"message":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"filename":{"type":["null","string"]}}}},"message_tag":{"type":["null","string"]}}},"condition":{"type":["null","object"],"properties":{"variable":{"type":"string"},"operator":{"type":"string"},"value":{},"on_false":{"type":"string"}}}}}},"steps_count":{"type":"integer"},"message_preview":{"type":["null","string"]},"exit_on_reply":{"type":"boolean"},"exit_on_unsubscribe":{"type":"boolean"},"stats":{"type":"object","properties":{"total_enrolled":{"type":"integer"},"active":{"type":"integer"},"paused":{"type":"integer"},"completed":{"type":"integer"},"exited":{"type":"integer"}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sequences/{id}/enroll":{"post":{"operationId":"enrollSequenceContacts","summary":"Enroll contacts in a sequence","tags":["Sequences"],"description":"The channel is the contact's subscribed channel on the sequence account unless `channel_ids` pin one. Already-enrolled contacts are skipped.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["contact_ids"],"properties":{"contact_ids":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"string"}},"channel_ids":{"type":"array","maxItems":1000,"items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"sequence id (seq_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"sequences","x-mcp-tool":"enroll-sequence-contacts","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/sequences/{sequenceId}/enroll"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sequence_enroll_result"]},"enrolled":{"type":"integer"},"skipped":{"type":"integer"},"failed":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"contact_id":{"type":"string"},"success":{"type":"boolean"},"enrollment_id":{"type":["null","string"]},"error":{"type":["null","string"]}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sequences/{id}/enroll/{contactId}":{"delete":{"operationId":"unenrollSequenceContact","summary":"Unenroll a contact","tags":["Sequences"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"sequence id (seq_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"contactId","required":true,"description":"contact id (con_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"sequences","x-mcp-tool":"unenroll-sequence-contact","x-feature":"automations","x-zernio":["DELETE /v1/sequences/{sequenceId}/enroll/{contactId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sequence_enrollment"]},"id":{"type":"string"},"sequence_id":{"type":"string"},"contact_id":{"type":["null","string"]},"channel_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"platform_identifier":{"type":["null","string"]},"status":{"type":"string","enum":["active","paused","completed","exited"]},"exit_reason":{"type":["null","string"]},"current_step_index":{"type":"integer"},"steps_sent":{"type":"integer"},"next_step_at":{"type":["null","string"],"format":"date-time"},"last_step_sent_at":{"type":["null","string"],"format":"date-time"},"last_error":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sequences/{id}/enrollments":{"get":{"operationId":"listSequenceEnrollments","summary":"List sequence enrollments","tags":["Sequences"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","next_step_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"contact_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"sequence id (seq_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"sequences","x-mcp-tool":"list-sequence-enrollments","x-feature":"automations","x-zernio":["GET /v1/sequences/{sequenceId}/enrollments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["sequence_enrollment"]},"id":{"type":"string"},"sequence_id":{"type":"string"},"contact_id":{"type":["null","string"]},"channel_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"platform_identifier":{"type":["null","string"]},"status":{"type":"string","enum":["active","paused","completed","exited"]},"exit_reason":{"type":["null","string"]},"current_step_index":{"type":"integer"},"steps_sent":{"type":"integer"},"next_step_at":{"type":["null","string"],"format":"date-time"},"last_step_sent_at":{"type":["null","string"],"format":"date-time"},"last_error":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows":{"get":{"operationId":"listWorkflows","summary":"List workflows","tags":["Workflows"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","updated_at","name"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false},{"schema":{"type":"string"},"in":"query","name":"trigger_type","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"workflows","x-mcp-tool":"list-workflows","x-feature":"automations","x-zernio":["GET /v1/workflows"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["workflow"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":["null","string"]},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"trigger_type":{"type":["null","string"]},"entry_node_id":{"type":["null","string"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":["null","string"]},"position":{"type":["null","object"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"source_handle":{"type":["null","string"]}}}},"node_count":{"type":"integer"},"version":{"type":"integer"},"stats":{"type":"object","properties":{"total_started":{"type":"integer"},"total_completed":{"type":"integer"},"total_exited":{"type":"integer"},"total_failed":{"type":"integer"},"running":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createWorkflow","summary":"Create a workflow","tags":["Workflows"],"description":"Validates the graph structure (unique ids, known node types, edges between real nodes, valid handles). Created as `draft`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"profile_id":{"type":"string"},"account_id":{"type":["string","null"]},"platform":{"type":"string","enum":["instagram","facebook","x","bluesky","reddit","discord","mastodon","tiktok","sms","rcs","imessage","twitter"]},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":["string","null"],"maxLength":2000},"nodes":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["id","type"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"type":{"type":"string","enum":["trigger","send_message","reply_to_comment","private_reply","wait_for_reply","condition","set_variable","delay","http_request","ai","assign_conversation","handoff","add_tag","remove_tag","set_field","enroll_sequence","a_b_split","start_call","end","wait","webhook","ai_reply"]},"label":{"type":["string","null"],"maxLength":80},"position":{"type":["object","null"],"additionalProperties":false,"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","maxItems":400,"items":{"type":"object","additionalProperties":false,"required":["id","source","target"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"source":{"type":"string","minLength":1,"maxLength":64},"target":{"type":"string","minLength":1,"maxLength":64},"source_handle":{"type":["string","null"],"maxLength":64},"sourceHandle":{"type":["string","null"],"maxLength":64}}}},"entry_node_id":{"type":["string","null"],"maxLength":64}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"workflows","x-mcp-tool":"create-workflow","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/workflows"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":["null","string"]},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"trigger_type":{"type":["null","string"]},"entry_node_id":{"type":["null","string"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":["null","string"]},"position":{"type":["null","object"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"source_handle":{"type":["null","string"]}}}},"node_count":{"type":"integer"},"version":{"type":"integer"},"stats":{"type":"object","properties":{"total_started":{"type":"integer"},"total_completed":{"type":"integer"},"total_exited":{"type":"integer"},"total_failed":{"type":"integer"},"running":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/workflows/node-types":{"get":{"operationId":"listWorkflowNodeTypes","summary":"List workflow node types","tags":["Workflows"],"description":"Catalog of node types with their output handles and config JSON schema (drives the builder).","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":100},"in":"query","name":"limit","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"workflows","x-mcp-tool":"list-workflow-node-types","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["workflow_node_type"]},"type":{"type":"string"},"group":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"handles":{"type":"array","items":{"type":["null","string"]}},"config_schema":{"type":"object","additionalProperties":true},"platforms":{"type":["null","array"],"items":{"type":"string"}},"alias_of":{"type":["null","string"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}":{"get":{"operationId":"getWorkflow","summary":"Get a workflow","tags":["Workflows"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"workflows","x-mcp-tool":"get-workflow","x-feature":"automations","x-zernio":["GET /v1/workflows/{workflowId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":["null","string"]},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"trigger_type":{"type":["null","string"]},"entry_node_id":{"type":["null","string"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":["null","string"]},"position":{"type":["null","object"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"source_handle":{"type":["null","string"]}}}},"node_count":{"type":"integer"},"version":{"type":"integer"},"stats":{"type":"object","properties":{"total_started":{"type":"integer"},"total_completed":{"type":"integer"},"total_exited":{"type":"integer"},"total_failed":{"type":"integer"},"running":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateWorkflow","summary":"Update a workflow","tags":["Workflows"],"description":"The graph (`nodes`, `edges`, `entry_node_id`, replaced wholesale) is editable only while `draft` or `paused` (409 `workflow_not_editable`); name, description and account any time. Graph, name and description changes record a version.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":["string","null"],"maxLength":2000},"account_id":{"type":["string","null"]},"nodes":{"type":"array","maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["id","type"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"type":{"type":"string","enum":["trigger","send_message","reply_to_comment","private_reply","wait_for_reply","condition","set_variable","delay","http_request","ai","assign_conversation","handoff","add_tag","remove_tag","set_field","enroll_sequence","a_b_split","start_call","end","wait","webhook","ai_reply"]},"label":{"type":["string","null"],"maxLength":80},"position":{"type":["object","null"],"additionalProperties":false,"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","maxItems":400,"items":{"type":"object","additionalProperties":false,"required":["id","source","target"],"properties":{"id":{"type":"string","minLength":1,"maxLength":64},"source":{"type":"string","minLength":1,"maxLength":64},"target":{"type":"string","minLength":1,"maxLength":64},"source_handle":{"type":["string","null"],"maxLength":64},"sourceHandle":{"type":["string","null"],"maxLength":64}}}},"entry_node_id":{"type":["string","null"],"maxLength":64}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"workflows","x-mcp-tool":"update-workflow","x-feature":"automations","x-zernio":["PATCH /v1/workflows/{workflowId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":["null","string"]},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"trigger_type":{"type":["null","string"]},"entry_node_id":{"type":["null","string"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":["null","string"]},"position":{"type":["null","object"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"source_handle":{"type":["null","string"]}}}},"node_count":{"type":"integer"},"version":{"type":"integer"},"stats":{"type":"object","properties":{"total_started":{"type":"integer"},"total_completed":{"type":"integer"},"total_exited":{"type":"integer"},"total_failed":{"type":"integer"},"running":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteWorkflow","summary":"Delete a workflow","tags":["Workflows"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"workflows","x-mcp-tool":"delete-workflow","x-feature":"automations","x-zernio":["DELETE /v1/workflows/{workflowId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/activate":{"post":{"operationId":"activateWorkflow","summary":"Activate a workflow","tags":["Workflows"],"description":"Requires a complete graph: one trigger, every node reachable and valid, an account when the graph messages (422 `workflow_invalid` with `errors`).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"workflows","x-mcp-tool":"activate-workflow","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/workflows/{workflowId}/activate"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":["null","string"]},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"trigger_type":{"type":["null","string"]},"entry_node_id":{"type":["null","string"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":["null","string"]},"position":{"type":["null","object"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"source_handle":{"type":["null","string"]}}}},"node_count":{"type":"integer"},"version":{"type":"integer"},"stats":{"type":"object","properties":{"total_started":{"type":"integer"},"total_completed":{"type":"integer"},"total_exited":{"type":"integer"},"total_failed":{"type":"integer"},"running":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/pause":{"post":{"operationId":"pauseWorkflow","summary":"Pause a workflow","tags":["Workflows"],"description":"Stops new runs; in-flight runs finish.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"workflows","x-mcp-tool":"pause-workflow","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/workflows/{workflowId}/pause"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":["null","string"]},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"trigger_type":{"type":["null","string"]},"entry_node_id":{"type":["null","string"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":["null","string"]},"position":{"type":["null","object"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"source_handle":{"type":["null","string"]}}}},"node_count":{"type":"integer"},"version":{"type":"integer"},"stats":{"type":"object","properties":{"total_started":{"type":"integer"},"total_completed":{"type":"integer"},"total_exited":{"type":"integer"},"total_failed":{"type":"integer"},"running":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/duplicate":{"post":{"operationId":"duplicateWorkflow","summary":"Duplicate a workflow","tags":["Workflows"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"workflows","x-mcp-tool":"duplicate-workflow","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/workflows/{workflowId}/duplicate"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":["null","string"]},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"trigger_type":{"type":["null","string"]},"entry_node_id":{"type":["null","string"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":["null","string"]},"position":{"type":["null","object"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"source_handle":{"type":["null","string"]}}}},"node_count":{"type":"integer"},"version":{"type":"integer"},"stats":{"type":"object","properties":{"total_started":{"type":"integer"},"total_completed":{"type":"integer"},"total_exited":{"type":"integer"},"total_failed":{"type":"integer"},"running":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/versions":{"get":{"operationId":"listWorkflowVersions","summary":"List workflow versions","tags":["Workflows"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"workflows","x-mcp-tool":"list-workflow-versions","x-feature":"automations","x-zernio":["GET /v1/workflows/{workflowId}/versions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["workflow_version"]},"id":{"type":"string"},"workflow_id":{"type":"string"},"version":{"type":"integer"},"name":{"type":"string"},"description":{"type":["null","string"]},"entry_node_id":{"type":["null","string"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":["null","string"]},"position":{"type":["null","object"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"source_handle":{"type":["null","string"]}}}},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"restored_from_version":{"type":["null","integer"]},"created_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/versions/{version}":{"get":{"operationId":"getWorkflowVersion","summary":"Get a workflow version","tags":["Workflows"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"},{"schema":{"type":"integer","minimum":1},"in":"path","name":"version","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"workflows","x-mcp-tool":"get-workflow-version","x-feature":"automations","x-zernio":["GET /v1/workflows/{workflowId}/versions/{version}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow_version"]},"id":{"type":"string"},"workflow_id":{"type":"string"},"version":{"type":"integer"},"name":{"type":"string"},"description":{"type":["null","string"]},"entry_node_id":{"type":["null","string"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":["null","string"]},"position":{"type":["null","object"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"source_handle":{"type":["null","string"]}}}},"account_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"created_by":{"type":["null","object"],"properties":{"type":{"type":"string"},"id":{"type":["null","string"]},"name":{"type":["null","string"]}}},"restored_from_version":{"type":["null","integer"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/versions/{version}/restore":{"post":{"operationId":"restoreWorkflowVersion","summary":"Restore a workflow version","tags":["Workflows"],"description":"Copies the version graph back as a new version (`restored_from_version`). Only while `draft` or `paused`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"},{"schema":{"type":"integer","minimum":1},"in":"path","name":"version","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"workflows","x-mcp-tool":"restore-workflow-version","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/workflows/{workflowId}/versions/{version}/restore"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"account_name":{"type":["null","string"]},"platform":{"type":["null","string"]},"name":{"type":"string"},"description":{"type":["null","string"]},"status":{"type":"string","enum":["draft","active","paused"]},"trigger_type":{"type":["null","string"]},"entry_node_id":{"type":["null","string"]},"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":["null","string"]},"position":{"type":["null","object"],"properties":{"x":{"type":"number"},"y":{"type":"number"}}},"config":{"type":"object","additionalProperties":true}}}},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"source_handle":{"type":["null","string"]}}}},"node_count":{"type":"integer"},"version":{"type":"integer"},"stats":{"type":"object","properties":{"total_started":{"type":"integer"},"total_completed":{"type":"integer"},"total_exited":{"type":"integer"},"total_failed":{"type":"integer"},"running":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/executions":{"get":{"operationId":"listWorkflowExecutions","summary":"List workflow runs","tags":["Workflows"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","updated_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"contact_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"workflows","x-mcp-tool":"list-workflow-executions","x-feature":"automations","x-zernio":["GET /v1/workflows/{workflowId}/executions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["workflow_execution"]},"id":{"type":"string"},"workflow_id":{"type":"string"},"workflow_version":{"type":"integer"},"status":{"type":"string","enum":["running","waiting","completed","exited","failed"]},"trigger":{"type":"object","properties":{"type":{"type":["null","string"]},"text":{"type":["null","string"]}}},"contact_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"platform_identifier":{"type":["null","string"]},"current_node_id":{"type":["null","string"]},"waiting_for":{"type":["null","object"],"properties":{"kind":{"type":"string"},"node_id":{"type":["null","string"]},"until":{"type":["null","string"]}}},"variables":{"type":"object","additionalProperties":true},"step_count":{"type":"integer"},"last_error":{"type":["null","string"]},"resume_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"startWorkflowExecution","summary":"Start a workflow run manually","tags":["Workflows"],"description":"Test run for any status, on a `contact_id`, `conversation_id` or `to` (phone), with `text` seeding `last_message`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"contact_id":{"type":"string"},"conversation_id":{"type":"string"},"to":{"type":"string","maxLength":32},"text":{"type":"string","maxLength":4096},"variables":{"type":"object","additionalProperties":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"workflows","x-mcp-tool":"start-workflow-execution","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/workflows/{workflowId}/executions"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow_execution"]},"id":{"type":"string"},"workflow_id":{"type":"string"},"workflow_version":{"type":"integer"},"status":{"type":"string","enum":["running","waiting","completed","exited","failed"]},"trigger":{"type":"object","properties":{"type":{"type":["null","string"]},"text":{"type":["null","string"]}}},"contact_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"platform_identifier":{"type":["null","string"]},"current_node_id":{"type":["null","string"]},"waiting_for":{"type":["null","object"],"properties":{"kind":{"type":"string"},"node_id":{"type":["null","string"]},"until":{"type":["null","string"]}}},"variables":{"type":"object","additionalProperties":true},"step_count":{"type":"integer"},"last_error":{"type":["null","string"]},"resume_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/trigger":{"post":{"operationId":"triggerWorkflow","summary":"Trigger an API workflow","tags":["Workflows"],"description":"For active workflows with an `api_call` trigger: one of `contact_id`, `conversation_id` or `to`, plus `variables`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"contact_id":{"type":"string"},"conversation_id":{"type":"string"},"to":{"type":"string","maxLength":32},"variables":{"type":"object","additionalProperties":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"workflows","x-mcp-tool":"trigger-workflow","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/workflows/{workflowId}/trigger"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow_execution"]},"id":{"type":"string"},"workflow_id":{"type":"string"},"workflow_version":{"type":"integer"},"status":{"type":"string","enum":["running","waiting","completed","exited","failed"]},"trigger":{"type":"object","properties":{"type":{"type":["null","string"]},"text":{"type":["null","string"]}}},"contact_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"platform_identifier":{"type":["null","string"]},"current_node_id":{"type":["null","string"]},"waiting_for":{"type":["null","object"],"properties":{"kind":{"type":"string"},"node_id":{"type":["null","string"]},"until":{"type":["null","string"]}}},"variables":{"type":"object","additionalProperties":true},"step_count":{"type":"integer"},"last_error":{"type":["null","string"]},"resume_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/executions/{executionId}":{"get":{"operationId":"getWorkflowExecution","summary":"Get a workflow run","tags":["Workflows"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wfx_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"executionId","required":true,"description":"workflowExecution id (wfx_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"workflows","x-mcp-tool":"get-workflow-execution","x-feature":"automations","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow_execution"]},"id":{"type":"string"},"workflow_id":{"type":"string"},"workflow_version":{"type":"integer"},"status":{"type":"string","enum":["running","waiting","completed","exited","failed"]},"trigger":{"type":"object","properties":{"type":{"type":["null","string"]},"text":{"type":["null","string"]}}},"contact_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"platform_identifier":{"type":["null","string"]},"current_node_id":{"type":["null","string"]},"waiting_for":{"type":["null","object"],"properties":{"kind":{"type":"string"},"node_id":{"type":["null","string"]},"until":{"type":["null","string"]}}},"variables":{"type":"object","additionalProperties":true},"step_count":{"type":"integer"},"last_error":{"type":["null","string"]},"resume_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/executions/{executionId}/cancel":{"post":{"operationId":"cancelWorkflowExecution","summary":"Stop a workflow run","tags":["Workflows"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wfx_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"executionId","required":true,"description":"workflowExecution id (wfx_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"workflows","x-mcp-tool":"cancel-workflow-execution","x-feature":"automations","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["workflow_execution"]},"id":{"type":"string"},"workflow_id":{"type":"string"},"workflow_version":{"type":"integer"},"status":{"type":"string","enum":["running","waiting","completed","exited","failed"]},"trigger":{"type":"object","properties":{"type":{"type":["null","string"]},"text":{"type":["null","string"]}}},"contact_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"platform_identifier":{"type":["null","string"]},"current_node_id":{"type":["null","string"]},"waiting_for":{"type":["null","object"],"properties":{"kind":{"type":"string"},"node_id":{"type":["null","string"]},"until":{"type":["null","string"]}}},"variables":{"type":"object","additionalProperties":true},"step_count":{"type":"integer"},"last_error":{"type":["null","string"]},"resume_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"completed_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/workflows/{id}/executions/{executionId}/events":{"get":{"operationId":"listWorkflowExecutionEvents","summary":"Get a run timeline","tags":["Workflows"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wf_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"workflow id (wf_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"wfx_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"executionId","required":true,"description":"workflowExecution id (wfx_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"workflows","x-mcp-tool":"list-workflow-execution-events","x-feature":"automations","x-zernio":["GET /v1/workflows/{workflowId}/executions/{executionId}/events"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["workflow_execution_event"]},"id":{"type":"string"},"execution_id":{"type":"string"},"action":{"type":"string"},"status":{"type":"string"},"node_id":{"type":["null","string"]},"node_type":{"type":["null","string"]},"source_handle":{"type":["null","string"]},"duration_ms":{"type":["null","integer"]},"error_message":{"type":["null","string"]},"meta":{"type":["null","object"],"additionalProperties":true},"at":{"type":"string","format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/comment-automations":{"get":{"operationId":"listCommentAutomations","summary":"List comment automations","tags":["Comment Automations"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"platform","required":false},{"schema":{"type":"string"},"in":"query","name":"trigger","required":false},{"schema":{"type":"string"},"in":"query","name":"is_active","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"comment_automations","x-mcp-tool":"list-comment-automations","x-feature":"automations","x-zernio":["GET /v1/comment-automations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["comment_automation"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"trigger":{"type":"string"},"platform_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"post_title":{"type":["null","string"]},"keywords":{"type":"array","items":{"type":"string"}},"match_mode":{"type":"string"},"exclude_keywords":{"type":"array","items":{"type":"string"}},"typo_tolerance":{"type":"boolean"},"dm_message":{"type":["null","string"]},"dm_message_variations":{"type":"array","items":{"type":"string"}},"buttons":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"url":{"type":["null","string"]},"payload":{"type":["null","string"]},"phone":{"type":["null","string"]}}}},"template":{"type":["null","object"],"additionalProperties":true},"quick_replies":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"payload":{"type":["null","string"]},"image_url":{"type":["null","string"]}}}},"dm_media":{"type":["null","object"],"properties":{"type":{"type":"string"},"url":{"type":"string"}}},"comment_reply":{"type":["null","string"]},"comment_reply_variations":{"type":"array","items":{"type":"string"}},"public_reply_policy":{"type":"string"},"dm_delay_seconds":{"type":"integer"},"comment_reply_delay_seconds":{"type":"integer"},"link_tracking":{"type":"boolean"},"click_tag":{"type":["null","string"]},"also_match_in_dms":{"type":"boolean"},"audience":{"type":["null","object"],"properties":{"follower_status":{"type":"string"},"min_follower_count":{"type":["null","integer"]},"when_unknown":{"type":"string"},"tap_to_unlock":{"type":"boolean"}}},"follow_gate":{"type":["null","object"],"properties":{"message":{"type":["null","string"]},"button_label":{"type":["null","string"]},"not_following_message":{"type":["null","string"]}}},"repeat_policy":{"type":"object","properties":{"mode":{"type":"string"},"cooldown_hours":{"type":["null","integer"]}}},"dedupe_same_text_hours":{"type":["null","integer"]},"actions":{"type":"object","properties":{"like_comment":{"type":"boolean"},"hide_comment":{"type":"boolean"}}},"is_active":{"type":"boolean"},"stats":{"type":"object","properties":{"triggered":{"type":"integer"},"dms_sent":{"type":"integer"},"dms_failed":{"type":"integer"},"unique_contacts":{"type":"integer"},"public_replies_sent":{"type":"integer"},"tracked_sends":{"type":"integer"},"link_clicks":{"type":"integer"},"unique_clicks":{"type":"integer"},"delivered":{"type":"integer"},"read":{"type":"integer"},"audience_skipped":{"type":"integer"},"follow_gate_sent":{"type":"integer"},"follow_gate_passed":{"type":"integer"},"follow_gate_failed":{"type":"integer"}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createCommentAutomation","summary":"Create a comment automation","tags":["Comment Automations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["account_id","name"],"properties":{"profile_id":{"type":"string"},"account_id":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":200},"trigger":{"type":"string","enum":["comment","live_comment","story_reply","story_mention"]},"platform_post_id":{"type":["string","null"],"maxLength":255},"post_id":{"type":["string","null"]},"post_title":{"type":["string","null"],"maxLength":300},"keywords":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":100}},"match_mode":{"type":"string","enum":["contains","word","exact"]},"exclude_keywords":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":100}},"typo_tolerance":{"type":"boolean"},"dm_message":{"type":["string","null"],"maxLength":1000},"dm_message_variations":{"type":"array","maxItems":5,"items":{"type":"string","maxLength":1000}},"buttons":{"type":["array","null"],"maxItems":3,"items":{"type":"object","additionalProperties":false,"required":["type","title"],"properties":{"type":{"type":"string","enum":["url","postback","phone"]},"title":{"type":"string","minLength":1,"maxLength":20},"url":{"type":"string","maxLength":2048},"payload":{"type":"string","maxLength":1000},"phone":{"type":"string","maxLength":32}}}},"template":{"type":["object","null"],"additionalProperties":false,"required":["type","elements"],"properties":{"type":{"type":"string","enum":["generic"]},"image_aspect_ratio":{"type":"string","enum":["horizontal","square"]},"elements":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["title"],"properties":{"title":{"type":"string","minLength":1,"maxLength":80},"subtitle":{"type":"string","maxLength":80},"image_url":{"type":"string","maxLength":2048},"buttons":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":false,"required":["type","title"],"properties":{"type":{"type":"string","enum":["url","postback","phone"]},"title":{"type":"string","minLength":1,"maxLength":20},"url":{"type":"string","maxLength":2048},"payload":{"type":"string","maxLength":1000},"phone":{"type":"string","maxLength":32}}}}}}}}},"quick_replies":{"type":["array","null"],"maxItems":13,"items":{"type":"object","additionalProperties":false,"required":["title","payload"],"properties":{"title":{"type":"string","minLength":1,"maxLength":20},"payload":{"type":"string","maxLength":1000},"image_url":{"type":"string","maxLength":2048}}}},"dm_media":{"type":["object","null"],"additionalProperties":false,"required":["type","url"],"properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":"string","maxLength":2048}}},"comment_reply":{"type":["string","null"],"maxLength":2000},"comment_reply_variations":{"type":"array","maxItems":5,"items":{"type":"string","maxLength":2000}},"public_reply_policy":{"type":"string","enum":["after_dm","always"]},"dm_delay_seconds":{"type":"integer","minimum":0,"maximum":86400},"comment_reply_delay_seconds":{"type":"integer","minimum":0,"maximum":86400},"link_tracking":{"type":"boolean"},"click_tag":{"type":["string","null"],"maxLength":64},"also_match_in_dms":{"type":"boolean"},"audience":{"type":["object","null"],"additionalProperties":false,"properties":{"follower_status":{"type":"string","enum":["any","follower","non_follower"]},"min_follower_count":{"type":"integer","minimum":0},"when_unknown":{"type":"string","enum":["send","skip","verify"]},"tap_to_unlock":{"type":"boolean"}}},"follow_gate":{"type":["object","null"],"additionalProperties":false,"properties":{"message":{"type":"string","maxLength":640},"button_label":{"type":"string","maxLength":20},"not_following_message":{"type":"string","maxLength":1000}}},"repeat_policy":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["once","every_comment"]},"cooldown_hours":{"type":["integer","null"],"minimum":1,"maximum":8760}}},"dedupe_same_text_hours":{"type":["integer","null"],"minimum":1,"maximum":8760},"actions":{"type":"object","additionalProperties":false,"properties":{"like_comment":{"type":"boolean"},"hide_comment":{"type":"boolean"}}},"is_active":{"type":"boolean"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"comment_automations","x-mcp-tool":"create-comment-automation","x-idempotent":true,"x-feature":"automations","x-zernio":["POST /v1/comment-automations"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment_automation"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"trigger":{"type":"string"},"platform_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"post_title":{"type":["null","string"]},"keywords":{"type":"array","items":{"type":"string"}},"match_mode":{"type":"string"},"exclude_keywords":{"type":"array","items":{"type":"string"}},"typo_tolerance":{"type":"boolean"},"dm_message":{"type":["null","string"]},"dm_message_variations":{"type":"array","items":{"type":"string"}},"buttons":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"url":{"type":["null","string"]},"payload":{"type":["null","string"]},"phone":{"type":["null","string"]}}}},"template":{"type":["null","object"],"additionalProperties":true},"quick_replies":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"payload":{"type":["null","string"]},"image_url":{"type":["null","string"]}}}},"dm_media":{"type":["null","object"],"properties":{"type":{"type":"string"},"url":{"type":"string"}}},"comment_reply":{"type":["null","string"]},"comment_reply_variations":{"type":"array","items":{"type":"string"}},"public_reply_policy":{"type":"string"},"dm_delay_seconds":{"type":"integer"},"comment_reply_delay_seconds":{"type":"integer"},"link_tracking":{"type":"boolean"},"click_tag":{"type":["null","string"]},"also_match_in_dms":{"type":"boolean"},"audience":{"type":["null","object"],"properties":{"follower_status":{"type":"string"},"min_follower_count":{"type":["null","integer"]},"when_unknown":{"type":"string"},"tap_to_unlock":{"type":"boolean"}}},"follow_gate":{"type":["null","object"],"properties":{"message":{"type":["null","string"]},"button_label":{"type":["null","string"]},"not_following_message":{"type":["null","string"]}}},"repeat_policy":{"type":"object","properties":{"mode":{"type":"string"},"cooldown_hours":{"type":["null","integer"]}}},"dedupe_same_text_hours":{"type":["null","integer"]},"actions":{"type":"object","properties":{"like_comment":{"type":"boolean"},"hide_comment":{"type":"boolean"}}},"is_active":{"type":"boolean"},"stats":{"type":"object","properties":{"triggered":{"type":"integer"},"dms_sent":{"type":"integer"},"dms_failed":{"type":"integer"},"unique_contacts":{"type":"integer"},"public_replies_sent":{"type":"integer"},"tracked_sends":{"type":"integer"},"link_clicks":{"type":"integer"},"unique_clicks":{"type":"integer"},"delivered":{"type":"integer"},"read":{"type":"integer"},"audience_skipped":{"type":"integer"},"follow_gate_sent":{"type":"integer"},"follow_gate_passed":{"type":"integer"},"follow_gate_failed":{"type":"integer"}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/comment-automations/{id}":{"get":{"operationId":"getCommentAutomation","summary":"Get a comment automation","tags":["Comment Automations"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"cau_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"commentAutomation id (cau_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"comment_automations","x-mcp-tool":"get-comment-automation","x-feature":"automations","x-zernio":["GET /v1/comment-automations/{automationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment_automation"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"trigger":{"type":"string"},"platform_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"post_title":{"type":["null","string"]},"keywords":{"type":"array","items":{"type":"string"}},"match_mode":{"type":"string"},"exclude_keywords":{"type":"array","items":{"type":"string"}},"typo_tolerance":{"type":"boolean"},"dm_message":{"type":["null","string"]},"dm_message_variations":{"type":"array","items":{"type":"string"}},"buttons":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"url":{"type":["null","string"]},"payload":{"type":["null","string"]},"phone":{"type":["null","string"]}}}},"template":{"type":["null","object"],"additionalProperties":true},"quick_replies":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"payload":{"type":["null","string"]},"image_url":{"type":["null","string"]}}}},"dm_media":{"type":["null","object"],"properties":{"type":{"type":"string"},"url":{"type":"string"}}},"comment_reply":{"type":["null","string"]},"comment_reply_variations":{"type":"array","items":{"type":"string"}},"public_reply_policy":{"type":"string"},"dm_delay_seconds":{"type":"integer"},"comment_reply_delay_seconds":{"type":"integer"},"link_tracking":{"type":"boolean"},"click_tag":{"type":["null","string"]},"also_match_in_dms":{"type":"boolean"},"audience":{"type":["null","object"],"properties":{"follower_status":{"type":"string"},"min_follower_count":{"type":["null","integer"]},"when_unknown":{"type":"string"},"tap_to_unlock":{"type":"boolean"}}},"follow_gate":{"type":["null","object"],"properties":{"message":{"type":["null","string"]},"button_label":{"type":["null","string"]},"not_following_message":{"type":["null","string"]}}},"repeat_policy":{"type":"object","properties":{"mode":{"type":"string"},"cooldown_hours":{"type":["null","integer"]}}},"dedupe_same_text_hours":{"type":["null","integer"]},"actions":{"type":"object","properties":{"like_comment":{"type":"boolean"},"hide_comment":{"type":"boolean"}}},"is_active":{"type":"boolean"},"stats":{"type":"object","properties":{"triggered":{"type":"integer"},"dms_sent":{"type":"integer"},"dms_failed":{"type":"integer"},"unique_contacts":{"type":"integer"},"public_replies_sent":{"type":"integer"},"tracked_sends":{"type":"integer"},"link_clicks":{"type":"integer"},"unique_clicks":{"type":"integer"},"delivered":{"type":"integer"},"read":{"type":"integer"},"audience_skipped":{"type":"integer"},"follow_gate_sent":{"type":"integer"},"follow_gate_passed":{"type":"integer"},"follow_gate_failed":{"type":"integer"}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateCommentAutomation","summary":"Update a comment automation","tags":["Comment Automations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"trigger":{"type":"string","enum":["comment","live_comment","story_reply","story_mention"]},"platform_post_id":{"type":["string","null"],"maxLength":255},"post_id":{"type":["string","null"]},"post_title":{"type":["string","null"],"maxLength":300},"keywords":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":100}},"match_mode":{"type":"string","enum":["contains","word","exact"]},"exclude_keywords":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":100}},"typo_tolerance":{"type":"boolean"},"dm_message":{"type":["string","null"],"maxLength":1000},"dm_message_variations":{"type":"array","maxItems":5,"items":{"type":"string","maxLength":1000}},"buttons":{"type":["array","null"],"maxItems":3,"items":{"type":"object","additionalProperties":false,"required":["type","title"],"properties":{"type":{"type":"string","enum":["url","postback","phone"]},"title":{"type":"string","minLength":1,"maxLength":20},"url":{"type":"string","maxLength":2048},"payload":{"type":"string","maxLength":1000},"phone":{"type":"string","maxLength":32}}}},"template":{"type":["object","null"],"additionalProperties":false,"required":["type","elements"],"properties":{"type":{"type":"string","enum":["generic"]},"image_aspect_ratio":{"type":"string","enum":["horizontal","square"]},"elements":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["title"],"properties":{"title":{"type":"string","minLength":1,"maxLength":80},"subtitle":{"type":"string","maxLength":80},"image_url":{"type":"string","maxLength":2048},"buttons":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":false,"required":["type","title"],"properties":{"type":{"type":"string","enum":["url","postback","phone"]},"title":{"type":"string","minLength":1,"maxLength":20},"url":{"type":"string","maxLength":2048},"payload":{"type":"string","maxLength":1000},"phone":{"type":"string","maxLength":32}}}}}}}}},"quick_replies":{"type":["array","null"],"maxItems":13,"items":{"type":"object","additionalProperties":false,"required":["title","payload"],"properties":{"title":{"type":"string","minLength":1,"maxLength":20},"payload":{"type":"string","maxLength":1000},"image_url":{"type":"string","maxLength":2048}}}},"dm_media":{"type":["object","null"],"additionalProperties":false,"required":["type","url"],"properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":"string","maxLength":2048}}},"comment_reply":{"type":["string","null"],"maxLength":2000},"comment_reply_variations":{"type":"array","maxItems":5,"items":{"type":"string","maxLength":2000}},"public_reply_policy":{"type":"string","enum":["after_dm","always"]},"dm_delay_seconds":{"type":"integer","minimum":0,"maximum":86400},"comment_reply_delay_seconds":{"type":"integer","minimum":0,"maximum":86400},"link_tracking":{"type":"boolean"},"click_tag":{"type":["string","null"],"maxLength":64},"also_match_in_dms":{"type":"boolean"},"audience":{"type":["object","null"],"additionalProperties":false,"properties":{"follower_status":{"type":"string","enum":["any","follower","non_follower"]},"min_follower_count":{"type":"integer","minimum":0},"when_unknown":{"type":"string","enum":["send","skip","verify"]},"tap_to_unlock":{"type":"boolean"}}},"follow_gate":{"type":["object","null"],"additionalProperties":false,"properties":{"message":{"type":"string","maxLength":640},"button_label":{"type":"string","maxLength":20},"not_following_message":{"type":"string","maxLength":1000}}},"repeat_policy":{"type":"object","additionalProperties":false,"required":["mode"],"properties":{"mode":{"type":"string","enum":["once","every_comment"]},"cooldown_hours":{"type":["integer","null"],"minimum":1,"maximum":8760}}},"dedupe_same_text_hours":{"type":["integer","null"],"minimum":1,"maximum":8760},"actions":{"type":"object","additionalProperties":false,"properties":{"like_comment":{"type":"boolean"},"hide_comment":{"type":"boolean"}}},"is_active":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"cau_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"commentAutomation id (cau_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"comment_automations","x-mcp-tool":"update-comment-automation","x-feature":"automations","x-zernio":["PATCH /v1/comment-automations/{automationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment_automation"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"platform":{"type":"string"},"name":{"type":"string"},"trigger":{"type":"string"},"platform_post_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"post_title":{"type":["null","string"]},"keywords":{"type":"array","items":{"type":"string"}},"match_mode":{"type":"string"},"exclude_keywords":{"type":"array","items":{"type":"string"}},"typo_tolerance":{"type":"boolean"},"dm_message":{"type":["null","string"]},"dm_message_variations":{"type":"array","items":{"type":"string"}},"buttons":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"url":{"type":["null","string"]},"payload":{"type":["null","string"]},"phone":{"type":["null","string"]}}}},"template":{"type":["null","object"],"additionalProperties":true},"quick_replies":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"payload":{"type":["null","string"]},"image_url":{"type":["null","string"]}}}},"dm_media":{"type":["null","object"],"properties":{"type":{"type":"string"},"url":{"type":"string"}}},"comment_reply":{"type":["null","string"]},"comment_reply_variations":{"type":"array","items":{"type":"string"}},"public_reply_policy":{"type":"string"},"dm_delay_seconds":{"type":"integer"},"comment_reply_delay_seconds":{"type":"integer"},"link_tracking":{"type":"boolean"},"click_tag":{"type":["null","string"]},"also_match_in_dms":{"type":"boolean"},"audience":{"type":["null","object"],"properties":{"follower_status":{"type":"string"},"min_follower_count":{"type":["null","integer"]},"when_unknown":{"type":"string"},"tap_to_unlock":{"type":"boolean"}}},"follow_gate":{"type":["null","object"],"properties":{"message":{"type":["null","string"]},"button_label":{"type":["null","string"]},"not_following_message":{"type":["null","string"]}}},"repeat_policy":{"type":"object","properties":{"mode":{"type":"string"},"cooldown_hours":{"type":["null","integer"]}}},"dedupe_same_text_hours":{"type":["null","integer"]},"actions":{"type":"object","properties":{"like_comment":{"type":"boolean"},"hide_comment":{"type":"boolean"}}},"is_active":{"type":"boolean"},"stats":{"type":"object","properties":{"triggered":{"type":"integer"},"dms_sent":{"type":"integer"},"dms_failed":{"type":"integer"},"unique_contacts":{"type":"integer"},"public_replies_sent":{"type":"integer"},"tracked_sends":{"type":"integer"},"link_clicks":{"type":"integer"},"unique_clicks":{"type":"integer"},"delivered":{"type":"integer"},"read":{"type":"integer"},"audience_skipped":{"type":"integer"},"follow_gate_sent":{"type":"integer"},"follow_gate_passed":{"type":"integer"},"follow_gate_failed":{"type":"integer"}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteCommentAutomation","summary":"Delete a comment automation","tags":["Comment Automations"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"cau_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"commentAutomation id (cau_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"comment_automations","x-mcp-tool":"delete-comment-automation","x-feature":"automations","x-zernio":["DELETE /v1/comment-automations/{automationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["comment_automation"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/comment-automations/{id}/logs":{"get":{"operationId":"listCommentAutomationLogs","summary":"List comment automation logs","tags":["Comment Automations"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"source","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"cau_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"commentAutomation id (cau_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"comment_automations","x-mcp-tool":"list-comment-automation-logs","x-feature":"automations","x-zernio":["GET /v1/comment-automations/{automationId}/logs"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["comment_automation_log"]},"id":{"type":"string"},"automation_id":{"type":"string"},"comment_id":{"type":"string"},"commenter_id":{"type":["null","string"]},"commenter_name":{"type":["null","string"]},"commenter_username":{"type":["null","string"]},"comment_text":{"type":["null","string"]},"source":{"type":"string"},"status":{"type":"string","enum":["pending","sent","failed","skipped","gated"]},"skip_reason":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"audience_outcome":{"type":["null","string"]},"commenter_is_follower":{"type":["null","boolean"]},"commenter_follower_count":{"type":["null","integer"]},"dm_message_id":{"type":["null","string"]},"error":{"type":["null","string"]},"platform_error":{"type":["null","object"],"properties":{"code":{"type":["null","integer"]},"subcode":{"type":["null","integer"]}}},"private_reply_consumed":{"type":["null","boolean"]},"comment_reply_status":{"type":["null","string"]},"comment_reply_error":{"type":["null","string"]},"public_reply_posted_at":{"type":["null","string"],"format":"date-time"},"like_skipped":{"type":["null","string"]},"hide_skipped":{"type":["null","string"]},"media_error":{"type":["null","string"]},"next_due_at":{"type":["null","string"],"format":"date-time"},"clicked_at":{"type":["null","string"],"format":"date-time"},"click_count":{"type":"integer"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/support/runs":{"get":{"operationId":"listSupportRuns","summary":"List a thread's support answers","tags":["Support Assistant"],"description":"With `thread_id`: the whole thread, oldest first. Without: every run of the workspace, newest first.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"thread_id","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"support","x-mcp-tool":"list-support-runs","x-zernio":["GET /v1/support/runs"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["support_run"]},"id":{"type":"string"},"thread_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","completed","needs_human","failed"]},"stop_reason":{"type":["null","string"]},"question":{"type":"string"},"answer":{"type":["null","string"]},"diagnosis":{"type":["null","object"],"properties":{"category":{"type":"string","enum":["account_connection","content_rejected","rate_limited","platform_issue","socialit_issue","billing","configuration","how_to","other"]},"cause":{"type":["null","string"]},"fix_steps":{"type":"array","items":{"type":"string"}},"docs_links":{"type":"array","items":{"type":"string"}},"who_must_act":{"type":"string","enum":["integrator","end_user","socialit","platform","none"]}}},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"path":{"type":"string"},"url":{"type":["null","string"]}}}},"context":{"type":"object","properties":{"post_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"request_id":{"type":["null","string"]}}},"model":{"type":["null","string"]},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"cache_read_tokens":{"type":"integer"},"cache_write_tokens":{"type":"integer"}}},"cost_usd":{"type":"number"},"max_cost_usd":{"type":"number"},"support_ticket":{"type":["null","object"],"properties":{"opened_at":{"type":"string"}}},"poll_after_seconds":{"type":["null","integer"]},"created_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"finished_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"askSupportQuestion","summary":"Ask a support question","tags":["Support Assistant"],"description":"Returns 202 with a `queued` run. 503 `support_unavailable` when the server has no Anthropic API key; 409 `support_run_in_progress` (one active run per thread); 429 `support_active_runs_limit` (3 at once).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["message"],"properties":{"message":{"type":"string","minLength":1,"maxLength":10000},"thread_id":{"type":"string","maxLength":80},"context":{"type":"object","additionalProperties":false,"properties":{"post_id":{"type":"string"},"account_id":{"type":"string"},"profile_id":{"type":"string"},"request_id":{"type":"string","maxLength":128}}},"max_cost_usd":{"type":"number","minimum":0.05,"maximum":3}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"support","x-mcp-tool":"ask-support-question","x-idempotent":true,"x-rate-limit":{"max":20,"timeWindow":"1 minute"},"x-zernio":["POST /v1/support/runs"],"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["support_run"]},"id":{"type":"string"},"thread_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","completed","needs_human","failed"]},"stop_reason":{"type":["null","string"]},"question":{"type":"string"},"answer":{"type":["null","string"]},"diagnosis":{"type":["null","object"],"properties":{"category":{"type":"string","enum":["account_connection","content_rejected","rate_limited","platform_issue","socialit_issue","billing","configuration","how_to","other"]},"cause":{"type":["null","string"]},"fix_steps":{"type":"array","items":{"type":"string"}},"docs_links":{"type":"array","items":{"type":"string"}},"who_must_act":{"type":"string","enum":["integrator","end_user","socialit","platform","none"]}}},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"path":{"type":"string"},"url":{"type":["null","string"]}}}},"context":{"type":"object","properties":{"post_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"request_id":{"type":["null","string"]}}},"model":{"type":["null","string"]},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"cache_read_tokens":{"type":"integer"},"cache_write_tokens":{"type":"integer"}}},"cost_usd":{"type":"number"},"max_cost_usd":{"type":"number"},"support_ticket":{"type":["null","object"],"properties":{"opened_at":{"type":"string"}}},"poll_after_seconds":{"type":["null","integer"]},"created_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"finished_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/support/runs/{id}":{"get":{"operationId":"getSupportRun","summary":"Get a support answer","tags":["Support Assistant"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"srun_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"id","required":true,"description":"supportRun id (srun_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"support","x-mcp-tool":"get-support-run","x-zernio":["GET /v1/support/runs/{runId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["support_run"]},"id":{"type":"string"},"thread_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","completed","needs_human","failed"]},"stop_reason":{"type":["null","string"]},"question":{"type":"string"},"answer":{"type":["null","string"]},"diagnosis":{"type":["null","object"],"properties":{"category":{"type":"string","enum":["account_connection","content_rejected","rate_limited","platform_issue","socialit_issue","billing","configuration","how_to","other"]},"cause":{"type":["null","string"]},"fix_steps":{"type":"array","items":{"type":"string"}},"docs_links":{"type":"array","items":{"type":"string"}},"who_must_act":{"type":"string","enum":["integrator","end_user","socialit","platform","none"]}}},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"path":{"type":"string"},"url":{"type":["null","string"]}}}},"context":{"type":"object","properties":{"post_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"request_id":{"type":["null","string"]}}},"model":{"type":["null","string"]},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"},"cache_read_tokens":{"type":"integer"},"cache_write_tokens":{"type":"integer"}}},"cost_usd":{"type":"number"},"max_cost_usd":{"type":"number"},"support_ticket":{"type":["null","object"],"properties":{"opened_at":{"type":"string"}}},"poll_after_seconds":{"type":["null","integer"]},"created_at":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"finished_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{connectionId}":{"patch":{"operationId":"updateAdConnection","summary":"Update an ads connection","tags":["Ads: accounts & measurement"],"description":"Changes the local label of an ads connection or moves it (and its ad accounts) to another profile.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":["string","null"],"maxLength":100},"profile_id":{"type":["string","null"],"maxLength":80}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-ad-connection","x-feature":"ads","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_connection"]},"id":{"type":"string"},"platform":{"type":"string"},"connect_flow":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"social_account_id":{"type":["null","string"]},"external_user_id":{"type":"string"},"name":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect","disconnected"]},"scopes":{"type":"array","items":{"type":"string"}},"token_expires_at":{"type":["null","string"],"format":"date-time"},"metadata":{"type":"object","additionalProperties":true},"ad_account_count":{"type":"integer"},"sync":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"},"initial_sync_completed_at":{"type":["null","string"],"format":"date-time"}}},"last_discovered_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{connectionId}/discover":{"post":{"operationId":"discoverAdConnectionAccounts","summary":"Re-discover ad accounts","tags":["Ads: accounts & measurement"],"description":"Lists the ad accounts the connection reaches on the network now: new ones are added (selected), vanished ones become closed.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads_measurement","x-mcp-tool":"discover-ad-connection-accounts","x-feature":"ads","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account"]},"id":{"type":"string"},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":"string"},"external_id":{"type":"string"},"name":{"type":["null","string"]},"currency":{"type":["null","string"]},"timezone":{"type":["null","string"]},"status":{"type":"string"},"platform_status":{"type":["null","string"]},"business_id":{"type":["null","string"]},"business_name":{"type":["null","string"]},"manager_customer_id":{"type":["null","string"]},"is_manager":{"type":"boolean"},"is_test":{"type":"boolean"},"selected":{"type":"boolean"},"selectable":{"type":"boolean"},"unusable_reason":{"type":["null","string"]},"billing_status":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"last_discovered_at":{"type":["null","string"],"format":"date-time"},"last_synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{connectionId}/businesses":{"get":{"operationId":"listAdBusinesses","summary":"List business portfolios","tags":["Ads: accounts & measurement"],"description":"Meta business portfolios the connected user belongs to, with their verification status.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-businesses","x-feature":"ads","x-zernio":["GET /v1/ads/businesses"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["business"]},"id":{"type":"string"},"name":{"type":["null","string"]},"verification_status":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"permitted_tasks":{"type":"array","items":{"type":"string"}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{connectionId}/businesses/{businessId}/users":{"get":{"operationId":"listAdBusinessUsers","summary":"List business users","tags":["Ads: accounts & measurement"],"description":"People and system users of a Meta business portfolio (the ids to assign to Pages, ad accounts and pixels).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"businessId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-business-users","x-feature":"ads","x-zernio":["GET /v1/ads/businesses/users"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["business_user"]},"id":{"type":"string"},"name":{"type":["null","string"]},"email":{"type":["null","string"]},"role":{"type":["null","string"]},"type":{"type":"string"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{connectionId}/business-centers":{"get":{"operationId":"listAdBusinessCenters","summary":"List TikTok Business Centers","tags":["Ads: accounts & measurement"],"description":"The TikTok Business Centers the connection can read, with their advertiser counts.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-business-centers","x-feature":"ads","x-zernio":["GET /v1/ads/business-centers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["business_center"]},"id":{"type":"string"},"name":{"type":["null","string"]},"advertiser_count":{"type":["null","integer"]},"role":{"type":["null","string"]}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{connectionId}/pages/{pageId}/users":{"get":{"operationId":"listAdPageUsers","summary":"List Page users","tags":["Ads: accounts & measurement"],"description":"People of a business portfolio assigned to a Facebook Page.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"pageId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-page-users","x-feature":"ads","x-zernio":["GET /v1/ads/page-users"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["page_user"]},"id":{"type":"string"},"page_id":{"type":"string"},"name":{"type":["null","string"]},"tasks":{"type":"array","items":{"type":"string"}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"assignAdPageUser","summary":"Assign a user to a Page","tags":["Ads: accounts & measurement"],"description":"Gives a business user tasks on a Facebook Page (replaces their task set). ADVERTISE is what ad creation needs.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"business_id":{"type":"string","minLength":1,"maxLength":64},"user_id":{"type":"string","minLength":1,"maxLength":64},"tasks":{"type":"array","items":{"type":"string","enum":["MANAGE","CREATE_CONTENT","MODERATE","MESSAGING","ADVERTISE","ANALYZE"]},"minItems":1}},"required":["business_id","user_id","tasks"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"pageId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"assign-ad-page-user","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/page-users"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["page_user"]},"id":{"type":"string"},"page_id":{"type":"string"},"name":{"type":["null","string"]},"tasks":{"type":"array","items":{"type":"string"}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{connectionId}/pages/{pageId}/users/{userId}":{"delete":{"operationId":"removeAdPageUser","summary":"Remove a user from a Page","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"pageId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"userId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"remove-ad-page-user","x-feature":"ads","x-zernio":["DELETE /v1/ads/page-users"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["page_user"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{connectionId}/hierarchy":{"get":{"operationId":"getAdManagerHierarchy","summary":"Get the Google Ads manager hierarchy","tags":["Ads: accounts & measurement"],"description":"Live manager (MCC) and client tree of a Google Ads connection, with pending invitations and link status.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-ad-manager-hierarchy","x-feature":"ads","x-zernio":["GET /v1/ads/accounts/hierarchy"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["manager_hierarchy"]},"connection_id":{"type":"string"},"roots":{"type":"array","items":{"type":"object","properties":{"customer_id":{"type":"string"},"name":{"type":["null","string"]},"currency":{"type":["null","string"]},"time_zone":{"type":["null","string"]},"manager":{"type":"boolean"},"test_account":{"type":"boolean"},"status":{"type":["null","string"]},"manager_links":{"type":"array","items":{"type":"object","properties":{"manager_customer_id":{"type":["null","string"]},"manager_link_id":{"type":["null","string"]},"status":{"type":"string"}}}},"clients":{"type":"array","items":{"type":"object","properties":{"customer_id":{"type":"string"},"name":{"type":["null","string"]},"currency":{"type":["null","string"]},"time_zone":{"type":["null","string"]},"manager":{"type":"boolean"},"test_account":{"type":"boolean"},"hidden":{"type":"boolean"},"level":{"type":"integer"},"status":{"type":["null","string"]},"parent_customer_id":{"type":["null","string"]},"manager_link_id":{"type":["null","string"]},"link_status":{"type":["null","string"]}}}}}}},"direct_customers":{"type":"array","items":{"type":"object","properties":{"customer_id":{"type":"string"},"manager":{"type":"boolean"},"pending_invitations":{"type":"array","items":{"type":"object","properties":{"manager_customer_id":{"type":["null","string"]},"manager_link_id":{"type":["null","string"]}}}}}}},"unavailable":{"type":"array","items":{"type":"object","properties":{"customer_id":{"type":"string"},"reason":{"type":"string"}}}},"truncated":{"type":"boolean"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{connectionId}/manager-links":{"post":{"operationId":"createAdManagerLink","summary":"Invite a client account to a manager","tags":["Ads: accounts & measurement"],"description":"Sends a manager-to-client link invitation (Google Ads). The link stays PENDING until the client accepts.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"manager_customer_id":{"type":"string","minLength":1,"maxLength":20},"client_customer_id":{"type":"string","minLength":1,"maxLength":20},"validate_only":{"type":"boolean"}},"required":["manager_customer_id","client_customer_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-ad-manager-link","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/accounts/manager-links"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["manager_link"]},"manager_customer_id":{"type":"string"},"client_customer_id":{"type":"string"},"manager_link_id":{"type":["null","string"]},"status":{"type":"string"},"validate_only":{"type":"boolean"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{connectionId}/manager-links/{managerLinkId}":{"patch":{"operationId":"updateAdManagerLink","summary":"Accept, decline, cancel or end a manager link","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"manager_customer_id":{"type":"string","minLength":1,"maxLength":20},"client_customer_id":{"type":"string","minLength":1,"maxLength":20},"action":{"type":"string","enum":["accept","decline","cancel","unlink"]},"validate_only":{"type":"boolean"}},"required":["manager_customer_id","client_customer_id","action"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"adc_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"connectionId","required":true,"description":"Ads connection id (adc_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"managerLinkId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-ad-manager-link","x-feature":"ads","x-zernio":["PATCH /v1/ads/accounts/manager-links"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["manager_link"]},"manager_customer_id":{"type":"string"},"client_customer_id":{"type":"string"},"manager_link_id":{"type":["null","string"]},"status":{"type":"string"},"validate_only":{"type":"boolean"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts":{"get":{"operationId":"listAdAccounts","summary":"List ad accounts","tags":["Ads: accounts & measurement"],"description":"The platform ad accounts reached by the workspace ads connections. `refresh=true` re-discovers the matching connections live first.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"in":"query","name":"connection_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string","enum":["active","pending","disabled","closed","unknown"]},"in":"query","name":"status","required":false},{"schema":{"type":"boolean"},"in":"query","name":"selected","required":false},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"query","name":"external_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"query","name":"search","required":false},{"schema":{"type":"boolean"},"in":"query","name":"refresh","required":false},{"schema":{"type":"boolean"},"in":"query","name":"in_scope_only","required":false},{"schema":{"type":"string","enum":["name","created_at","platform","status"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-accounts","x-feature":"ads","x-zernio":["GET /v1/ads/accounts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account"]},"id":{"type":"string"},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":"string"},"external_id":{"type":"string"},"name":{"type":["null","string"]},"currency":{"type":["null","string"]},"timezone":{"type":["null","string"]},"status":{"type":"string"},"platform_status":{"type":["null","string"]},"business_id":{"type":["null","string"]},"business_name":{"type":["null","string"]},"manager_customer_id":{"type":["null","string"]},"is_manager":{"type":"boolean"},"is_test":{"type":"boolean"},"selected":{"type":"boolean"},"selectable":{"type":"boolean"},"unusable_reason":{"type":["null","string"]},"billing_status":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"last_discovered_at":{"type":["null","string"],"format":"date-time"},"last_synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAdAccount","summary":"Create a Meta ad account","tags":["Ads: accounts & measurement"],"description":"Creates an ad account in a Meta business portfolio (a payment method must then be added in Ads Manager).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"connection_id":{"type":"string","minLength":1,"maxLength":80},"business_id":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","minLength":1,"maxLength":100},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"timezone_id":{"type":"integer","minimum":0},"end_advertiser":{"type":"string","minLength":1,"maxLength":64},"media_agency":{"type":"string","minLength":1,"maxLength":64},"partner":{"type":"string","minLength":1,"maxLength":64},"invoice":{"type":"boolean"},"invoice_group_id":{"type":"string","minLength":1,"maxLength":64},"invoicing_emails":{"type":"array","items":{"type":"string","format":"email"},"maxItems":20},"io":{"type":"boolean"},"po_number":{"type":"string","minLength":1,"maxLength":64},"funding_id":{"type":"string","minLength":1,"maxLength":64}},"required":["connection_id","business_id","name","currency","timezone_id"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-ad-account","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/accounts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account"]},"id":{"type":"string"},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":"string"},"external_id":{"type":"string"},"name":{"type":["null","string"]},"currency":{"type":["null","string"]},"timezone":{"type":["null","string"]},"status":{"type":"string"},"platform_status":{"type":["null","string"]},"business_id":{"type":["null","string"]},"business_name":{"type":["null","string"]},"manager_customer_id":{"type":["null","string"]},"is_manager":{"type":"boolean"},"is_test":{"type":"boolean"},"selected":{"type":"boolean"},"selectable":{"type":"boolean"},"unusable_reason":{"type":["null","string"]},"billing_status":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"last_discovered_at":{"type":["null","string"],"format":"date-time"},"last_synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"payment_method_required":{"type":"boolean"},"ads_manager_url":{"type":["null","string"]},"next_steps":{"type":["null","string"]},"warnings":{"type":"array","items":{"type":"string"}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/accounts/{adAccountId}":{"get":{"operationId":"getAdAccount","summary":"Get an ad account","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-ad-account","x-feature":"ads","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account"]},"id":{"type":"string"},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":"string"},"external_id":{"type":"string"},"name":{"type":["null","string"]},"currency":{"type":["null","string"]},"timezone":{"type":["null","string"]},"status":{"type":"string"},"platform_status":{"type":["null","string"]},"business_id":{"type":["null","string"]},"business_name":{"type":["null","string"]},"manager_customer_id":{"type":["null","string"]},"is_manager":{"type":"boolean"},"is_test":{"type":"boolean"},"selected":{"type":"boolean"},"selectable":{"type":"boolean"},"unusable_reason":{"type":["null","string"]},"billing_status":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"last_discovered_at":{"type":["null","string"],"format":"date-time"},"last_synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAdAccount","summary":"Select or move an ad account","tags":["Ads: accounts & measurement"],"description":"Local settings: `selected` (managed, synced, billed) and `profile_id`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"selected":{"type":"boolean"},"profile_id":{"type":["string","null"],"maxLength":80}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-ad-account","x-feature":"ads","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account"]},"id":{"type":"string"},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"platform":{"type":"string"},"external_id":{"type":"string"},"name":{"type":["null","string"]},"currency":{"type":["null","string"]},"timezone":{"type":["null","string"]},"status":{"type":"string"},"platform_status":{"type":["null","string"]},"business_id":{"type":["null","string"]},"business_name":{"type":["null","string"]},"manager_customer_id":{"type":["null","string"]},"is_manager":{"type":"boolean"},"is_test":{"type":"boolean"},"selected":{"type":"boolean"},"selectable":{"type":"boolean"},"unusable_reason":{"type":["null","string"]},"billing_status":{"type":"string"},"metadata":{"type":"object","additionalProperties":true},"last_discovered_at":{"type":["null","string"],"format":"date-time"},"last_synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/settings":{"patch":{"operationId":"updateAdAccountSettings","summary":"Update ad account settings on the network","tags":["Ads: accounts & measurement"],"description":"Meta: name, spend cap, amount-spent reset, default DSA beneficiary / payor. Google: account tracking template and final URL suffix.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"spend_cap":{"type":["number","null"],"minimum":0},"reset_amount_spent":{"type":"boolean"},"default_dsa_beneficiary":{"type":"string","minLength":1,"maxLength":512},"default_dsa_payor":{"type":"string","minLength":1,"maxLength":512},"tracking_url_template":{"type":"string","maxLength":2048},"final_url_suffix":{"type":"string","maxLength":2048}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-ad-account-settings","x-feature":"ads","x-zernio":["PATCH /v1/ads/accounts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account_settings"]},"ad_account_id":{"type":"string"},"platform":{"type":"string"},"name":{"type":["null","string"]},"spend_cap":{"type":["null","number"]},"url_tracking":{"type":["null","object"],"properties":{"tracking_url_template":{"type":["null","string"]},"final_url_suffix":{"type":["null","string"]}}},"dsa_defaults":{"type":["null","object"],"properties":{"beneficiary":{"type":["null","string"]},"payor":{"type":["null","string"]}}},"finance":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["ad_account_finance"]},"ad_account_id":{"type":"string"},"currency":{"type":["null","string"]},"balance":{"type":["null","number"]},"amount_spent":{"type":["null","number"]},"spend_cap":{"type":["null","number"]},"funding_source":{"type":["null","object"],"properties":{"display_string":{"type":["null","string"]},"type":{"type":["null","number"]}}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/finance":{"get":{"operationId":"getAdAccountFinance","summary":"Get ad account finances","tags":["Ads: accounts & measurement"],"description":"Balance, total spend, spend cap and funding source (Meta).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-ad-account-finance","x-feature":"ads","x-zernio":["GET /v1/ads/accounts/finance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account_finance"]},"ad_account_id":{"type":"string"},"currency":{"type":["null","string"]},"balance":{"type":["null","number"]},"amount_spent":{"type":["null","number"]},"spend_cap":{"type":["null","number"]},"funding_source":{"type":["null","object"],"properties":{"display_string":{"type":["null","string"]},"type":{"type":["null","number"]}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/live":{"get":{"operationId":"getAdAccountLive","summary":"Read campaigns and ad sets live","tags":["Ads: accounts & measurement"],"description":"Reads campaigns and ad sets straight from the network (Meta, TikTok), e.g. to check budgets before a write.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["campaign","ad_set"]},"in":"query","name":"level","required":false},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":4096},"in":"query","name":"campaigns_cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":4096},"in":"query","name":"ad_sets_cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-ad-account-live","x-feature":"ads","x-zernio":["GET /v1/ads/accounts/live"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account_live"]},"ad_account_id":{"type":"string"},"platform":{"type":"string"},"currency":{"type":["null","string"]},"read_at":{"type":["null","string"],"format":"date-time"},"campaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"platform_status":{"type":["null","string"]},"configured_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":"number"},"type":{"type":"string"}}},"daily_budget":{"type":["null","number"]},"lifetime_budget":{"type":["null","number"]},"budget_remaining":{"type":["null","number"]},"bid_strategy":{"type":["null","string"]},"spend_cap":{"type":["null","number"]}}}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"platform_status":{"type":["null","string"]},"configured_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":"number"},"type":{"type":"string"}}},"daily_budget":{"type":["null","number"]},"lifetime_budget":{"type":["null","number"]},"budget_remaining":{"type":["null","number"]},"bid_strategy":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"promoted_object":{"type":["null","object"],"additionalProperties":true},"targeting":{"type":["null","object"],"additionalProperties":true},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"}}}},"next_cursors":{"type":"object","properties":{"campaigns":{"type":["null","string"]},"ad_sets":{"type":["null","string"]}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/dsa-defaults":{"get":{"operationId":"getAdAccountDsaDefaults","summary":"Get DSA defaults","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-ad-account-dsa-defaults","x-feature":"ads","x-zernio":["GET /v1/ads/dsa-defaults"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["dsa_defaults"]},"ad_account_id":{"type":"string"},"beneficiary":{"type":["null","string"]},"payor":{"type":["null","string"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/dsa-recommendations":{"get":{"operationId":"getAdAccountDsaRecommendations","summary":"Get DSA recommendations","tags":["Ads: accounts & measurement"],"description":"Suggested beneficiary / payor names for EU DSA disclosures (never applied automatically).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-ad-account-dsa-recommendations","x-feature":"ads","x-zernio":["GET /v1/ads/dsa-recommendations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["dsa_recommendations"]},"ad_account_id":{"type":"string"},"recommendations":{"type":"array","items":{"type":"string"}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/users":{"get":{"operationId":"listAdAccountUsers","summary":"List ad account users","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-account-users","x-feature":"ads","x-zernio":["GET /v1/ads/accounts/users"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account_user"]},"id":{"type":"string"},"name":{"type":["null","string"]},"email":{"type":["null","string"]},"role":{"type":["null","string"]},"tasks":{"type":"array","items":{"type":"string"}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"assignAdAccountUser","summary":"Assign a user to an ad account","tags":["Ads: accounts & measurement"],"description":"MANAGE = admin, ADVERTISE creates ads, ANALYZE reads reports, DRAFT edits drafts. Replaces the user’s task set.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"user_id":{"type":"string","minLength":1,"maxLength":64},"tasks":{"type":"array","items":{"type":"string","enum":["MANAGE","ADVERTISE","ANALYZE","DRAFT"]},"minItems":1},"business_id":{"type":"string","minLength":1,"maxLength":64}},"required":["user_id","tasks"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"assign-ad-account-user","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/accounts/users"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account_user"]},"id":{"type":"string"},"name":{"type":["null","string"]},"email":{"type":["null","string"]},"role":{"type":["null","string"]},"tasks":{"type":"array","items":{"type":"string"}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/users/{userId}":{"delete":{"operationId":"removeAdAccountUser","summary":"Remove a user from an ad account","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"userId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"remove-ad-account-user","x-feature":"ads","x-zernio":["DELETE /v1/ads/accounts/users"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_account_user"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/activity":{"get":{"operationId":"listAdAccountActivity","summary":"Ad account change log","tags":["Ads: accounts & measurement"],"description":"Who changed what and when (Meta activities, Google change history: last 30 days).","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"object_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-account-activity","x-feature":"ads","x-zernio":["GET /v1/ads/activity"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_activity"]},"id":{"type":["null","string"]},"event_type":{"type":["null","string"]},"event_time":{"type":["null","string"],"format":"date-time"},"actor_id":{"type":["null","string"]},"actor_name":{"type":["null","string"]},"object_type":{"type":["null","string"]},"object_id":{"type":["null","string"]},"object_name":{"type":["null","string"]},"application_name":{"type":["null","string"]},"translated_event_type":{"type":["null","string"]},"extra_data":{"type":["null","object"],"additionalProperties":true}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/studies":{"get":{"operationId":"listAdStudies","summary":"List A/B tests and lift studies","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":2000},"in":"query","name":"fields","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-studies","x-feature":"ads","x-zernio":["GET /v1/ads/studies"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_study"]},"id":{"type":"string"},"name":{"type":["null","string"]},"type":{"type":["null","string"]},"description":{"type":["null","string"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"cells":{"type":"array","items":{"type":"object","additionalProperties":true}},"raw":{"type":"object","additionalProperties":true}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/instagram-accounts":{"get":{"operationId":"listAdInstagramAccounts","summary":"List Instagram ad identities","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-instagram-accounts","x-feature":"ads","x-zernio":["GET /v1/ads/instagram-accounts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_identities"]},"ad_account_id":{"type":"string"},"accounts":{"type":"array","items":{"type":"object","properties":{"ig_user_id":{"type":"string"},"username":{"type":["null","string"]},"profile_picture_url":{"type":["null","string"]},"is_page_backed":{"type":"boolean"},"source":{"type":"string"}}}},"pages":{"type":"array","items":{"type":"object","properties":{"page_id":{"type":"string"},"name":{"type":["null","string"]},"instagram_business_account":{"type":["null","object"],"properties":{"ig_user_id":{"type":"string"},"username":{"type":["null","string"]},"profile_picture_url":{"type":["null","string"]}}},"connected_instagram_account":{"type":["null","object"],"properties":{"ig_user_id":{"type":"string"},"username":{"type":["null","string"]},"profile_picture_url":{"type":["null","string"]}}}}}},"resolved":{"type":"object","properties":{"page_id":{"type":["null","string"]},"ig_user_id":{"type":["null","string"]},"source":{"type":["null","string"]}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/instagram-posts":{"get":{"operationId":"listAdInstagramPosts","summary":"List Instagram posts to boost","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"ig_user_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-instagram-posts","x-feature":"ads","x-zernio":["GET /v1/ads/instagram-posts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["instagram_post"]},"id":{"type":"string"},"caption":{"type":["null","string"]},"media_type":{"type":"string"},"media_url":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"]},"permalink":{"type":["null","string"]},"timestamp":{"type":["null","string"],"format":"date-time"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]},"ig_user_id":{"type":["null","string"]},"username":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/advertisable-applications":{"get":{"operationId":"listAdvertisableApplications","summary":"List advertisable apps","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-advertisable-applications","x-feature":"ads","x-zernio":["GET /v1/ads/advertisable-applications"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["advertisable_application"]},"id":{"type":"string"},"name":{"type":["null","string"]},"supported_platforms":{"type":"array","items":{"type":"string"}},"store_urls":{"type":"object","additionalProperties":true}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/ios-campaign-limits":{"get":{"operationId":"getIosCampaignLimits","summary":"Get iOS 14 campaign limits","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"application_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-ios-campaign-limits","x-feature":"ads","x-zernio":["GET /v1/ads/ios-fourteen-campaign-limits"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ios_campaign_limits"]},"application_id":{"type":"string"},"campaign_group_limit":{"type":["null","number"]},"campaign_limit":{"type":["null","number"]},"details":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/pixels":{"get":{"operationId":"listAdPixels","summary":"List TikTok pixels","tags":["Ads: accounts & measurement"],"description":"TikTok pixels with their supported optimization events.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"code","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-pixels","x-feature":"ads","x-zernio":["GET /v1/ads/pixels"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_pixel"]},"id":{"type":"string"},"code":{"type":["null","string"]},"name":{"type":["null","string"]},"events":{"type":"array","items":{"type":"string"}},"event_details":{"type":"array","items":{"type":"object","properties":{"name":{"type":["null","string"]},"optimization_event":{"type":["null","string"]},"custom":{"type":"boolean"}}}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/custom-conversions":{"get":{"operationId":"listCustomConversions","summary":"List custom conversions","tags":["Ads: accounts & measurement"],"description":"Meta custom conversions of the ad account, archived included.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-custom-conversions","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/custom-conversions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["custom_conversion"]},"id":{"type":"string"},"name":{"type":["null","string"]},"rule":{"type":["null","object"],"additionalProperties":true},"custom_event_type":{"type":["null","string"]},"pixel_id":{"type":["null","string"]},"is_archived":{"type":"boolean"},"default_conversion_value":{"type":["null","number"]},"reused":{"type":"boolean"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createCustomConversion","summary":"Create a custom conversion","tags":["Ads: accounts & measurement"],"description":"Creates a Meta custom conversion, or returns the existing non-archived one with the same name on the same pixel (`reused: true`, 200).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"pixel_id":{"type":"string","minLength":1,"maxLength":64},"custom_event_type":{"type":"string","minLength":1,"maxLength":64},"rule":{"type":"object","additionalProperties":true},"default_conversion_value":{"type":"number"}},"required":["name","pixel_id","custom_event_type","rule"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-custom-conversion","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/accounts/{accountId}/custom-conversions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["custom_conversion"]},"id":{"type":"string"},"name":{"type":["null","string"]},"rule":{"type":["null","object"],"additionalProperties":true},"custom_event_type":{"type":["null","string"]},"pixel_id":{"type":["null","string"]},"is_archived":{"type":"boolean"},"default_conversion_value":{"type":["null","number"]},"reused":{"type":"boolean"}},"required":["object"]}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["custom_conversion"]},"id":{"type":"string"},"name":{"type":["null","string"]},"rule":{"type":["null","object"],"additionalProperties":true},"custom_event_type":{"type":["null","string"]},"pixel_id":{"type":["null","string"]},"is_archived":{"type":"boolean"},"default_conversion_value":{"type":["null","number"]},"reused":{"type":"boolean"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/labels":{"get":{"operationId":"listAdLabels","summary":"List ad labels","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-labels","x-feature":"ads","x-zernio":["GET /v1/ads/labels"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_label"]},"id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"background_color":{"type":["null","string"]},"description":{"type":["null","string"]},"resource_name":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAdLabel","summary":"Create an ad label","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"background_color":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},"description":{"type":"string","minLength":1,"maxLength":200}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-ad-label","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/labels"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_label"]},"id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"background_color":{"type":["null","string"]},"description":{"type":["null","string"]},"resource_name":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/labels/{labelId}":{"patch":{"operationId":"updateAdLabel","summary":"Update an ad label","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"background_color":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},"description":{"type":"string","minLength":1,"maxLength":200}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"labelId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-ad-label","x-feature":"ads","x-zernio":["PATCH /v1/ads/labels/{labelId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_label"]},"id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"background_color":{"type":["null","string"]},"description":{"type":["null","string"]},"resource_name":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAdLabel","summary":"Remove an ad label","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"labelId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-ad-label","x-feature":"ads","x-zernio":["DELETE /v1/ads/labels/{labelId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_label"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/labels/{labelId}/assignments":{"post":{"operationId":"attachAdLabel","summary":"Attach a label","tags":["Ads: accounts & measurement"],"description":"Attaches a Google Ads label to campaigns, ad groups, ads and keywords; targets that already carry it count as unchanged.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"campaign_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":1000},"ad_set_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":1000},"ad_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":1000},"keyword_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":1000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"labelId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads_measurement","x-mcp-tool":"attach-ad-label","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/labels/{labelId}/assignments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["label_assignment_result"]},"label_id":{"type":"string"},"attached":{"type":"integer"},"detached":{"type":"integer"},"unchanged":{"type":"integer"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"detachAdLabel","summary":"Detach a label","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":10000},"in":"query","name":"campaign_ids","required":false,"description":"Comma separated ids"},{"schema":{"type":"string","maxLength":10000},"in":"query","name":"ad_set_ids","required":false,"description":"Comma separated ids"},{"schema":{"type":"string","maxLength":10000},"in":"query","name":"ad_ids","required":false,"description":"Comma separated ids"},{"schema":{"type":"string","maxLength":10000},"in":"query","name":"keyword_ids","required":false,"description":"Comma separated ids"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"labelId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"detach-ad-label","x-feature":"ads","x-zernio":["DELETE /v1/ads/labels/{labelId}/assignments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["label_assignment_result"]},"label_id":{"type":"string"},"attached":{"type":"integer"},"detached":{"type":"integer"},"unchanged":{"type":"integer"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/high-demand-periods":{"get":{"operationId":"listHighDemandPeriods","summary":"List high-demand periods","tags":["Ads: accounts & measurement"],"description":"Scheduled budget increases on a Meta campaign or ad set (exactly one of campaign_id / ad_set_id).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"ad_set_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-high-demand-periods","x-feature":"ads","x-zernio":["GET /v1/ads/high-demand-periods"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["high_demand_period"]},"id":{"type":"string"},"target_id":{"type":"string"},"budget_value":{"type":["null","number"]},"budget_value_type":{"type":["null","string"]},"time_start":{"type":["null","string"],"format":"date-time"},"time_end":{"type":["null","string"],"format":"date-time"},"recurrence_type":{"type":["null","string"]},"raw":{"type":"object","additionalProperties":true}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createHighDemandPeriod","summary":"Schedule a budget increase","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"campaign_id":{"type":"string","minLength":1,"maxLength":64},"ad_set_id":{"type":"string","minLength":1,"maxLength":64},"budget_value":{"type":"number","exclusiveMinimum":0},"budget_value_type":{"type":"string","enum":["ABSOLUTE","MULTIPLIER"]},"time_start":{"anyOf":[{"type":"string","maxLength":64},{"type":"integer"}],"description":"ISO 8601 date-time or unix seconds"},"time_end":{"anyOf":[{"type":"string","maxLength":64},{"type":"integer"}],"description":"ISO 8601 date-time or unix seconds"},"recurrence_type":{"type":"string","enum":["ONE_TIME","WEEKLY","MONTHLY"]}},"required":["budget_value","budget_value_type","time_start","time_end"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-high-demand-period","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/high-demand-periods"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["high_demand_period"]},"id":{"type":"string"},"target_id":{"type":"string"},"budget_value":{"type":["null","number"]},"budget_value_type":{"type":["null","string"]},"time_start":{"type":["null","string"],"format":"date-time"},"time_end":{"type":["null","string"],"format":"date-time"},"recurrence_type":{"type":["null","string"]},"raw":{"type":"object","additionalProperties":true}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/value-rule-sets":{"get":{"operationId":"listValueRuleSets","summary":"List value rule sets","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-value-rule-sets","x-feature":"ads","x-zernio":["GET /v1/ads/value-rule-sets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["value_rule_set"]},"id":{"type":"string"},"name":{"type":["null","string"]},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"adjust_sign":{"type":["null","string"]},"adjust_value":{"type":["null","number"]},"status":{"type":["null","string"]},"criteria":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"criteria_type":{"type":["null","string"]},"operator":{"type":["null","string"]},"criteria_values":{"type":"array","items":{"type":"string"}},"criteria_value_types":{"type":"array","items":{"type":"string"}}}}}}}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createValueRuleSet","summary":"Create a value rule set","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"rules":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","adjust_sign","adjust_value","criteria"],"properties":{"id":{"type":["string","null"],"maxLength":64},"name":{"type":"string","minLength":1,"maxLength":100},"adjust_sign":{"type":"string","enum":["INCREASE","DECREASE"]},"adjust_value":{"type":"integer","minimum":1,"maximum":1000},"status":{"type":"string","minLength":1,"maxLength":32},"criteria":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["criteria_type","criteria_values"],"properties":{"id":{"type":["string","null"],"maxLength":64},"criteria_type":{"type":"string","enum":["AGE","GENDER","OS_TYPE","DEVICE_PLATFORM","LOCATION","PLACEMENT","OMNI_CHANNEL","AUDIENCE_LABEL"]},"operator":{"type":"string","enum":["CONTAINS"]},"criteria_values":{"type":"array","items":{"type":"string"},"minItems":1},"criteria_value_types":{"type":"array","items":{"type":"string"}}}},"minItems":1}}},"minItems":1,"maxItems":50}},"required":["name","rules"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-value-rule-set","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/value-rule-sets"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["value_rule_set"]},"id":{"type":"string"},"name":{"type":["null","string"]},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"adjust_sign":{"type":["null","string"]},"adjust_value":{"type":["null","number"]},"status":{"type":["null","string"]},"criteria":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"criteria_type":{"type":["null","string"]},"operator":{"type":["null","string"]},"criteria_values":{"type":"array","items":{"type":"string"}},"criteria_value_types":{"type":"array","items":{"type":"string"}}}}}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/value-rule-sets/{valueRuleSetId}":{"get":{"operationId":"getValueRuleSet","summary":"Read a value rule set","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"valueRuleSetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-value-rule-set","x-feature":"ads","x-zernio":["GET /v1/ads/value-rule-sets/{valueRuleSetId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["value_rule_set"]},"id":{"type":"string"},"name":{"type":["null","string"]},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"adjust_sign":{"type":["null","string"]},"adjust_value":{"type":["null","number"]},"status":{"type":["null","string"]},"criteria":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"criteria_type":{"type":["null","string"]},"operator":{"type":["null","string"]},"criteria_values":{"type":"array","items":{"type":"string"}},"criteria_value_types":{"type":"array","items":{"type":"string"}}}}}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"replaceValueRuleSet","summary":"Replace a value rule set","tags":["Ads: accounts & measurement"],"description":"Full replace: keep a rule or criterion by echoing its id, omit it to delete it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"rules":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","adjust_sign","adjust_value","criteria"],"properties":{"id":{"type":["string","null"],"maxLength":64},"name":{"type":"string","minLength":1,"maxLength":100},"adjust_sign":{"type":"string","enum":["INCREASE","DECREASE"]},"adjust_value":{"type":"integer","minimum":1,"maximum":1000},"status":{"type":"string","minLength":1,"maxLength":32},"criteria":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["criteria_type","criteria_values"],"properties":{"id":{"type":["string","null"],"maxLength":64},"criteria_type":{"type":"string","enum":["AGE","GENDER","OS_TYPE","DEVICE_PLATFORM","LOCATION","PLACEMENT","OMNI_CHANNEL","AUDIENCE_LABEL"]},"operator":{"type":"string","enum":["CONTAINS"]},"criteria_values":{"type":"array","items":{"type":"string"},"minItems":1},"criteria_value_types":{"type":"array","items":{"type":"string"}}}},"minItems":1}}},"minItems":1,"maxItems":50}},"required":["name","rules"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"valueRuleSetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"replace-value-rule-set","x-feature":"ads","x-zernio":["PUT /v1/ads/value-rule-sets/{valueRuleSetId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["value_rule_set"]},"id":{"type":"string"},"name":{"type":["null","string"]},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"adjust_sign":{"type":["null","string"]},"adjust_value":{"type":["null","number"]},"status":{"type":["null","string"]},"criteria":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"criteria_type":{"type":["null","string"]},"operator":{"type":["null","string"]},"criteria_values":{"type":"array","items":{"type":"string"}},"criteria_value_types":{"type":"array","items":{"type":"string"}}}}}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteValueRuleSet","summary":"Delete a value rule set","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"valueRuleSetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-value-rule-set","x-feature":"ads","x-zernio":["DELETE /v1/ads/value-rule-sets/{valueRuleSetId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["value_rule_set"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/negative-keyword-lists":{"get":{"operationId":"listNegativeKeywordLists","summary":"List negative keyword lists","tags":["Ads: accounts & measurement"],"description":"Google Ads shared negative keyword lists.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-negative-keyword-lists","x-feature":"ads","x-zernio":["GET /v1/ads/accounts/negative-keyword-lists"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["negative_keyword_list"]},"id":{"type":"string"},"resource_name":{"type":["null","string"]},"name":{"type":["null","string"]},"member_count":{"type":"integer"},"reference_count":{"type":"integer"},"keywords":{"type":"array","items":{"type":"object","properties":{"criterion_id":{"type":"string"},"text":{"type":"string"},"match_type":{"type":"string"}}}},"created":{"type":"integer"},"removed":{"type":"integer"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createNegativeKeywordList","summary":"Create a negative keyword list","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":255},"keywords":{"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":80},"match_type":{"type":"string","enum":["exact","phrase","broad"]}}}]},"maxItems":5000}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-negative-keyword-list","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/accounts/negative-keyword-lists"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["negative_keyword_list"]},"id":{"type":"string"},"resource_name":{"type":["null","string"]},"name":{"type":["null","string"]},"member_count":{"type":"integer"},"reference_count":{"type":"integer"},"keywords":{"type":"array","items":{"type":"object","properties":{"criterion_id":{"type":"string"},"text":{"type":"string"},"match_type":{"type":"string"}}}},"created":{"type":"integer"},"removed":{"type":"integer"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}":{"get":{"operationId":"getNegativeKeywordList","summary":"Get a negative keyword list","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"listId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-negative-keyword-list","x-feature":"ads","x-zernio":["GET /v1/ads/accounts/negative-keyword-lists/{listId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["negative_keyword_list"]},"id":{"type":"string"},"resource_name":{"type":["null","string"]},"name":{"type":["null","string"]},"member_count":{"type":"integer"},"reference_count":{"type":"integer"},"keywords":{"type":"array","items":{"type":"object","properties":{"criterion_id":{"type":"string"},"text":{"type":"string"},"match_type":{"type":"string"}}}},"created":{"type":"integer"},"removed":{"type":"integer"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"renameNegativeKeywordList","summary":"Rename a negative keyword list","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":255}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"listId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"rename-negative-keyword-list","x-feature":"ads","x-zernio":["PUT /v1/ads/accounts/negative-keyword-lists/{listId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["negative_keyword_list"]},"id":{"type":"string"},"resource_name":{"type":["null","string"]},"name":{"type":["null","string"]},"member_count":{"type":"integer"},"reference_count":{"type":"integer"},"keywords":{"type":"array","items":{"type":"object","properties":{"criterion_id":{"type":"string"},"text":{"type":"string"},"match_type":{"type":"string"}}}},"created":{"type":"integer"},"removed":{"type":"integer"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteNegativeKeywordList","summary":"Delete a negative keyword list","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"listId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-negative-keyword-list","x-feature":"ads","x-zernio":["DELETE /v1/ads/accounts/negative-keyword-lists/{listId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["negative_keyword_list"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/negative-keyword-lists/{listId}/keywords":{"patch":{"operationId":"replaceNegativeKeywordListKeywords","summary":"Replace negative list keywords","tags":["Ads: accounts & measurement"],"description":"Diffs by normalized text + match type; `[]` clears the list. Affects every campaign using it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"keywords":{"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":80},"match_type":{"type":"string","enum":["exact","phrase","broad"]}}}]},"maxItems":5000}},"required":["keywords"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"listId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"replace-negative-keyword-list-keywords","x-feature":"ads","x-zernio":["PUT /v1/ads/accounts/negative-keyword-lists/{listId}/keywords"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["negative_keyword_list"]},"id":{"type":"string"},"resource_name":{"type":["null","string"]},"name":{"type":["null","string"]},"member_count":{"type":"integer"},"reference_count":{"type":"integer"},"keywords":{"type":"array","items":{"type":"object","properties":{"criterion_id":{"type":"string"},"text":{"type":"string"},"match_type":{"type":"string"}}}},"created":{"type":"integer"},"removed":{"type":"integer"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/callouts":{"get":{"operationId":"listAccountCallouts","summary":"List account callouts","tags":["Ads: accounts & measurement"],"description":"Google Ads callouts attached at account level.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-account-callouts","x-feature":"ads","x-zernio":["GET /v1/ads/accounts/callouts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["callout"]},"id":{"type":"string"},"status":{"type":["null","string"]},"resource_name":{"type":["null","string"]},"customer_asset_resource_name":{"type":["null","string"]},"text":{"type":"string"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"addAccountCallouts","summary":"Add account callouts","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"callouts":{"type":"array","items":{"type":"string","minLength":1,"maxLength":25},"minItems":1,"maxItems":20}},"required":["callouts"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"add-account-callouts","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/accounts/callouts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["callout"]},"id":{"type":"string"},"status":{"type":["null","string"]},"resource_name":{"type":["null","string"]},"customer_asset_resource_name":{"type":["null","string"]},"text":{"type":"string"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAccountCallouts","summary":"Update account callouts","tags":["Ads: accounts & measurement"],"description":"Edits existing callout assets in place (shared assets change everywhere they are used).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"updates":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["asset_id","text"],"properties":{"asset_id":{"type":"string","minLength":1,"maxLength":32},"text":{"type":"string","minLength":1,"maxLength":25}}},"minItems":1}},"required":["updates"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-account-callouts","x-feature":"ads","x-zernio":["PUT /v1/ads/accounts/callouts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["asset_update_result"]},"updated":{"type":"integer"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/callouts/{assetId}":{"delete":{"operationId":"removeAccountCallout","summary":"Remove an account callout","tags":["Ads: accounts & measurement"],"description":"Detaches it from the account level only; campaign and ad group attachments stay.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"assetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"remove-account-callout","x-feature":"ads","x-zernio":["DELETE /v1/ads/accounts/callouts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["callout"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/sitelinks":{"get":{"operationId":"listAccountSitelinks","summary":"List account sitelinks","tags":["Ads: accounts & measurement"],"description":"Google Ads sitelinks attached at account level.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-account-sitelinks","x-feature":"ads","x-zernio":["GET /v1/ads/accounts/sitelinks"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["sitelink"]},"id":{"type":"string"},"status":{"type":["null","string"]},"resource_name":{"type":["null","string"]},"customer_asset_resource_name":{"type":["null","string"]},"text":{"type":"string"},"link_url":{"type":["null","string"]},"description1":{"type":["null","string"]},"description2":{"type":["null","string"]}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"addAccountSitelinks","summary":"Add account sitelinks","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"sitelinks":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["text","link_url"],"properties":{"text":{"type":"string","minLength":1,"maxLength":25},"link_url":{"type":"string","format":"uri","maxLength":2048},"description1":{"type":"string","minLength":1,"maxLength":35},"description2":{"type":"string","minLength":1,"maxLength":35}}},"minItems":1,"maxItems":20}},"required":["sitelinks"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"add-account-sitelinks","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/accounts/sitelinks"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["sitelink"]},"id":{"type":"string"},"status":{"type":["null","string"]},"resource_name":{"type":["null","string"]},"customer_asset_resource_name":{"type":["null","string"]},"text":{"type":"string"},"link_url":{"type":["null","string"]},"description1":{"type":["null","string"]},"description2":{"type":["null","string"]}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAccountSitelinks","summary":"Update account sitelinks","tags":["Ads: accounts & measurement"],"description":"Edits existing sitelink assets in place (shared assets change everywhere they are used).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"updates":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["asset_id"],"properties":{"asset_id":{"type":"string","minLength":1,"maxLength":32},"text":{"type":"string","minLength":1,"maxLength":25},"link_url":{"type":"string","format":"uri","maxLength":2048},"description1":{"type":"string","minLength":1,"maxLength":35},"description2":{"type":"string","minLength":1,"maxLength":35}}},"minItems":1}},"required":["updates"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-account-sitelinks","x-feature":"ads","x-zernio":["PUT /v1/ads/accounts/sitelinks"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["asset_update_result"]},"updated":{"type":"integer"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/sitelinks/{assetId}":{"delete":{"operationId":"removeAccountSitelink","summary":"Remove an account sitelink","tags":["Ads: accounts & measurement"],"description":"Detaches it from the account level only; campaign and ad group attachments stay.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"assetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"remove-account-sitelink","x-feature":"ads","x-zernio":["DELETE /v1/ads/accounts/sitelinks"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sitelink"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/structured-snippets":{"get":{"operationId":"listAccountStructuredSnippets","summary":"List account structured snippets","tags":["Ads: accounts & measurement"],"description":"Google Ads structured snippets attached at account level.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-account-structured-snippets","x-feature":"ads","x-zernio":["GET /v1/ads/accounts/structured-snippets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["structured_snippet"]},"id":{"type":"string"},"status":{"type":["null","string"]},"resource_name":{"type":["null","string"]},"customer_asset_resource_name":{"type":["null","string"]},"header":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"addAccountStructuredSnippets","summary":"Add account structured snippets","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"structured_snippets":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["header","values"],"properties":{"header":{"type":"string","enum":["Amenities","Brands","Courses","Degree programs","Destinations","Featured hotels","Insurance coverage","Models","Neighborhoods","Service catalog","Shows","Styles","Types"]},"values":{"type":"array","items":{"type":"string","minLength":1,"maxLength":25},"minItems":3,"maxItems":10}}},"minItems":1,"maxItems":20}},"required":["structured_snippets"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"add-account-structured-snippets","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/accounts/structured-snippets"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["structured_snippet"]},"id":{"type":"string"},"status":{"type":["null","string"]},"resource_name":{"type":["null","string"]},"customer_asset_resource_name":{"type":["null","string"]},"header":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAccountStructuredSnippets","summary":"Update account structured snippets","tags":["Ads: accounts & measurement"],"description":"Edits existing structured snippet assets in place (shared assets change everywhere they are used).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"updates":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["asset_id"],"properties":{"asset_id":{"type":"string","minLength":1,"maxLength":32},"header":{"type":"string","enum":["Amenities","Brands","Courses","Degree programs","Destinations","Featured hotels","Insurance coverage","Models","Neighborhoods","Service catalog","Shows","Styles","Types"]},"values":{"type":"array","items":{"type":"string","minLength":1,"maxLength":25},"minItems":3,"maxItems":10}}},"minItems":1}},"required":["updates"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-account-structured-snippets","x-feature":"ads","x-zernio":["PUT /v1/ads/accounts/structured-snippets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["asset_update_result"]},"updated":{"type":"integer"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/structured-snippets/{assetId}":{"delete":{"operationId":"removeAccountStructuredSnippet","summary":"Remove an account structured snippet","tags":["Ads: accounts & measurement"],"description":"Detaches it from the account level only; campaign and ad group attachments stay.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"assetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"remove-account-structured-snippet","x-feature":"ads","x-zernio":["DELETE /v1/ads/accounts/structured-snippets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["structured_snippet"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{adId}/comments":{"get":{"operationId":"listAdComments","summary":"List comments on an ad","tags":["Ads: accounts & measurement"],"description":"Comments on the ad’s post, dark posts included (Meta: Facebook or Instagram placement; TikTok).","parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","enum":["facebook","instagram"]},"in":"query","name":"placement","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"adId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-ad-comments","x-feature":"ads","x-zernio":["GET /v1/ads/{adId}/comments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_comment"]},"id":{"type":"string"},"ad_id":{"type":"string"},"platform":{"type":"string"},"placement":{"type":["null","string"]},"parent_id":{"type":["null","string"]},"text":{"type":"string"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"hidden":{"type":"boolean"},"can_reply":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_delete":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{adId}/comments/{commentId}/reply":{"post":{"operationId":"replyAdComment","summary":"Reply to an ad comment","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"text":{"type":"string","minLength":1,"maxLength":500},"placement":{"type":"string","enum":["facebook","instagram"]}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"adId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"commentId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"reply-ad-comment","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/{adId}/comments/{commentId}/reply"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_comment"]},"id":{"type":"string"},"ad_id":{"type":"string"},"platform":{"type":"string"},"placement":{"type":["null","string"]},"parent_id":{"type":["null","string"]},"text":{"type":"string"},"author":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"username":{"type":["null","string"]}}},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"hidden":{"type":"boolean"},"can_reply":{"type":"boolean"},"can_hide":{"type":"boolean"},"can_delete":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{adId}/comments/{commentId}/hide":{"post":{"operationId":"hideAdComment","summary":"Hide or unhide an ad comment","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"hidden":{"type":"boolean"},"placement":{"type":"string","enum":["facebook","instagram"]}},"required":["hidden"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"adId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"commentId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads_measurement","x-mcp-tool":"hide-ad-comment","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/{adId}/comments/{commentId}/hide"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_comment"]},"id":{"type":"string"},"hidden":{"type":"boolean"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{adId}/comments/{commentId}":{"delete":{"operationId":"deleteAdComment","summary":"Delete an ad comment","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","enum":["facebook","instagram"]},"in":"query","name":"placement","required":false},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"adId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"commentId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-ad-comment","x-feature":"ads","x-zernio":["DELETE /v1/ads/{adId}/comments/{commentId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_comment"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{adId}/tracking-tags":{"get":{"operationId":"getAdTrackingParams","summary":"Get ad URL tracking params","tags":["Ads: accounts & measurement"],"description":"Click-URL tracking parameters (UTMs), not pixels: Meta creative url_tags, Google campaign tracking template / final URL suffix, LinkedIn Dynamic UTMs.","parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"adId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-ad-tracking-params","x-feature":"ads","x-zernio":["GET /v1/ads/{adId}/tracking-tags"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_tracking_params"]},"ad_id":{"type":"string"},"platform":{"type":"string"},"level":{"type":"string"},"url_tags":{"type":["null","string"]},"template_url_spec":{"type":["null","object"],"additionalProperties":true},"tracking_url_template":{"type":["null","string"]},"final_url_suffix":{"type":["null","string"]},"dynamic_value_parameters":{"type":["null","object"],"additionalProperties":true},"custom_value_parameters":{"type":["null","object"],"additionalProperties":true}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"setAdTrackingParams","summary":"Set ad URL tracking params","tags":["Ads: accounts & measurement"],"description":"Meta rebuilds the (immutable) creative with the new url_tags and repoints the ad.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"campaign_id":{"type":"string","minLength":1,"maxLength":64},"url_tags":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["key","value"],"properties":{"key":{"type":"string","minLength":1,"maxLength":100},"value":{"type":"string","maxLength":500}}},"maxItems":50},"creative":{"type":"object","additionalProperties":false,"required":["headline","body","call_to_action","link_url"],"properties":{"headline":{"type":"string","minLength":1,"maxLength":255},"body":{"type":"string","maxLength":5000},"call_to_action":{"type":"string","minLength":1,"maxLength":64},"link_url":{"type":"string","format":"uri","maxLength":2048},"image_url":{"type":"string","format":"uri","maxLength":2048},"video_url":{"type":"string","format":"uri","maxLength":2048},"video_id":{"type":"string","minLength":1,"maxLength":64}}},"tracking_url_template":{"type":"string","maxLength":2048},"final_url_suffix":{"type":"string","maxLength":2048},"dynamic_value_parameters":{"type":"object","additionalProperties":{"type":"string"}},"custom_value_parameters":{"type":"object","additionalProperties":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"adId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"set-ad-tracking-params","x-feature":"ads","x-zernio":["PATCH /v1/ads/{adId}/tracking-tags"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_tracking_params"]},"ad_id":{"type":"string"},"platform":{"type":"string"},"level":{"type":"string"},"url_tags":{"type":["null","string"]},"template_url_spec":{"type":["null","object"],"additionalProperties":true},"tracking_url_template":{"type":["null","string"]},"final_url_suffix":{"type":["null","string"]},"dynamic_value_parameters":{"type":["null","object"],"additionalProperties":true},"custom_value_parameters":{"type":["null","object"],"additionalProperties":true}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags":{"get":{"operationId":"listTrackingTags","summary":"List tracking tags","tags":["Ads: accounts & measurement"],"description":"Pixels and measurement tags of the ad account (install code omitted).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-tracking-tags","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/tracking-tags"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag"]},"id":{"type":"string"},"site_tag_id":{"type":["null","string"]},"platform":{"type":"string"},"kind":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"code":{"type":["null","string"]},"last_fired_at":{"type":["null","string"],"format":"date-time"},"is_unavailable":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"automatic_matching_fields":{"type":"array","items":{"type":"string"}},"owner_business_id":{"type":["null","string"]},"owner_ad_account_id":{"type":["null","string"]},"auto_tagging":{"type":["null","boolean"]},"events":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_event"]},"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["null","string"]},"site_event":{"type":["null","string"]},"site_event_id":{"type":["null","string"]},"status":{"type":["null","string"]},"default_value":{"type":["null","number"]},"currency":{"type":["null","string"]},"click_window_days":{"type":["null","number"]},"view_window_days":{"type":["null","number"]},"url_contains":{"type":["null","string"]},"always_use_default_value":{"type":["null","boolean"]},"primary":{"type":["null","boolean"]},"counting_type":{"type":["null","string"]}}}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createTrackingTag","summary":"Create a tracking tag","tags":["Ads: accounts & measurement"],"description":"Not idempotent on the networks: send an Idempotency-Key and never retry blindly.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"automatic_matching_fields":{"type":"array","items":{"type":"string","enum":["em","ph","fn","ln","ge","db","ct","st","zp","country","external_id"]}},"default_event_type":{"type":"string","minLength":1,"maxLength":64},"domain":{"type":"string","minLength":1,"maxLength":255},"partner_name":{"type":"string","minLength":1,"maxLength":64}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-tracking-tag","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/accounts/{accountId}/tracking-tags"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag"]},"id":{"type":"string"},"site_tag_id":{"type":["null","string"]},"platform":{"type":"string"},"kind":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"code":{"type":["null","string"]},"last_fired_at":{"type":["null","string"],"format":"date-time"},"is_unavailable":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"automatic_matching_fields":{"type":"array","items":{"type":"string"}},"owner_business_id":{"type":["null","string"]},"owner_ad_account_id":{"type":["null","string"]},"auto_tagging":{"type":["null","boolean"]},"events":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_event"]},"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["null","string"]},"site_event":{"type":["null","string"]},"site_event_id":{"type":["null","string"]},"status":{"type":["null","string"]},"default_value":{"type":["null","number"]},"currency":{"type":["null","string"]},"click_window_days":{"type":["null","number"]},"view_window_days":{"type":["null","number"]},"url_contains":{"type":["null","string"]},"always_use_default_value":{"type":["null","boolean"]},"primary":{"type":["null","boolean"]},"counting_type":{"type":["null","string"]}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags/{tagId}":{"get":{"operationId":"getTrackingTag","summary":"Get a tracking tag","tags":["Ads: accounts & measurement"],"description":"The tag with its install code and conversion events.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-tracking-tag","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/tracking-tags/{tagId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag"]},"id":{"type":"string"},"site_tag_id":{"type":["null","string"]},"platform":{"type":"string"},"kind":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"code":{"type":["null","string"]},"last_fired_at":{"type":["null","string"],"format":"date-time"},"is_unavailable":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"automatic_matching_fields":{"type":"array","items":{"type":"string"}},"owner_business_id":{"type":["null","string"]},"owner_ad_account_id":{"type":["null","string"]},"auto_tagging":{"type":["null","boolean"]},"events":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_event"]},"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["null","string"]},"site_event":{"type":["null","string"]},"site_event_id":{"type":["null","string"]},"status":{"type":["null","string"]},"default_value":{"type":["null","number"]},"currency":{"type":["null","string"]},"click_window_days":{"type":["null","number"]},"view_window_days":{"type":["null","number"]},"url_contains":{"type":["null","string"]},"always_use_default_value":{"type":["null","boolean"]},"primary":{"type":["null","boolean"]},"counting_type":{"type":["null","string"]}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateTrackingTag","summary":"Update a tracking tag","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"enable_automatic_matching":{"type":"boolean"},"automatic_matching_fields":{"type":"array","items":{"type":"string","enum":["em","ph","fn","ln","ge","db","ct","st","zp","country","external_id"]}},"first_party_cookie_status":{"type":"string","enum":["empty","first_party_cookie_disabled","first_party_cookie_enabled"]},"data_use_setting":{"type":"string","enum":["advertising_and_analytics","analytics_only","empty"]},"auto_tagging":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-tracking-tag","x-feature":"ads","x-zernio":["PATCH /v1/accounts/{accountId}/tracking-tags/{tagId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag"]},"id":{"type":"string"},"site_tag_id":{"type":["null","string"]},"platform":{"type":"string"},"kind":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"code":{"type":["null","string"]},"last_fired_at":{"type":["null","string"],"format":"date-time"},"is_unavailable":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"automatic_matching_fields":{"type":"array","items":{"type":"string"}},"owner_business_id":{"type":["null","string"]},"owner_ad_account_id":{"type":["null","string"]},"auto_tagging":{"type":["null","boolean"]},"events":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_event"]},"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["null","string"]},"site_event":{"type":["null","string"]},"site_event_id":{"type":["null","string"]},"status":{"type":["null","string"]},"default_value":{"type":["null","number"]},"currency":{"type":["null","string"]},"click_window_days":{"type":["null","number"]},"view_window_days":{"type":["null","number"]},"url_contains":{"type":["null","string"]},"always_use_default_value":{"type":["null","boolean"]},"primary":{"type":["null","boolean"]},"counting_type":{"type":["null","string"]}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags/{tagId}/shared-accounts":{"get":{"operationId":"listTrackingTagSharedAccounts","summary":"List accounts a tag is shared with","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-tracking-tag-shared-accounts","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/tracking-tags/{tagId}/shared-accounts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_shared_account"]},"id":{"type":"string"},"name":{"type":["null","string"]},"business_id":{"type":["null","string"]},"role":{"type":["null","string"]}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"shareTrackingTag","summary":"Share a tag with an ad account","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","minLength":1,"maxLength":256},"business_id":{"type":"string","minLength":1,"maxLength":64}},"required":["ad_account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"share-tracking-tag","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/accounts/{accountId}/tracking-tags/{tagId}/shared-accounts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_shared_account"]},"id":{"type":"string"},"name":{"type":["null","string"]},"business_id":{"type":["null","string"]},"role":{"type":["null","string"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags/{tagId}/shared-accounts/{sharedAccountId}":{"delete":{"operationId":"unshareTrackingTag","summary":"Stop sharing a tag with an account","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"sharedAccountId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"unshare-tracking-tag","x-feature":"ads","x-zernio":["DELETE /v1/accounts/{accountId}/tracking-tags/{tagId}/shared-accounts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_shared_account"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events":{"get":{"operationId":"listTrackingTagEvents","summary":"List conversion events of a tag","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-tracking-tag-events","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/tracking-tags/{tagId}/events"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_event"]},"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["null","string"]},"site_event":{"type":["null","string"]},"site_event_id":{"type":["null","string"]},"status":{"type":["null","string"]},"default_value":{"type":["null","number"]},"currency":{"type":["null","string"]},"click_window_days":{"type":["null","number"]},"view_window_days":{"type":["null","number"]},"url_contains":{"type":["null","string"]},"always_use_default_value":{"type":["null","boolean"]},"primary":{"type":["null","boolean"]},"counting_type":{"type":["null","string"]}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createTrackingTagEvent","summary":"Create a conversion event","tags":["Ads: accounts & measurement"],"description":"Not idempotent on the networks. A field the network does not store → 422.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"string","minLength":1,"maxLength":64},"site_event":{"type":"string","enum":["page_view","view_content","add_to_cart","search","initiate_checkout","add_payment_info","purchase"]},"enabled":{"type":"boolean"},"default_value":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"click_window_days":{"type":"integer","minimum":1,"maximum":365},"view_window_days":{"type":"integer","minimum":0,"maximum":365},"url_contains":{"type":"string","minLength":1,"maxLength":500},"counting_type":{"type":"string","enum":["one","every"]}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-tracking-tag-event","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/accounts/{accountId}/tracking-tags/{tagId}/events"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_event"]},"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["null","string"]},"site_event":{"type":["null","string"]},"site_event_id":{"type":["null","string"]},"status":{"type":["null","string"]},"default_value":{"type":["null","number"]},"currency":{"type":["null","string"]},"click_window_days":{"type":["null","number"]},"view_window_days":{"type":["null","number"]},"url_contains":{"type":["null","string"]},"always_use_default_value":{"type":["null","boolean"]},"primary":{"type":["null","boolean"]},"counting_type":{"type":["null","string"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags/{tagId}/events/{eventId}":{"patch":{"operationId":"updateTrackingTagEvent","summary":"Update a conversion event","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"string","minLength":1,"maxLength":64},"site_event":{"type":"string","enum":["page_view","view_content","add_to_cart","search","initiate_checkout","add_payment_info","purchase"]},"enabled":{"type":"boolean"},"default_value":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"click_window_days":{"type":"integer","minimum":1,"maximum":365},"view_window_days":{"type":"integer","minimum":0,"maximum":365},"url_contains":{"type":"string","minLength":1,"maxLength":500},"counting_type":{"type":"string","enum":["one","every"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"eventId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-tracking-tag-event","x-feature":"ads","x-zernio":["PATCH /v1/accounts/{accountId}/tracking-tags/{tagId}/events/{eventId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_event"]},"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["null","string"]},"site_event":{"type":["null","string"]},"site_event_id":{"type":["null","string"]},"status":{"type":["null","string"]},"default_value":{"type":["null","number"]},"currency":{"type":["null","string"]},"click_window_days":{"type":["null","number"]},"view_window_days":{"type":["null","number"]},"url_contains":{"type":["null","string"]},"always_use_default_value":{"type":["null","boolean"]},"primary":{"type":["null","boolean"]},"counting_type":{"type":["null","string"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteTrackingTagEvent","summary":"Delete a conversion event","tags":["Ads: accounts & measurement"],"description":"Archives or disables it on networks without a hard delete (`state`).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"eventId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-tracking-tag-event","x-feature":"ads","x-zernio":["DELETE /v1/accounts/{accountId}/tracking-tags/{tagId}/events/{eventId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_event"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"state":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags/{tagId}/users":{"get":{"operationId":"listTrackingTagUsers","summary":"List tag users","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-tracking-tag-users","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/tracking-tags/{tagId}/users"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_user"]},"id":{"type":"string"},"name":{"type":["null","string"]},"tasks":{"type":"array","items":{"type":"string"}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"assignTrackingTagUser","summary":"Assign a user to a tag","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"user_id":{"type":"string","minLength":1,"maxLength":64},"tasks":{"type":"array","items":{"type":"string","enum":["AA_ANALYZE","ADVERTISE","ANALYZE","EDIT","UPLOAD"]},"minItems":1},"business_id":{"type":"string","minLength":1,"maxLength":64}},"required":["user_id","tasks"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"assign-tracking-tag-user","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/accounts/{accountId}/tracking-tags/{tagId}/users"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_user"]},"id":{"type":"string"},"name":{"type":["null","string"]},"tasks":{"type":"array","items":{"type":"string"}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags/{tagId}/users/{userId}":{"delete":{"operationId":"removeTrackingTagUser","summary":"Remove a user from a tag","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"userId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"remove-tracking-tag-user","x-feature":"ads","x-zernio":["DELETE /v1/accounts/{accountId}/tracking-tags/{tagId}/users/{userId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_user"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags/{tagId}/partners":{"get":{"operationId":"listTrackingTagPartners","summary":"List partner businesses of a tag","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-tracking-tag-partners","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/tracking-tags/{tagId}/partners"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_partner"]},"id":{"type":"string"},"name":{"type":["null","string"]}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags/{tagId}/diagnostics":{"get":{"operationId":"getTrackingTagDiagnostics","summary":"Get tag diagnostics","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-tracking-tag-diagnostics","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/tracking-tags/{tagId}/diagnostics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_diagnostic"]},"key":{"type":"string"},"title":{"type":"string"},"description":{"type":["null","string"]},"result":{"type":"string"},"action_url":{"type":["null","string"]}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/tracking-tags/{tagId}/stats":{"get":{"operationId":"getTrackingTagStats","summary":"Get aggregated tag stats","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","enum":["event","host","url","url_by_rule","pixel_fire","device_type","device_os","browser_type","had_pii","custom_data_field","match_keys","event_source","event_detection_method","event_processing_results","event_total_counts","event_value_count"]},"in":"query","name":"aggregation","required":false},{"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"integer"}]},"in":"query","name":"start_time","required":false,"description":"ISO 8601 date-time or unix seconds"},{"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"integer"}]},"in":"query","name":"end_time","required":false,"description":"ISO 8601 date-time or unix seconds"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"tagId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-tracking-tag-stats","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/tracking-tags/{tagId}/stats"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["tracking_tag_stats"]},"tag_id":{"type":"string"},"platform":{"type":"string"},"aggregation":{"type":["null","string"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/leads":{"get":{"operationId":"listLeads","summary":"List leads","tags":["Ads: accounts & measurement"],"description":"Stored lead-gen submissions (leadgen webhooks, live form reads, LinkedIn polling).","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"in":"query","name":"ad_account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"in":"query","name":"connection_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"form_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"ad_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"boolean"},"in":"query","name":"is_test","required":false},{"schema":{"type":"boolean"},"in":"query","name":"is_organic","required":false},{"schema":{"type":"string","enum":["webhook","sync","api"]},"in":"query","name":"source","required":false},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"since","required":false},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"until","required":false},{"schema":{"type":"string","enum":["submitted_at","created_at"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-leads","x-feature":"ads","x-zernio":["GET /v1/ads/leads"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["lead"]},"id":{"type":"string"},"external_id":{"type":"string"},"platform":{"type":"string"},"connection_id":{"type":["null","string"]},"ad_account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"form_id":{"type":["null","string"]},"form_name":{"type":["null","string"]},"page_id":{"type":["null","string"]},"ad_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"is_organic":{"type":"boolean"},"is_test":{"type":"boolean"},"fields":{"type":"object","additionalProperties":{"type":"string"}},"field_data":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"source":{"type":"string"},"submitted_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/leads/{leadId}":{"get":{"operationId":"getLead","summary":"Get a lead","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"in":"path","name":"leadId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-lead","x-feature":"ads","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["lead"]},"id":{"type":"string"},"external_id":{"type":"string"},"platform":{"type":"string"},"connection_id":{"type":["null","string"]},"ad_account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"form_id":{"type":["null","string"]},"form_name":{"type":["null","string"]},"page_id":{"type":["null","string"]},"ad_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"is_organic":{"type":"boolean"},"is_test":{"type":"boolean"},"fields":{"type":"object","additionalProperties":{"type":"string"}},"field_data":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"source":{"type":"string"},"submitted_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/lead-forms":{"get":{"operationId":"listLeadForms","summary":"List lead forms","tags":["Ads: accounts & measurement"],"description":"Meta instant forms of a Page, LinkedIn Lead Gen Forms of a sponsored account.","parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"page_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":32},"in":"query","name":"status","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-lead-forms","x-feature":"ads","x-zernio":["GET /v1/ads/lead-forms"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["lead_form"]},"id":{"type":"string"},"platform":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"locale":{"type":["null","string"]},"page_id":{"type":["null","string"]},"ad_account_id":{"type":["null","string"]},"leads_count":{"type":["null","integer"]},"privacy_policy_url":{"type":["null","string"]},"follow_up_action_url":{"type":["null","string"]},"headline":{"type":["null","string"]},"description":{"type":["null","string"]},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"key":{"type":["null","string"]},"label":{"type":["null","string"]},"type":{"type":["null","string"]},"options":{"type":"array","items":{"type":"object","properties":{"value":{"type":["null","string"]},"key":{"type":["null","string"]}}}}}}},"thank_you_page":{"type":["null","object"],"properties":{"title":{"type":["null","string"]},"body":{"type":["null","string"]},"button_text":{"type":["null","string"]},"button_type":{"type":["null","string"]},"website_url":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"raw":{"type":"object","additionalProperties":true}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createLeadForm","summary":"Create a lead form","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"name":{"type":"string","minLength":1,"maxLength":255},"page_id":{"type":"string","minLength":1,"maxLength":64},"questions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["type"],"properties":{"type":{"type":"string","minLength":1,"maxLength":64},"key":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":500},"inline_context":{"type":"string","minLength":1,"maxLength":500},"options":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["value"],"properties":{"value":{"type":"string","minLength":1,"maxLength":200},"key":{"type":"string","minLength":1,"maxLength":100}}},"maxItems":50}}},"minItems":1,"maxItems":30},"privacy_policy_url":{"type":"string","format":"uri","maxLength":2048},"privacy_policy_link_text":{"type":"string","minLength":1,"maxLength":70},"follow_up_action_url":{"type":"string","format":"uri","maxLength":2048},"locale":{"type":"string","pattern":"^[a-z]{2}_[A-Z]{2}$"},"thank_you_title":{"type":"string","minLength":1,"maxLength":60},"thank_you_body":{"type":"string","minLength":1,"maxLength":500},"thank_you_button_text":{"type":"string","minLength":1,"maxLength":60},"thank_you_button_type":{"type":"string","minLength":1,"maxLength":64},"thank_you_website_url":{"type":"string","format":"uri","maxLength":2048},"is_optimized_for_quality":{"type":"boolean"},"headline":{"type":"string","minLength":1,"maxLength":60},"description":{"type":"string","minLength":1,"maxLength":160},"state":{"type":"string","enum":["DRAFT","PUBLISHED"]},"platform_data":{"type":"object","additionalProperties":true}},"required":["name","questions","privacy_policy_url"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-lead-form","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/lead-forms"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["lead_form"]},"id":{"type":"string"},"platform":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"locale":{"type":["null","string"]},"page_id":{"type":["null","string"]},"ad_account_id":{"type":["null","string"]},"leads_count":{"type":["null","integer"]},"privacy_policy_url":{"type":["null","string"]},"follow_up_action_url":{"type":["null","string"]},"headline":{"type":["null","string"]},"description":{"type":["null","string"]},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"key":{"type":["null","string"]},"label":{"type":["null","string"]},"type":{"type":["null","string"]},"options":{"type":"array","items":{"type":"object","properties":{"value":{"type":["null","string"]},"key":{"type":["null","string"]}}}}}}},"thank_you_page":{"type":["null","object"],"properties":{"title":{"type":["null","string"]},"body":{"type":["null","string"]},"button_text":{"type":["null","string"]},"button_type":{"type":["null","string"]},"website_url":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"raw":{"type":"object","additionalProperties":true}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/lead-forms/{formId}":{"get":{"operationId":"getLeadForm","summary":"Get a lead form","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"page_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"formId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-lead-form","x-feature":"ads","x-zernio":["GET /v1/ads/lead-forms/{formId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["lead_form"]},"id":{"type":"string"},"platform":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"locale":{"type":["null","string"]},"page_id":{"type":["null","string"]},"ad_account_id":{"type":["null","string"]},"leads_count":{"type":["null","integer"]},"privacy_policy_url":{"type":["null","string"]},"follow_up_action_url":{"type":["null","string"]},"headline":{"type":["null","string"]},"description":{"type":["null","string"]},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"key":{"type":["null","string"]},"label":{"type":["null","string"]},"type":{"type":["null","string"]},"options":{"type":"array","items":{"type":"object","properties":{"value":{"type":["null","string"]},"key":{"type":["null","string"]}}}}}}},"thank_you_page":{"type":["null","object"],"properties":{"title":{"type":["null","string"]},"body":{"type":["null","string"]},"button_text":{"type":["null","string"]},"button_type":{"type":["null","string"]},"website_url":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"raw":{"type":"object","additionalProperties":true}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"archiveLeadForm","summary":"Archive a lead form","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"page_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"formId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"archive-lead-form","x-feature":"ads","x-zernio":["DELETE /v1/ads/lead-forms/{formId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["lead_form"]},"id":{"type":"string"},"archived":{"type":"boolean"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/lead-forms/{formId}/leads":{"get":{"operationId":"listLeadFormLeads","summary":"List the leads of a form","tags":["Ads: accounts & measurement"],"description":"Reads the form’s leads live and stores them (new leads emit lead.received).","parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"page_id","required":false},{"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"integer"}]},"in":"query","name":"since","required":false,"description":"ISO 8601 date-time or unix seconds"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"formId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-lead-form-leads","x-feature":"ads","x-zernio":["GET /v1/ads/lead-forms/{formId}/leads"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["lead"]},"id":{"type":"string"},"external_id":{"type":"string"},"platform":{"type":"string"},"connection_id":{"type":["null","string"]},"ad_account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"form_id":{"type":["null","string"]},"form_name":{"type":["null","string"]},"page_id":{"type":["null","string"]},"ad_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"is_organic":{"type":"boolean"},"is_test":{"type":"boolean"},"fields":{"type":"object","additionalProperties":{"type":"string"}},"field_data":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"source":{"type":"string"},"submitted_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/lead-forms/{formId}/test-leads":{"post":{"operationId":"createTestLead","summary":"Create a test lead","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"page_id":{"type":"string","minLength":1,"maxLength":64},"field_data":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","values"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"values":{"type":"array","items":{"type":"string","maxLength":500},"minItems":1}}},"minItems":1,"maxItems":50}},"required":["field_data"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"formId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-test-lead","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/lead-forms/{formId}/test-leads"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["test_lead"]},"id":{"type":"string"},"form_id":{"type":"string"}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteTestLeads","summary":"Delete test leads","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"page_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"lead_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"formId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-test-leads","x-feature":"ads","x-zernio":["DELETE /v1/ads/lead-forms/{formId}/test-leads"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["test_lead"]},"deleted":{"type":"boolean"},"ids":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/catalogs":{"get":{"operationId":"listCatalogs","summary":"List product catalogs","tags":["Ads: accounts & measurement"],"description":"Meta Commerce catalogs owned by (or shared with) a business portfolio.","parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-catalogs","x-feature":"ads","x-zernio":["GET /v1/ads/catalogs"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["catalog"]},"id":{"type":"string"},"name":{"type":["null","string"]},"vertical":{"type":["null","string"]},"product_count":{"type":["null","integer"]},"business_id":{"type":["null","string"]}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]},"business_id":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createCatalog","summary":"Create a product catalog","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"business_id":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","minLength":1,"maxLength":200},"vertical":{"type":"string","enum":["commerce","vehicles","hotels","flights","destinations","home_listings","local_service_business","offline_commerce","ticketed_experiences","transactable_items"]}},"required":["name"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-catalog","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/catalogs"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog"]},"id":{"type":"string"},"name":{"type":["null","string"]},"vertical":{"type":["null","string"]},"product_count":{"type":["null","integer"]},"business_id":{"type":["null","string"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/catalogs/{catalogId}":{"get":{"operationId":"getCatalog","summary":"Get a product catalog","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-catalog","x-feature":"ads","x-zernio":["GET /v1/ads/catalogs/{catalogId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog"]},"id":{"type":"string"},"name":{"type":["null","string"]},"vertical":{"type":["null","string"]},"product_count":{"type":["null","integer"]},"business_id":{"type":["null","string"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteCatalog","summary":"Delete a product catalog","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-catalog","x-feature":"ads","x-zernio":["DELETE /v1/ads/catalogs/{catalogId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/catalogs/{catalogId}/products":{"get":{"operationId":"listCatalogProducts","summary":"List catalog products","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":100},"in":"query","name":"retailer_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-catalog-products","x-feature":"ads","x-zernio":["GET /v1/ads/catalogs/{catalogId}/products"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_product"]},"id":{"type":"string"},"retailer_id":{"type":["null","string"]},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"url":{"type":["null","string"]},"image_url":{"type":["null","string"]},"additional_image_urls":{"type":"array","items":{"type":"string"}},"price":{"type":["null","string"]},"sale_price":{"type":["null","string"]},"currency":{"type":["null","string"]},"availability":{"type":["null","string"]},"condition":{"type":["null","string"]},"brand":{"type":["null","string"]},"category":{"type":["null","string"]},"product_type":{"type":["null","string"]},"gtin":{"type":["null","string"]},"inventory":{"type":["null","integer"]},"visibility":{"type":["null","string"]},"color":{"type":["null","string"]},"size":{"type":["null","string"]},"gender":{"type":["null","string"]},"material":{"type":["null","string"]},"pattern":{"type":["null","string"]},"custom_labels":{"type":"array","items":{"type":["null","string"]}},"review_status":{"type":["null","string"]},"review_rejection_reasons":{"type":"array","items":{"type":"string"}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createCatalogProduct","summary":"Add a product","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"product":{"type":"object","additionalProperties":false,"properties":{"retailer_id":{"type":"string","minLength":1,"maxLength":100},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":1,"maxLength":9999},"url":{"type":"string","format":"uri","maxLength":2048},"image_url":{"type":"string","format":"uri","maxLength":2048},"additional_image_urls":{"type":"array","items":{"type":"string","format":"uri","maxLength":2048},"maxItems":20},"price":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"sale_price":{"type":"number","minimum":0},"sale_price_start_date":{"type":"string","minLength":1,"maxLength":40},"sale_price_end_date":{"type":"string","minLength":1,"maxLength":40},"availability":{"type":"string","enum":["in stock","out of stock","preorder","available for order","discontinued","pending"]},"condition":{"type":"string","enum":["new","refurbished","used"]},"brand":{"type":"string","minLength":1,"maxLength":100},"category":{"type":"string","minLength":1,"maxLength":250},"google_product_category":{"type":"string","minLength":1,"maxLength":250},"product_type":{"type":"string","minLength":1,"maxLength":750},"gtin":{"type":"string","minLength":1,"maxLength":70},"mpn":{"type":"string","minLength":1,"maxLength":100},"inventory":{"type":"integer","minimum":0},"visibility":{"type":"string","enum":["published","staging"]},"color":{"type":"string","minLength":1,"maxLength":200},"size":{"type":"string","minLength":1,"maxLength":200},"gender":{"type":"string","enum":["female","male","unisex"]},"material":{"type":"string","minLength":1,"maxLength":200},"pattern":{"type":"string","minLength":1,"maxLength":100},"custom_label_0":{"type":"string","minLength":1,"maxLength":100},"custom_label_1":{"type":"string","minLength":1,"maxLength":100},"custom_label_2":{"type":"string","minLength":1,"maxLength":100},"custom_label_3":{"type":"string","minLength":1,"maxLength":100},"custom_label_4":{"type":"string","minLength":1,"maxLength":100}}}},"required":["product"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-catalog-product","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/catalogs/{catalogId}/products"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_product"]},"id":{"type":"string"},"retailer_id":{"type":["null","string"]},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"url":{"type":["null","string"]},"image_url":{"type":["null","string"]},"additional_image_urls":{"type":"array","items":{"type":"string"}},"price":{"type":["null","string"]},"sale_price":{"type":["null","string"]},"currency":{"type":["null","string"]},"availability":{"type":["null","string"]},"condition":{"type":["null","string"]},"brand":{"type":["null","string"]},"category":{"type":["null","string"]},"product_type":{"type":["null","string"]},"gtin":{"type":["null","string"]},"inventory":{"type":["null","integer"]},"visibility":{"type":["null","string"]},"color":{"type":["null","string"]},"size":{"type":["null","string"]},"gender":{"type":["null","string"]},"material":{"type":["null","string"]},"pattern":{"type":["null","string"]},"custom_labels":{"type":"array","items":{"type":["null","string"]}},"review_status":{"type":["null","string"]},"review_rejection_reasons":{"type":"array","items":{"type":"string"}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/catalogs/{catalogId}/products/batch":{"post":{"operationId":"batchCatalogProducts","summary":"Create, update or delete products in bulk","tags":["Ads: accounts & measurement"],"description":"Up to 5,000 requests keyed by retailer_id, processed asynchronously (202).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"requests":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["method","product"],"properties":{"method":{"type":"string","enum":["CREATE","UPDATE","DELETE"]},"product":{"type":"object","additionalProperties":false,"properties":{"retailer_id":{"type":"string","minLength":1,"maxLength":100},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":1,"maxLength":9999},"url":{"type":"string","format":"uri","maxLength":2048},"image_url":{"type":"string","format":"uri","maxLength":2048},"additional_image_urls":{"type":"array","items":{"type":"string","format":"uri","maxLength":2048},"maxItems":20},"price":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"sale_price":{"type":"number","minimum":0},"sale_price_start_date":{"type":"string","minLength":1,"maxLength":40},"sale_price_end_date":{"type":"string","minLength":1,"maxLength":40},"availability":{"type":"string","enum":["in stock","out of stock","preorder","available for order","discontinued","pending"]},"condition":{"type":"string","enum":["new","refurbished","used"]},"brand":{"type":"string","minLength":1,"maxLength":100},"category":{"type":"string","minLength":1,"maxLength":250},"google_product_category":{"type":"string","minLength":1,"maxLength":250},"product_type":{"type":"string","minLength":1,"maxLength":750},"gtin":{"type":"string","minLength":1,"maxLength":70},"mpn":{"type":"string","minLength":1,"maxLength":100},"inventory":{"type":"integer","minimum":0},"visibility":{"type":"string","enum":["published","staging"]},"color":{"type":"string","minLength":1,"maxLength":200},"size":{"type":"string","minLength":1,"maxLength":200},"gender":{"type":"string","enum":["female","male","unisex"]},"material":{"type":"string","minLength":1,"maxLength":200},"pattern":{"type":"string","minLength":1,"maxLength":100},"custom_label_0":{"type":"string","minLength":1,"maxLength":100},"custom_label_1":{"type":"string","minLength":1,"maxLength":100},"custom_label_2":{"type":"string","minLength":1,"maxLength":100},"custom_label_3":{"type":"string","minLength":1,"maxLength":100},"custom_label_4":{"type":"string","minLength":1,"maxLength":100}}}}},"minItems":1,"maxItems":5000}},"required":["requests"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads_measurement","x-mcp-tool":"batch-catalog-products","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/catalogs/{catalogId}/products/batch"],"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_batch_request"]},"catalog_id":{"type":"string"},"handles":{"type":"array","items":{"type":"string"}},"status_url":{"type":["null","string"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/catalogs/{catalogId}/batches/{handle}":{"get":{"operationId":"getCatalogBatch","summary":"Get a bulk request’s status","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"handle","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-catalog-batch","x-feature":"ads","x-zernio":["GET /v1/ads/catalogs/{catalogId}/batches/{handle}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_batch"]},"handle":{"type":"string"},"status":{"type":"string"},"errors_total_count":{"type":"integer"},"errors":{"type":"array","items":{"type":"object","properties":{"retailer_id":{"type":["null","string"]},"message":{"type":"string"}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/catalogs/{catalogId}/products/{productId}":{"get":{"operationId":"getCatalogProduct","summary":"Get a product","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"productId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-catalog-product","x-feature":"ads","x-zernio":["GET /v1/ads/catalogs/{catalogId}/products/{productId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_product"]},"id":{"type":"string"},"retailer_id":{"type":["null","string"]},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"url":{"type":["null","string"]},"image_url":{"type":["null","string"]},"additional_image_urls":{"type":"array","items":{"type":"string"}},"price":{"type":["null","string"]},"sale_price":{"type":["null","string"]},"currency":{"type":["null","string"]},"availability":{"type":["null","string"]},"condition":{"type":["null","string"]},"brand":{"type":["null","string"]},"category":{"type":["null","string"]},"product_type":{"type":["null","string"]},"gtin":{"type":["null","string"]},"inventory":{"type":["null","integer"]},"visibility":{"type":["null","string"]},"color":{"type":["null","string"]},"size":{"type":["null","string"]},"gender":{"type":["null","string"]},"material":{"type":["null","string"]},"pattern":{"type":["null","string"]},"custom_labels":{"type":"array","items":{"type":["null","string"]}},"review_status":{"type":["null","string"]},"review_rejection_reasons":{"type":"array","items":{"type":"string"}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateCatalogProduct","summary":"Update a product","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"product":{"type":"object","additionalProperties":false,"properties":{"retailer_id":{"type":"string","minLength":1,"maxLength":100},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":1,"maxLength":9999},"url":{"type":"string","format":"uri","maxLength":2048},"image_url":{"type":"string","format":"uri","maxLength":2048},"additional_image_urls":{"type":"array","items":{"type":"string","format":"uri","maxLength":2048},"maxItems":20},"price":{"type":"number","minimum":0},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"sale_price":{"type":"number","minimum":0},"sale_price_start_date":{"type":"string","minLength":1,"maxLength":40},"sale_price_end_date":{"type":"string","minLength":1,"maxLength":40},"availability":{"type":"string","enum":["in stock","out of stock","preorder","available for order","discontinued","pending"]},"condition":{"type":"string","enum":["new","refurbished","used"]},"brand":{"type":"string","minLength":1,"maxLength":100},"category":{"type":"string","minLength":1,"maxLength":250},"google_product_category":{"type":"string","minLength":1,"maxLength":250},"product_type":{"type":"string","minLength":1,"maxLength":750},"gtin":{"type":"string","minLength":1,"maxLength":70},"mpn":{"type":"string","minLength":1,"maxLength":100},"inventory":{"type":"integer","minimum":0},"visibility":{"type":"string","enum":["published","staging"]},"color":{"type":"string","minLength":1,"maxLength":200},"size":{"type":"string","minLength":1,"maxLength":200},"gender":{"type":"string","enum":["female","male","unisex"]},"material":{"type":"string","minLength":1,"maxLength":200},"pattern":{"type":"string","minLength":1,"maxLength":100},"custom_label_0":{"type":"string","minLength":1,"maxLength":100},"custom_label_1":{"type":"string","minLength":1,"maxLength":100},"custom_label_2":{"type":"string","minLength":1,"maxLength":100},"custom_label_3":{"type":"string","minLength":1,"maxLength":100},"custom_label_4":{"type":"string","minLength":1,"maxLength":100}}}},"required":["product"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"productId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-catalog-product","x-feature":"ads","x-zernio":["PUT /v1/ads/catalogs/{catalogId}/products/{productId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_product"]},"id":{"type":"string"},"retailer_id":{"type":["null","string"]},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"url":{"type":["null","string"]},"image_url":{"type":["null","string"]},"additional_image_urls":{"type":"array","items":{"type":"string"}},"price":{"type":["null","string"]},"sale_price":{"type":["null","string"]},"currency":{"type":["null","string"]},"availability":{"type":["null","string"]},"condition":{"type":["null","string"]},"brand":{"type":["null","string"]},"category":{"type":["null","string"]},"product_type":{"type":["null","string"]},"gtin":{"type":["null","string"]},"inventory":{"type":["null","integer"]},"visibility":{"type":["null","string"]},"color":{"type":["null","string"]},"size":{"type":["null","string"]},"gender":{"type":["null","string"]},"material":{"type":["null","string"]},"pattern":{"type":["null","string"]},"custom_labels":{"type":"array","items":{"type":["null","string"]}},"review_status":{"type":["null","string"]},"review_rejection_reasons":{"type":"array","items":{"type":"string"}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteCatalogProduct","summary":"Delete a product","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"productId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-catalog-product","x-feature":"ads","x-zernio":["DELETE /v1/ads/catalogs/{catalogId}/products/{productId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_product"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/catalogs/{catalogId}/feeds":{"get":{"operationId":"listCatalogFeeds","summary":"List product feeds","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-catalog-feeds","x-feature":"ads","x-zernio":["GET /v1/ads/catalogs/{catalogId}/feeds"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_feed"]},"id":{"type":"string"},"name":{"type":["null","string"]},"product_count":{"type":["null","integer"]},"schedule":{"type":["null","object"],"properties":{"interval":{"type":["null","string"]},"url":{"type":["null","string"]},"hour":{"type":["null","integer"]},"day_of_week":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"latest_upload":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["catalog_feed_upload"]},"id":{"type":"string"},"url":{"type":["null","string"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"error_count":{"type":["null","integer"]},"warning_count":{"type":["null","integer"]},"items_detected":{"type":["null","integer"]},"items_deleted":{"type":["null","integer"]}}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createCatalogFeed","summary":"Create a product feed","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"name":{"type":"string","minLength":1,"maxLength":200},"schedule":{"type":"object","additionalProperties":false,"required":["interval","url"],"properties":{"interval":{"type":"string","enum":["HOURLY","DAILY","WEEKLY"]},"url":{"type":"string","format":"uri","maxLength":2048},"hour":{"type":"integer","minimum":0,"maximum":23},"day_of_week":{"type":"string","enum":["SUNDAY","MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY"]}}}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-catalog-feed","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/catalogs/{catalogId}/feeds"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_feed"]},"id":{"type":"string"},"name":{"type":["null","string"]},"product_count":{"type":["null","integer"]},"schedule":{"type":["null","object"],"properties":{"interval":{"type":["null","string"]},"url":{"type":["null","string"]},"hour":{"type":["null","integer"]},"day_of_week":{"type":["null","string"]}}},"created_at":{"type":["null","string"],"format":"date-time"},"latest_upload":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["catalog_feed_upload"]},"id":{"type":"string"},"url":{"type":["null","string"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"error_count":{"type":["null","integer"]},"warning_count":{"type":["null","integer"]},"items_detected":{"type":["null","integer"]},"items_deleted":{"type":["null","integer"]}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/catalogs/{catalogId}/feeds/{feedId}/uploads":{"get":{"operationId":"listCatalogFeedUploads","summary":"List a feed’s uploads","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"feedId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-catalog-feed-uploads","x-feature":"ads","x-zernio":["GET /v1/ads/catalogs/{catalogId}/feeds/{feedId}/uploads"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_feed_upload"]},"id":{"type":"string"},"url":{"type":["null","string"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"error_count":{"type":["null","integer"]},"warning_count":{"type":["null","integer"]},"items_detected":{"type":["null","integer"]},"items_deleted":{"type":["null","integer"]}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createCatalogFeedUpload","summary":"Fetch a feed file now","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"url":{"type":"string","format":"uri","maxLength":2048}},"required":["url"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"feedId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads_measurement","x-mcp-tool":"create-catalog-feed-upload","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/catalogs/{catalogId}/feeds/{feedId}/uploads"],"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["catalog_feed_upload"]},"id":{"type":"string"},"url":{"type":["null","string"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"error_count":{"type":["null","integer"]},"warning_count":{"type":["null","integer"]},"items_detected":{"type":["null","integer"]},"items_deleted":{"type":["null","integer"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/catalogs/{catalogId}/product-sets":{"get":{"operationId":"listProductSets","summary":"List product sets","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-product-sets","x-feature":"ads","x-zernio":["GET /v1/ads/catalogs/{catalogId}/product-sets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["product_set"]},"id":{"type":"string"},"name":{"type":["null","string"]},"product_count":{"type":["null","integer"]},"filter":{"type":["null","object"],"additionalProperties":true}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createProductSet","summary":"Create a product set","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"name":{"type":"string","minLength":1,"maxLength":200},"filter":{"type":"object","additionalProperties":true}},"required":["name","filter"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-product-set","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/catalogs/{catalogId}/product-sets"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["product_set"]},"id":{"type":"string"},"name":{"type":["null","string"]},"product_count":{"type":["null","integer"]},"filter":{"type":["null","object"],"additionalProperties":true}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/catalogs/{catalogId}/product-sets/{productSetId}":{"patch":{"operationId":"updateProductSet","summary":"Update a product set","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"name":{"type":"string","minLength":1,"maxLength":200},"filter":{"type":"object","additionalProperties":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"productSetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-product-set","x-feature":"ads","x-zernio":["PUT /v1/ads/catalogs/{catalogId}/product-sets/{productSetId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["product_set"]},"id":{"type":"string"},"name":{"type":["null","string"]},"product_count":{"type":["null","integer"]},"filter":{"type":["null","object"],"additionalProperties":true}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteProductSet","summary":"Delete a product set","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"business_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","maxLength":4096},"in":"query","name":"after","required":false,"description":"Alias of cursor"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"catalogId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"productSetId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-product-set","x-feature":"ads","x-zernio":["DELETE /v1/ads/catalogs/{catalogId}/product-sets/{productSetId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["product_set"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/conversions":{"post":{"operationId":"sendConversions","summary":"Send conversion events","tags":["Ads: accounts & measurement"],"description":"Relays server-side conversion events (PII normalized + SHA-256 hashed, never stored) to the network Conversions API.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"destination_id":{"type":"string","minLength":1,"maxLength":256},"events":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["event_name","event_time","event_id","user"],"properties":{"event_name":{"type":"string","minLength":1,"maxLength":100},"event_time":{"anyOf":[{"type":"string","maxLength":64},{"type":"integer"}],"description":"ISO 8601 date-time or unix seconds"},"event_id":{"type":"string","minLength":1,"maxLength":100},"value":{"type":"number"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"user":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","minLength":1,"maxLength":320},"emails":{"type":"array","items":{"type":"string","minLength":1,"maxLength":320},"maxItems":10},"phone":{"type":"string","minLength":1,"maxLength":64},"phones":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":10},"first_name":{"type":"string","minLength":1,"maxLength":200},"last_name":{"type":"string","minLength":1,"maxLength":200},"city":{"type":"string","minLength":1,"maxLength":200},"state":{"type":"string","minLength":1,"maxLength":100},"zip":{"type":"string","minLength":1,"maxLength":32},"country":{"type":"string","minLength":1,"maxLength":64},"date_of_birth":{"type":"string","minLength":1,"maxLength":16},"gender":{"type":"string","minLength":1,"maxLength":16},"external_id":{"type":"string","minLength":1,"maxLength":256},"external_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":256},"maxItems":10},"ip_address":{"type":"string","minLength":1,"maxLength":64},"user_agent":{"type":"string","minLength":1,"maxLength":1024},"company_name":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string","minLength":1,"maxLength":200},"fbc":{"type":"string","minLength":1,"maxLength":500},"fbp":{"type":"string","minLength":1,"maxLength":500},"gclid":{"type":"string","minLength":1,"maxLength":500},"gbraid":{"type":"string","minLength":1,"maxLength":500},"wbraid":{"type":"string","minLength":1,"maxLength":500},"ttclid":{"type":"string","minLength":1,"maxLength":500},"ttp":{"type":"string","minLength":1,"maxLength":500},"li_fat_id":{"type":"string","minLength":1,"maxLength":500},"epik":{"type":"string","minLength":1,"maxLength":500},"sc_click_id":{"type":"string","minLength":1,"maxLength":500},"sc_cookie1":{"type":"string","minLength":1,"maxLength":500},"rdt_cid":{"type":"string","minLength":1,"maxLength":500},"twclid":{"type":"string","minLength":1,"maxLength":500},"click_id":{"type":"string","minLength":1,"maxLength":500},"lead_id":{"type":"string","minLength":1,"maxLength":64},"uuid":{"type":"string","minLength":1,"maxLength":200},"hashed":{"type":"boolean"}}},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id"],"properties":{"id":{"type":"string","minLength":1,"maxLength":100},"quantity":{"type":"integer","minimum":1},"price":{"type":"number"},"name":{"type":"string","minLength":1,"maxLength":200},"category":{"type":"string","minLength":1,"maxLength":200}}},"maxItems":200},"source_url":{"type":"string","format":"uri","maxLength":2048},"action_source":{"type":"string","enum":["web","app","offline","crm","phone_call","system_generated"]},"order_id":{"type":"string","minLength":1,"maxLength":100},"platform_data":{"type":"object","additionalProperties":true}}},"minItems":1,"maxItems":1000},"test_code":{"type":"string","minLength":1,"maxLength":100},"consent":{"type":"object","additionalProperties":false,"properties":{"ad_user_data":{"type":"string","enum":["GRANTED","DENIED"]},"ad_personalization":{"type":"string","enum":["GRANTED","DENIED"]}}}},"required":["destination_id","events"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"ads_measurement","x-mcp-tool":"send-conversions","x-idempotent":true,"x-feature":"ads","x-rate-limit":{"max":600,"timeWindow":"1 minute"},"x-zernio":["POST /v1/ads/conversions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_result"]},"platform":{"type":"string"},"ad_account_id":{"type":"string"},"destination_id":{"type":"string"},"test":{"type":"boolean"},"events_received":{"type":"integer"},"events_failed":{"type":"integer"},"failures":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"event_id":{"type":["null","string"]},"message":{"type":"string"},"code":{"type":["null","string"]}}}},"trace_id":{"type":["null","string"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/conversions/adjustments":{"post":{"operationId":"adjustConversions","summary":"Adjust uploaded conversions","tags":["Ads: accounts & measurement"],"description":"Retract, restate or enhance conversions already sent (Google Ads).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":256,"description":"Network ad account id (act_…, customer id, advertiser id …)"},"destination_id":{"type":"string","minLength":1,"maxLength":64},"adjustments":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["adjustment_type","adjustment_time"],"properties":{"adjustment_type":{"type":"string","enum":["RETRACTION","RESTATEMENT","ENHANCEMENT"]},"adjustment_time":{"anyOf":[{"type":"string","maxLength":64},{"type":"integer"}],"description":"ISO 8601 date-time or unix seconds"},"order_id":{"type":"string","minLength":1,"maxLength":100},"gclid":{"type":"string","minLength":1,"maxLength":500},"conversion_time":{"anyOf":[{"type":"string","maxLength":64},{"type":"integer"}],"description":"ISO 8601 date-time or unix seconds"},"restatement_value":{"type":"number"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"user":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","minLength":1,"maxLength":320},"emails":{"type":"array","items":{"type":"string","minLength":1,"maxLength":320},"maxItems":10},"phone":{"type":"string","minLength":1,"maxLength":64},"phones":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"maxItems":10},"first_name":{"type":"string","minLength":1,"maxLength":200},"last_name":{"type":"string","minLength":1,"maxLength":200},"city":{"type":"string","minLength":1,"maxLength":200},"state":{"type":"string","minLength":1,"maxLength":100},"zip":{"type":"string","minLength":1,"maxLength":32},"country":{"type":"string","minLength":1,"maxLength":64},"date_of_birth":{"type":"string","minLength":1,"maxLength":16},"gender":{"type":"string","minLength":1,"maxLength":16},"external_id":{"type":"string","minLength":1,"maxLength":256},"external_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":256},"maxItems":10},"ip_address":{"type":"string","minLength":1,"maxLength":64},"user_agent":{"type":"string","minLength":1,"maxLength":1024},"company_name":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string","minLength":1,"maxLength":200},"fbc":{"type":"string","minLength":1,"maxLength":500},"fbp":{"type":"string","minLength":1,"maxLength":500},"gclid":{"type":"string","minLength":1,"maxLength":500},"gbraid":{"type":"string","minLength":1,"maxLength":500},"wbraid":{"type":"string","minLength":1,"maxLength":500},"ttclid":{"type":"string","minLength":1,"maxLength":500},"ttp":{"type":"string","minLength":1,"maxLength":500},"li_fat_id":{"type":"string","minLength":1,"maxLength":500},"epik":{"type":"string","minLength":1,"maxLength":500},"sc_click_id":{"type":"string","minLength":1,"maxLength":500},"sc_cookie1":{"type":"string","minLength":1,"maxLength":500},"rdt_cid":{"type":"string","minLength":1,"maxLength":500},"twclid":{"type":"string","minLength":1,"maxLength":500},"click_id":{"type":"string","minLength":1,"maxLength":500},"lead_id":{"type":"string","minLength":1,"maxLength":64},"uuid":{"type":"string","minLength":1,"maxLength":200},"hashed":{"type":"boolean"}}},"user_agent":{"type":"string","minLength":1,"maxLength":1024}}},"minItems":1,"maxItems":2000}},"required":["destination_id","adjustments"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"ads_measurement","x-mcp-tool":"adjust-conversions","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/conversions/adjustments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_adjustment_result"]},"platform":{"type":"string"},"ad_account_id":{"type":"string"},"destination_id":{"type":"string"},"adjustments_received":{"type":"integer"},"adjustments_failed":{"type":"integer"},"failures":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"message":{"type":"string"},"code":{"type":["null","string"]}}}},"trace_id":{"type":["null","string"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/conversions/quality":{"get":{"operationId":"getEventMatchQuality","summary":"Get Event Match Quality","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…), with platform_ad_account_id when it has several ad accounts"},{"schema":{"type":"string","maxLength":256},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_…, customer id, advertiser id …)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"query","name":"destination_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-event-match-quality","x-feature":"ads","x-zernio":["GET /v1/ads/conversions/quality"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["event_match_quality"]},"platform":{"type":"string"},"destination_id":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"event_name":{"type":["null","string"]},"composite_score":{"type":["null","number"]},"match_keys":{"type":"array","items":{"type":"object","properties":{"identifier":{"type":["null","string"]},"coverage_percentage":{"type":["null","number"]}}}},"event_coverage_percentage":{"type":["null","number"]}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/conversion-actions":{"get":{"operationId":"listConversionActions","summary":"List conversion actions","tags":["Ads: accounts & measurement"],"description":"Google Ads conversion actions with their tag snippets.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-conversion-actions","x-feature":"ads","x-zernio":["GET /v1/ads/conversions/actions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_action"]},"id":{"type":"string"},"name":{"type":["null","string"]},"type":{"type":["null","string"]},"status":{"type":["null","string"]},"category":{"type":["null","string"]},"origin":{"type":["null","string"]},"primary_for_goal":{"type":["null","boolean"]},"default_value":{"type":["null","number"]},"default_currency":{"type":["null","string"]},"always_use_default_value":{"type":["null","boolean"]},"counting_type":{"type":["null","string"]},"click_through_lookback_window_days":{"type":["null","number"]},"view_through_lookback_window_days":{"type":["null","number"]},"resource_name":{"type":["null","string"]},"tag_snippets":{"type":"array","items":{"type":"object","properties":{"type":{"type":["null","string"]},"page_format":{"type":["null","string"]},"global_site_tag":{"type":["null","string"]},"event_snippet":{"type":["null","string"]}}}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createConversionAction","summary":"Create a website conversion action","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":255},"category":{"type":"string","enum":["DEFAULT","PAGE_VIEW","PURCHASE","SIGNUP","DOWNLOAD","ADD_TO_CART","BEGIN_CHECKOUT","SUBSCRIBE_PAID","PHONE_CALL_LEAD","IMPORTED_LEAD","SUBMIT_LEAD_FORM","BOOK_APPOINTMENT","REQUEST_QUOTE","GET_DIRECTIONS","OUTBOUND_CLICK","CONTACT","ENGAGEMENT","STORE_VISIT","STORE_SALE","QUALIFIED_LEAD","CONVERTED_LEAD"]},"default_value":{"type":"number","minimum":0},"default_currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"always_use_default_value":{"type":"boolean"},"counting_type":{"type":"string","enum":["ONE_PER_CLICK","MANY_PER_CLICK"]},"click_through_lookback_window_days":{"type":"integer","minimum":1,"maximum":90},"view_through_lookback_window_days":{"type":"integer","minimum":1,"maximum":30},"primary_for_goal":{"type":"boolean"},"type":{"type":"string","enum":["WEBPAGE"]}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-conversion-action","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/conversions/actions"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_action"]},"id":{"type":"string"},"name":{"type":["null","string"]},"type":{"type":["null","string"]},"status":{"type":["null","string"]},"category":{"type":["null","string"]},"origin":{"type":["null","string"]},"primary_for_goal":{"type":["null","boolean"]},"default_value":{"type":["null","number"]},"default_currency":{"type":["null","string"]},"always_use_default_value":{"type":["null","boolean"]},"counting_type":{"type":["null","string"]},"click_through_lookback_window_days":{"type":["null","number"]},"view_through_lookback_window_days":{"type":["null","number"]},"resource_name":{"type":["null","string"]},"tag_snippets":{"type":"array","items":{"type":"object","properties":{"type":{"type":["null","string"]},"page_format":{"type":["null","string"]},"global_site_tag":{"type":["null","string"]},"event_snippet":{"type":["null","string"]}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/conversion-actions/{actionId}":{"patch":{"operationId":"updateConversionAction","summary":"Update a conversion action","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":255},"category":{"type":"string","enum":["DEFAULT","PAGE_VIEW","PURCHASE","SIGNUP","DOWNLOAD","ADD_TO_CART","BEGIN_CHECKOUT","SUBSCRIBE_PAID","PHONE_CALL_LEAD","IMPORTED_LEAD","SUBMIT_LEAD_FORM","BOOK_APPOINTMENT","REQUEST_QUOTE","GET_DIRECTIONS","OUTBOUND_CLICK","CONTACT","ENGAGEMENT","STORE_VISIT","STORE_SALE","QUALIFIED_LEAD","CONVERTED_LEAD"]},"default_value":{"type":"number","minimum":0},"default_currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"always_use_default_value":{"type":"boolean"},"counting_type":{"type":"string","enum":["ONE_PER_CLICK","MANY_PER_CLICK"]},"click_through_lookback_window_days":{"type":"integer","minimum":1,"maximum":90},"view_through_lookback_window_days":{"type":"integer","minimum":1,"maximum":30},"primary_for_goal":{"type":"boolean"},"status":{"type":"string","enum":["ENABLED","REMOVED"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"actionId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-conversion-action","x-feature":"ads","x-zernio":["PATCH /v1/ads/conversions/actions/{actionId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_action"]},"id":{"type":"string"},"name":{"type":["null","string"]},"type":{"type":["null","string"]},"status":{"type":["null","string"]},"category":{"type":["null","string"]},"origin":{"type":["null","string"]},"primary_for_goal":{"type":["null","boolean"]},"default_value":{"type":["null","number"]},"default_currency":{"type":["null","string"]},"always_use_default_value":{"type":["null","boolean"]},"counting_type":{"type":["null","string"]},"click_through_lookback_window_days":{"type":["null","number"]},"view_through_lookback_window_days":{"type":["null","number"]},"resource_name":{"type":["null","string"]},"tag_snippets":{"type":"array","items":{"type":"object","properties":{"type":{"type":["null","string"]},"page_format":{"type":["null","string"]},"global_site_tag":{"type":["null","string"]},"event_snippet":{"type":["null","string"]}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/conversion-goals":{"get":{"operationId":"listConversionGoals","summary":"List account conversion goals","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-conversion-goals","x-feature":"ads","x-zernio":["GET /v1/ads/conversions/goals"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_goal"]},"category":{"type":["null","string"]},"origin":{"type":["null","string"]},"biddable":{"type":"boolean"},"resource_name":{"type":["null","string"]},"conversion_actions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"primary_for_goal":{"type":"boolean"}}}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateConversionGoals","summary":"Update account conversion goals","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"goals":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["category","origin","biddable"],"properties":{"category":{"type":"string","minLength":1,"maxLength":64},"origin":{"type":"string","minLength":1,"maxLength":64},"biddable":{"type":"boolean"}}},"minItems":1,"maxItems":100}},"required":["goals"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-conversion-goals","x-feature":"ads","x-zernio":["PATCH /v1/ads/conversions/goals"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_goal"]},"category":{"type":["null","string"]},"origin":{"type":["null","string"]},"biddable":{"type":"boolean"},"resource_name":{"type":["null","string"]},"conversion_actions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"primary_for_goal":{"type":"boolean"}}}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/custom-conversion-goals":{"get":{"operationId":"listCustomConversionGoals","summary":"List custom conversion goals","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-custom-conversion-goals","x-feature":"ads","x-zernio":["GET /v1/ads/conversions/custom-goals"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["custom_conversion_goal"]},"id":{"type":"string"},"resource_name":{"type":["null","string"]},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"conversion_action_ids":{"type":"array","items":{"type":"string"}}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createCustomConversionGoal","summary":"Create a custom conversion goal","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":255},"conversion_action_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":32},"minItems":1,"maxItems":100}},"required":["name","conversion_action_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-custom-conversion-goal","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/conversions/custom-goals"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["custom_conversion_goal"]},"id":{"type":"string"},"resource_name":{"type":["null","string"]},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"conversion_action_ids":{"type":"array","items":{"type":"string"}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/custom-conversion-goals/{goalId}":{"patch":{"operationId":"updateCustomConversionGoal","summary":"Update a custom conversion goal","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":255},"conversion_action_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":32},"minItems":1,"maxItems":100}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"goalId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-custom-conversion-goal","x-feature":"ads","x-zernio":["PATCH /v1/ads/conversions/custom-goals/{goalId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["custom_conversion_goal"]},"id":{"type":"string"},"resource_name":{"type":["null","string"]},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"conversion_action_ids":{"type":"array","items":{"type":"string"}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteCustomConversionGoal","summary":"Remove a custom conversion goal","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"goalId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-custom-conversion-goal","x-feature":"ads","x-zernio":["DELETE /v1/ads/conversions/custom-goals/{goalId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["custom_conversion_goal"]},"id":{"type":"string"},"deleted":{"type":"boolean"}},"required":["object","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/conversion-destinations":{"get":{"operationId":"listConversionDestinations","summary":"List conversion destinations","tags":["Ads: accounts & measurement"],"description":"Where the ad account can receive conversion events (pixels, conversion actions, conversion rules, …): use `id` as destination_id.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"include_inactive","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-conversion-destinations","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/conversion-destinations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_destination"]},"id":{"type":"string"},"name":{"type":["null","string"]},"type":{"type":["null","string"]},"status":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"conversion_events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"event_type":{"type":["null","string"]},"custom_event_name":{"type":["null","string"]},"archived":{"type":"boolean"},"optimizable":{"type":"boolean"}}}},"attribution_type":{"type":["null","string"]},"post_click_attribution_window_size":{"type":["null","number"]},"view_through_attribution_window_size":{"type":["null","number"]},"value_type":{"type":["null","string"]},"value":{"type":["null","object"],"properties":{"currency_code":{"type":["null","string"]},"amount":{"type":["null","string"]}}},"enabled":{"type":["null","boolean"]}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createConversionDestination","summary":"Create a conversion destination","tags":["Ads: accounts & measurement"],"description":"LinkedIn conversion rule (not idempotent) or Google Ads conversion action (reused by name).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":255},"attribution_type":{"type":"string","enum":["LAST_TOUCH_BY_CAMPAIGN","LAST_TOUCH_BY_CONVERSION"]},"post_click_attribution_window_size":{"type":"integer","enum":[1,7,30,90,365]},"view_through_attribution_window_size":{"type":"integer","enum":[1,7,30,90,365]},"value_type":{"type":"string","enum":["DYNAMIC","FIXED","NO_VALUE"]},"value":{"type":"object","additionalProperties":false,"required":["currency_code","amount"],"properties":{"currency_code":{"type":"string","pattern":"^[A-Za-z]{3}$"},"amount":{"anyOf":[{"type":"string","maxLength":32},{"type":"number"}]}}},"type":{"type":"string","minLength":1,"maxLength":64},"auto_association_type":{"type":"string","enum":["ALL_CAMPAIGNS","OBJECTIVE_BASED","NONE"]},"counting_type":{"type":"string","enum":["MANY_PER_CLICK","ONE_PER_CLICK"]},"primary_for_goal":{"type":"boolean"}},"required":["name","type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads_measurement","x-mcp-tool":"create-conversion-destination","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/accounts/{accountId}/conversion-destinations"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_destination"]},"id":{"type":"string"},"name":{"type":["null","string"]},"type":{"type":["null","string"]},"status":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"conversion_events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"event_type":{"type":["null","string"]},"custom_event_name":{"type":["null","string"]},"archived":{"type":"boolean"},"optimizable":{"type":"boolean"}}}},"attribution_type":{"type":["null","string"]},"post_click_attribution_window_size":{"type":["null","number"]},"view_through_attribution_window_size":{"type":["null","number"]},"value_type":{"type":["null","string"]},"value":{"type":["null","object"],"properties":{"currency_code":{"type":["null","string"]},"amount":{"type":["null","string"]}}},"enabled":{"type":["null","boolean"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}":{"get":{"operationId":"getConversionDestination","summary":"Get a conversion destination","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"destinationId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-conversion-destination","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/conversion-destinations/{destinationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_destination"]},"id":{"type":"string"},"name":{"type":["null","string"]},"type":{"type":["null","string"]},"status":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"conversion_events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"event_type":{"type":["null","string"]},"custom_event_name":{"type":["null","string"]},"archived":{"type":"boolean"},"optimizable":{"type":"boolean"}}}},"attribution_type":{"type":["null","string"]},"post_click_attribution_window_size":{"type":["null","number"]},"view_through_attribution_window_size":{"type":["null","number"]},"value_type":{"type":["null","string"]},"value":{"type":["null","object"],"properties":{"currency_code":{"type":["null","string"]},"amount":{"type":["null","string"]}}},"enabled":{"type":["null","boolean"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateConversionDestination","summary":"Update a conversion destination","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":255},"attribution_type":{"type":"string","enum":["LAST_TOUCH_BY_CAMPAIGN","LAST_TOUCH_BY_CONVERSION"]},"post_click_attribution_window_size":{"type":"integer","enum":[1,7,30,90,365]},"view_through_attribution_window_size":{"type":"integer","enum":[1,7,30,90,365]},"value_type":{"type":"string","enum":["DYNAMIC","FIXED","NO_VALUE"]},"value":{"type":"object","additionalProperties":false,"required":["currency_code","amount"],"properties":{"currency_code":{"type":"string","pattern":"^[A-Za-z]{3}$"},"amount":{"anyOf":[{"type":"string","maxLength":32},{"type":"number"}]}}},"enabled":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"destinationId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads_measurement","x-mcp-tool":"update-conversion-destination","x-feature":"ads","x-zernio":["PATCH /v1/accounts/{accountId}/conversion-destinations/{destinationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_destination"]},"id":{"type":"string"},"name":{"type":["null","string"]},"type":{"type":["null","string"]},"status":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"conversion_events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"event_type":{"type":["null","string"]},"custom_event_name":{"type":["null","string"]},"archived":{"type":"boolean"},"optimizable":{"type":"boolean"}}}},"attribution_type":{"type":["null","string"]},"post_click_attribution_window_size":{"type":["null","number"]},"view_through_attribution_window_size":{"type":["null","number"]},"value_type":{"type":["null","string"]},"value":{"type":["null","object"],"properties":{"currency_code":{"type":["null","string"]},"amount":{"type":["null","string"]}}},"enabled":{"type":["null","boolean"]}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteConversionDestination","summary":"Delete (disable) a conversion destination","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"destinationId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"delete-conversion-destination","x-feature":"ads","x-zernio":["DELETE /v1/accounts/{accountId}/conversion-destinations/{destinationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_destination"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"state":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/associations":{"get":{"operationId":"listConversionAssociations","summary":"List associated campaigns","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"destinationId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"list-conversion-associations","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/conversion-destinations/{destinationId}/associations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_association"]},"campaign_id":{"type":"string"},"conversion_id":{"type":"string"},"associated_at":{"type":["null","string"],"format":"date-time"}},"required":["object"]}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"addConversionAssociations","summary":"Associate campaigns","tags":["Ads: accounts & measurement"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"campaign_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64},"minItems":1,"maxItems":500}},"required":["campaign_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"destinationId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads_measurement","x-mcp-tool":"add-conversion-associations","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/accounts/{accountId}/conversion-destinations/{destinationId}/associations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_association_result"]},"succeeded":{"type":"array","items":{"type":"string"}},"failed":{"type":"array","items":{"type":"object","properties":{"campaign_id":{"type":"string"},"reason":{"type":"string"}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"removeConversionAssociations","summary":"Remove associated campaigns","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","maxLength":10000},"in":"query","name":"campaign_ids","required":true,"description":"Comma separated ids"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"destinationId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads_measurement","x-mcp-tool":"remove-conversion-associations","x-feature":"ads","x-zernio":["DELETE /v1/accounts/{accountId}/conversion-destinations/{destinationId}/associations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_association_result"]},"succeeded":{"type":"array","items":{"type":"string"}},"failed":{"type":"array","items":{"type":"object","properties":{"campaign_id":{"type":"string"},"reason":{"type":"string"}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/accounts/{adAccountId}/conversion-destinations/{destinationId}/metrics":{"get":{"operationId":"getConversionMetrics","summary":"Get attribution metrics","tags":["Ads: accounts & measurement"],"parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"start_date","required":true,"description":"YYYY-MM-DD"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"end_date","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","enum":["ALL","DAILY","MONTHLY","YEARLY"]},"in":"query","name":"granularity","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"ada_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"adAccountId","required":true,"description":"Ad account id (ada_…)"},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"destinationId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads_measurement","x-mcp-tool":"get-conversion-metrics","x-feature":"ads","x-zernio":["GET /v1/accounts/{accountId}/conversion-destinations/{destinationId}/metrics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["conversion_metrics"]},"destination_id":{"type":"string"},"granularity":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"start":{"type":["null","string"]},"end":{"type":["null","string"]},"metrics":{"type":"object","properties":{"external_website_conversions":{"type":"number"},"external_website_post_click_conversions":{"type":"number"},"external_website_post_view_conversions":{"type":"number"},"conversion_value_in_local_currency":{"type":"number"},"qualified_leads":{"type":"number"},"cost_in_local_currency":{"type":"number"}}}}}}},"required":["object"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/{platform}/ads":{"get":{"operationId":"connectAds","summary":"Connect ads for a platform","tags":["Ads"],"description":"Starts an ads connection. Returns the network authorization URL (`ads_connect_url`), or connects at once (`ads_connect_result`) when a posting account (`account_id`) already carries the ads scopes or the connection already exists (unless `force`).","parameters":[{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string","enum":["classic","business"]},"in":"query","name":"login_mode","required":false},{"schema":{"type":"string","enum":["full","advertise"]},"in":"query","name":"permission_level","required":false},{"schema":{"type":"string"},"in":"query","name":"page_id","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_account_ids","required":false},{"schema":{"type":"string"},"in":"query","name":"redirect_url","required":false},{"schema":{"type":"boolean"},"in":"query","name":"headless","required":false},{"schema":{"type":"boolean"},"in":"query","name":"force","required":false},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"path","name":"platform","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"ads","x-mcp-tool":"connect-ads","x-feature":"ads","x-zernio":["GET /v1/connect/{platform}/ads"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ads_connect_url"]},"platform":{"type":"string"},"login_mode":{"type":"string"},"url":{"type":"string"},"auth_url":{"type":"string"},"state":{"type":"string"},"expires_at":{"type":["string","null"],"format":"date-time"}}},{"type":"object","properties":{"object":{"type":"string","enum":["ads_connect_result"]},"status":{"type":"string"},"already_connected":{"type":"boolean"},"platform":{"type":"string"},"profile_id":{"type":["string","null"]},"connection":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_connection"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_accounts":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"ad_accounts":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_account"]},"id":{"type":"string"}}}},"redirect_url":{"type":["string","null"]}}}]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/ads/{platform}/callback":{"get":{"operationId":"adsConnectCallback","summary":"Ads OAuth redirect target","tags":["Ads"],"description":"Browser redirect target of every ads OAuth flow (Google, TikTok, LinkedIn, Pinterest, Reddit, X, Meta classic). Redirects to the caller `redirect_url` or the dashboard.","parameters":[{"schema":{"type":"string"},"in":"query","name":"state","required":false},{"schema":{"type":"string"},"in":"query","name":"code","required":false},{"schema":{"type":"string"},"in":"query","name":"auth_code","required":false},{"schema":{"type":"string"},"in":"query","name":"error","required":false},{"schema":{"type":"string"},"in":"query","name":"error_description","required":false},{"schema":{"type":"string"},"in":"query","name":"oauth_token","required":false},{"schema":{"type":"string"},"in":"query","name":"oauth_verifier","required":false},{"schema":{"type":"string"},"in":"path","name":"platform","required":true}],"security":[],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":null,"x-feature":"ads","responses":{"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/meta-ads/callback":{"get":{"operationId":"completeMetaAdsBusinessLogin","summary":"Complete Meta business login","tags":["Ads"],"description":"Facebook Login for Business redirect target (system-user token).","parameters":[{"schema":{"type":"string"},"in":"query","name":"state","required":true},{"schema":{"type":"string"},"in":"query","name":"code","required":false},{"schema":{"type":"string"},"in":"query","name":"error","required":false}],"security":[],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":null,"x-feature":"ads","x-zernio":["GET /v1/connect/meta-ads/callback"],"responses":{"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/tiktok-ads":{"patch":{"operationId":"setTiktokAdsBrandIdentity","summary":"Set TikTok brand identity","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["display_name","image_url"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"display_name":{"type":"string","minLength":1,"maxLength":40},"image_url":{"type":"string","format":"uri"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"set-tiktok-ads-brand-identity","x-feature":"ads","x-zernio":["PATCH /v1/connect/tiktok-ads"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["tiktok_brand_identity"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/connect/openai-ads/credentials":{"post":{"operationId":"connectOpenaiAds","summary":"Connect an OpenAI (ChatGPT) Ads account","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["api_key"],"properties":{"api_key":{"type":"string","minLength":8,"maxLength":500},"profile_id":{"type":"string"},"redirect_url":{"type":"string"},"redirect_uri":{"type":"string"},"state":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"connect-openai-ads","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/connect/openai-ads/credentials"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ads_connect_result"]},"status":{"type":"string"},"already_connected":{"type":"boolean"},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"connection":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_connection"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_accounts":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"ad_accounts":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_account"]},"id":{"type":"string"}}}},"redirect_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/connect/whop-ads/credentials":{"post":{"operationId":"connectWhopAds","summary":"Connect a Whop account","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["api_key"],"properties":{"api_key":{"type":"string","minLength":8,"maxLength":500},"profile_id":{"type":"string"},"redirect_url":{"type":"string"},"state":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"connect-whop-ads","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/connect/whop-ads/credentials"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ads_connect_result"]},"status":{"type":"string"},"already_connected":{"type":"boolean"},"platform":{"type":"string"},"profile_id":{"type":["null","string"]},"connection":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_connection"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_accounts":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"ad_accounts":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_account"]},"id":{"type":"string"}}}},"redirect_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/connections":{"get":{"operationId":"listAdConnections","summary":"List ads connections","tags":["Ads"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","platform","status"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string","enum":["active","needs_reconnect","disconnected"]},"in":"query","name":"status","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-connections","x-feature":"ads","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_connection"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_accounts":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{id}":{"get":{"operationId":"getAdConnection","summary":"Get an ads connection","tags":["Ads"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-connection","x-feature":"ads","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_connection"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_accounts":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAdConnection","summary":"Disconnect an ads connection","tags":["Ads"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"delete-ad-connection","x-feature":"ads","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_connection"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"token_revoked":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/connections/{id}/sync":{"post":{"operationId":"syncAdConnection","summary":"Queue an ads sync","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":["object","null"],"additionalProperties":false,"properties":{"backfill":{"type":"boolean"},"ad_account_ids":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads","x-mcp-tool":"sync-ad-connection","x-idempotent":true,"x-feature":"ads","responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_sync"]},"connection_id":{"type":"string"},"status":{"type":"string"},"backfill":{"type":"boolean"},"job_id":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads":{"get":{"operationId":"listAds","summary":"List ads","tags":["Ads"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name","status","updated_at","spend","impressions"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string","enum":["all","socialit","external"]},"in":"query","name":"source","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_set_id","required":false},{"schema":{"type":"string"},"in":"query","name":"search","required":false},{"schema":{"type":"boolean"},"in":"query","name":"has_delivery","required":false},{"schema":{"type":"number"},"in":"query","name":"min_spend","required":false},{"schema":{"type":"string"},"in":"query","name":"platform_ad_id","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":false},{"schema":{"type":"string"},"in":"query","name":"platform_post_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ads","x-feature":"ads","x-zernio":["GET /v1/ads"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"backfill_pending":{"type":"boolean"}},"required":["object","data","page","limit","has_more"]}}}},"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"backfill_pending":{"type":"boolean"}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAd","summary":"Create an ad (full tree)","tags":["Ads"],"description":"Builds campaign → ad set → creative → ad in one call, or attaches to an existing campaign (`existing_campaign_id`) or ad set (`ad_set_id`). `validate_only: true` dry-runs (Meta, Google, OpenAI).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["name"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string","minLength":1,"maxLength":400},"campaign_name":{"type":"string"},"ad_set_name":{"type":"string"},"ad_name":{"type":"string"},"goal":{"type":"string","enum":["engagement","traffic","awareness","video_views","lead_generation","lead_conversion","conversions","app_promotion","catalog_sales","page_likes","page_visits","job_applicants"]},"existing_campaign_id":{"type":"string"},"ad_set_id":{"type":"string"},"status":{"type":"string","enum":["active","paused"]},"campaign_status":{"type":"string","enum":["active","paused"]},"ad_set_status":{"type":"string","enum":["active","paused"]},"ad_status":{"type":"string","enum":["active","paused"]},"budget":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"number","minimum":0},"type":{"type":"string","enum":["daily","lifetime"],"default":"daily"}}},"budget_amount":{"type":"number","minimum":0},"budget_type":{"type":"string","enum":["daily","lifetime"]},"budget_level":{"type":"string","enum":["campaign","ad_set"]},"currency":{"type":"string"},"start_time":{"type":"string"},"end_time":{"type":"string"},"bid_strategy":{"type":"string"},"bid_amount":{"type":"number"},"roas_average_floor":{"type":"number"},"optimization_goal":{"type":"string"},"billing_event":{"type":"string"},"buying_type":{"type":"string"},"rf_prediction_id":{"type":"string"},"special_ad_categories":{"type":"array","items":{"type":"string"}},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"creative":{"type":"object","additionalProperties":true,"description":"CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …"},"creatives":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":true,"description":"CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …"}},"optimize_card_order":{"type":"boolean","description":"Meta carousels: false keeps your card order (max 5 cards); omit for Meta's default (true). Only with carousel_cards."},"page_id":{"type":"string"},"instagram_account_id":{"type":"string"},"identity_id":{"type":"string"},"identity_type":{"type":"string"},"organization_id":{"type":"string"},"board_id":{"type":"string"},"lead_gen_form_id":{"type":"string"},"phone_number":{"type":"string"},"campaign_type":{"type":"string","enum":["search","display","performance_max","demand_gen","video"]},"keywords":{"type":"array","items":{"type":"object","additionalProperties":true}},"negative_keywords":{"type":"array","items":{"type":"object","additionalProperties":true}},"headlines":{"type":"array","items":{}},"long_headline":{"type":"string"},"descriptions":{"type":"array","items":{}},"business_name":{"type":"string"},"asset_group":{"type":"object","additionalProperties":true},"demand_gen":{"type":"object","additionalProperties":true},"tracking":{"type":"object","additionalProperties":true},"platform_specific_data":{"type":"object","additionalProperties":true},"validate_only":{"type":"boolean"},"post_id":{"type":"string"},"platform_post_id":{"type":"string"},"link_url":{"type":"string"},"body":{"type":"string"},"headline":{"type":"string"},"image_url":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-ad","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/create"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_validation"]},"valid":{"type":"boolean"},"platform":{"type":"string"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_creation","ad_validation"]},"status":{"type":"string"},"platform":{"type":"string"},"valid":{"type":"boolean"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"campaign":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"goal":{"type":["string","null"]},"objective":{"type":["string","null"]},"review_status":{"type":["string","null"]},"buying_type":{"type":["string","null"]},"channel_type":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"campaign_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"optimization_goal":{"type":["string","null"]},"billing_event":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["object","null"],"additionalProperties":true},"learning_phase":{"type":["string","null"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"ad_set":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"campaign_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"optimization_goal":{"type":["string","null"]},"billing_event":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["object","null"],"additionalProperties":true},"learning_phase":{"type":["string","null"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"created":{"type":"array","items":{"type":"object","additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/campaigns":{"get":{"operationId":"listAdCampaigns","summary":"List campaigns","tags":["Ads"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name","status","updated_at","spend","impressions"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string","enum":["all","socialit","external"]},"in":"query","name":"source","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_set_id","required":false},{"schema":{"type":"string"},"in":"query","name":"search","required":false},{"schema":{"type":"boolean"},"in":"query","name":"has_delivery","required":false},{"schema":{"type":"number"},"in":"query","name":"min_spend","required":false},{"schema":{"type":"boolean"},"in":"query","name":"include_empty","required":false},{"schema":{"type":"boolean"},"in":"query","name":"live","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-campaigns","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"goal":{"type":["null","string"]},"objective":{"type":["null","string"]},"review_status":{"type":["null","string"]},"buying_type":{"type":["null","string"]},"channel_type":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"backfill_pending":{"type":"boolean"}},"required":["object","data","page","limit","has_more"]}}}},"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"goal":{"type":["null","string"]},"objective":{"type":["null","string"]},"review_status":{"type":["null","string"]},"buying_type":{"type":["null","string"]},"channel_type":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"backfill_pending":{"type":"boolean"}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAdCampaign","summary":"Create a campaign","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","goal"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string","minLength":1,"maxLength":400},"goal":{"type":"string","enum":["engagement","traffic","awareness","video_views","lead_generation","lead_conversion","conversions","app_promotion","catalog_sales","page_likes","page_visits","job_applicants"]},"status":{"type":"string","enum":["active","paused"]},"budget":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"number","minimum":0},"type":{"type":"string","enum":["daily","lifetime"],"default":"daily"}}},"budget_amount":{"type":"number"},"budget_type":{"type":"string","enum":["daily","lifetime"]},"budget_level":{"type":"string","enum":["campaign","ad_set"]},"buying_type":{"type":"string","enum":["AUCTION","RESERVED"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"special_ad_category_country":{"type":"array","items":{"type":"string"}},"promoted_object":{"type":"object","additionalProperties":true},"is_skadnetwork_attribution":{"type":"boolean"},"start_time":{"type":"string"},"end_time":{"type":"string"},"bid_strategy":{"type":"string"},"bid_amount":{"type":"number"},"roas_average_floor":{"type":"number"},"portfolio_bid_strategy_id":{"type":"string"},"target_impression_share":{"type":"object","additionalProperties":true},"manual_cpc":{"type":"object","additionalProperties":true},"network_settings":{"type":"object","additionalProperties":true},"location_targeting_type":{"type":"string"},"campaign_type":{"type":"string","enum":["search","display","performance_max","demand_gen"]},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"shared_budget_id":{"type":"string"},"platform_specific_data":{"type":"object","additionalProperties":true},"validate_only":{"type":"boolean"},"funding_instrument_id":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-ad-campaign","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/campaigns"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_validation"]},"valid":{"type":"boolean"},"platform":{"type":"string"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"goal":{"type":["null","string"]},"objective":{"type":["null","string"]},"review_status":{"type":["null","string"]},"buying_type":{"type":["null","string"]},"channel_type":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/ad-sets":{"get":{"operationId":"listAdSets","summary":"List ad sets","tags":["Ads"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name","status","updated_at","spend","impressions"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string","enum":["all","socialit","external"]},"in":"query","name":"source","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_set_id","required":false},{"schema":{"type":"string"},"in":"query","name":"search","required":false},{"schema":{"type":"boolean"},"in":"query","name":"has_delivery","required":false},{"schema":{"type":"number"},"in":"query","name":"min_spend","required":false},{"schema":{"type":"boolean"},"in":"query","name":"live","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-sets","x-feature":"ads","x-zernio":["GET /v1/ads/ad-sets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"backfill_pending":{"type":"boolean"}},"required":["object","data","page","limit","has_more"]}}}},"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"backfill_pending":{"type":"boolean"}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAdSet","summary":"Create an ad set","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["campaign_id","name"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"campaign_id":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":400},"status":{"type":"string","enum":["active","paused"]},"budget":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"number","minimum":0},"type":{"type":"string","enum":["daily","lifetime"],"default":"daily"}}},"bid_amount":{"type":"number"},"max_cpc":{"type":"number"},"bid_strategy":{"type":"string"},"optimization_goal":{"type":"string"},"billing_event":{"type":"string"},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"start_time":{"type":"string"},"end_time":{"type":"string"},"promoted_object":{"type":"object","additionalProperties":true},"customer_id":{"type":"string"},"platform_specific_data":{"type":"object","additionalProperties":true}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-ad-set","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/ad-sets"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/tree":{"get":{"operationId":"getAdTree","summary":"Get the campaign tree","tags":["Ads"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name","status","updated_at","spend","impressions"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string","enum":["all","socialit","external"]},"in":"query","name":"source","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_set_id","required":false},{"schema":{"type":"string"},"in":"query","name":"search","required":false},{"schema":{"type":"boolean"},"in":"query","name":"has_delivery","required":false},{"schema":{"type":"number"},"in":"query","name":"min_spend","required":false},{"schema":{"type":"string"},"in":"query","name":"updated_since","required":false},{"schema":{"type":"boolean"},"in":"query","name":"daily","required":false},{"schema":{"type":"string"},"in":"query","name":"daily_level","required":false},{"schema":{"type":"string"},"in":"query","name":"time_increment","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-tree","x-feature":"ads","x-zernio":["GET /v1/ads/tree"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"goal":{"type":["null","string"]},"objective":{"type":["null","string"]},"review_status":{"type":["null","string"]},"buying_type":{"type":["null","string"]},"channel_type":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"backfill_pending":{"type":"boolean"}},"required":["object","data","page","limit","has_more"]}}}},"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"goal":{"type":["null","string"]},"objective":{"type":["null","string"]},"review_status":{"type":["null","string"]},"buying_type":{"type":["null","string"]},"channel_type":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"backfill_pending":{"type":"boolean"}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/timeline":{"get":{"operationId":"getAdTimeline","summary":"Get daily account metrics","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-timeline","x-feature":"ads","x-zernio":["GET /v1/ads/timeline"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_timeline"]},"currency":{"type":["null","string"]},"from_date":{"type":"string"},"to_date":{"type":"string"},"backfill_pending":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}}}},"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_timeline"]},"currency":{"type":["null","string"]},"from_date":{"type":"string"},"to_date":{"type":"string"},"backfill_pending":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}":{"get":{"operationId":"getAdCampaign","summary":"Get campaign details","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"boolean"},"in":"query","name":"live","required":false},{"schema":{"type":"string"},"in":"query","name":"fields","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-campaign","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"goal":{"type":["null","string"]},"objective":{"type":["null","string"]},"review_status":{"type":["null","string"]},"buying_type":{"type":["null","string"]},"channel_type":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAdCampaign","summary":"Update a campaign","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"name":{"type":"string","minLength":1,"maxLength":400},"budget":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"number","minimum":0},"type":{"type":"string","enum":["daily","lifetime"],"default":"daily"}}},"shared_budget_id":{"type":"string"},"allow_shared_budget_update":{"type":"boolean"},"bid_strategy":{"type":"string"},"bid_amount":{"type":"number"},"roas_average_floor":{"type":"number"},"portfolio_bid_strategy_id":{"type":"string"},"target_impression_share":{"type":"object","additionalProperties":true},"manual_cpc":{"type":"object","additionalProperties":true},"network_settings":{"type":"object","additionalProperties":true},"tracking_url_template":{"type":"string"},"final_url_suffix":{"type":"string"},"start_time":{"type":"string"},"end_time":{"type":"string"},"spend_cap":{"type":["number","null"]},"platform_specific_data":{"type":"object","additionalProperties":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"update-ad-campaign","x-feature":"ads","x-zernio":["PUT /v1/ads/campaigns/{campaignId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"goal":{"type":["null","string"]},"objective":{"type":["null","string"]},"review_status":{"type":["null","string"]},"buying_type":{"type":["null","string"]},"channel_type":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAdCampaign","summary":"Delete a campaign","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"delete-ad-campaign","x-feature":"ads","x-zernio":["DELETE /v1/ads/campaigns/{campaignId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"archived":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/status":{"patch":{"operationId":"setAdCampaignStatus","summary":"Pause or resume a campaign","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"status":{"type":"string","enum":["active","paused"]},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"set-ad-campaign-status","x-feature":"ads","x-zernio":["PUT /v1/ads/campaigns/{campaignId}/status"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_status_change"]},"level":{"type":"string"},"id":{"type":["null","string"]},"external_id":{"type":"string"},"platform":{"type":"string"},"status":{"type":"string"},"platform_status":{"type":["null","string"]},"updated":{"type":"boolean"},"skipped":{"type":"boolean"},"skipped_reasons":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/bulk-status":{"post":{"operationId":"bulkSetAdCampaignStatus","summary":"Pause or resume many campaigns","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status","campaigns"],"properties":{"status":{"type":"string","enum":["active","paused"]},"campaigns":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["id"],"properties":{"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":"string"}}}}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads","x-mcp-tool":"bulk-set-ad-campaign-status","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/campaigns/bulk-status"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_bulk_status"]},"status":{"type":"string"},"totals":{"type":"object","properties":{"updated":{"type":"integer"},"skipped":{"type":"integer"},"failed":{"type":"integer"}}},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"external_id":{"type":["null","string"]},"platform":{"type":["null","string"]},"updated":{"type":"boolean"},"skipped":{"type":"boolean"},"platform_status":{"type":["null","string"]},"error":{"type":["null","string"]}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/campaigns/{id}/duplicate":{"post":{"operationId":"duplicateAdCampaign","summary":"Duplicate a campaign","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"deep_copy":{"type":"boolean"},"status_option":{"type":"string","enum":["paused","active","inherited"]},"start_time":{"type":"string"},"end_time":{"type":"string"},"rename_strategy":{"type":"string","enum":["none","prefix","suffix","deep_rename"]},"rename_prefix":{"type":"string"},"rename_suffix":{"type":"string"},"sync_after":{"type":"boolean"},"campaign_id":{"type":"string"},"ad_set_id":{"type":"string"},"reuse_source_creative":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"duplicate-ad-campaign","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/campaigns/{campaignId}/duplicate"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_duplicate"]},"level":{"type":"string"},"source_id":{"type":"string"},"copied_external_id":{"type":["null","string"]},"copied_id":{"type":["null","string"]},"sync":{"type":"string"},"raw":{"type":"object","additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/analytics":{"get":{"operationId":"getAdCampaignAnalytics","summary":"Get campaign analytics","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string"},"in":"query","name":"breakdowns","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-campaign-analytics","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}/analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_analytics"]},"level":{"type":"string"},"id":{"type":"string"},"platform":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"currency":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"from_date":{"type":"string"},"to_date":{"type":"string"},"backfill_pending":{"type":"boolean"},"summary":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}},"breakdowns":{"type":"object","additionalProperties":true},"unsupported_breakdowns":{"type":"array","items":{"type":"string"}},"breakdown_hints":{"type":"object","additionalProperties":true},"breakdown_errors":{"type":"object","additionalProperties":true},"breakdown_dropped_metrics":{"type":"object","additionalProperties":true},"breakdowns_range":{"anyOf":[{"type":"null"},{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}}}]}}}}}},"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_analytics"]},"level":{"type":"string"},"id":{"type":"string"},"platform":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"currency":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"from_date":{"type":"string"},"to_date":{"type":"string"},"backfill_pending":{"type":"boolean"},"summary":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}},"breakdowns":{"type":"object","additionalProperties":true},"unsupported_breakdowns":{"type":"array","items":{"type":"string"}},"breakdown_hints":{"type":"object","additionalProperties":true},"breakdown_errors":{"type":"object","additionalProperties":true},"breakdown_dropped_metrics":{"type":"object","additionalProperties":true},"breakdowns_range":{"anyOf":[{"type":"null"},{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}}}]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/bidding":{"get":{"operationId":"getAdCampaignBidding","summary":"Read a campaign's bidding","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-campaign-bidding","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}/bidding"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["campaign_bidding"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/ad-schedule":{"get":{"operationId":"getAdCampaignSchedule","summary":"Read a campaign's ad schedule","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"boolean"},"in":"query","name":"include_performance","required":false},{"schema":{"type":"integer","minimum":1,"maximum":90},"in":"query","name":"window_days","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-campaign-schedule","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}/ad-schedule"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_schedule"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"operationId":"replaceAdCampaignSchedule","summary":"Replace a campaign's ad schedule","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["schedule"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"schedule":{"type":"array","maxItems":42,"items":{"type":"object","additionalProperties":false,"required":["day_of_week","start_hour","end_hour"],"properties":{"day_of_week":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"start_hour":{"type":"integer","minimum":0,"maximum":23},"start_minute":{"type":"integer","enum":[0,15,30,45]},"end_hour":{"type":"integer","minimum":0,"maximum":24},"end_minute":{"type":"integer","enum":[0,15,30,45]},"bid_modifier":{"type":"number"}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"replace-ad-campaign-schedule","x-feature":"ads","x-zernio":["PUT /v1/ads/campaigns/{campaignId}/ad-schedule"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_schedule"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/targeting":{"get":{"operationId":"getAdCampaignTargeting","summary":"Read a Google campaign's targeting","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-campaign-targeting","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}/targeting"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["campaign_targeting"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"operationId":"replaceAdCampaignTargeting","summary":"Edit a Google campaign's targeting","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["targeting"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"targeting":{"type":"object","additionalProperties":false,"properties":{"devices":{"type":"array","items":{"type":"object","additionalProperties":true}},"locations":{"type":"array","items":{"type":"object","additionalProperties":true}},"excluded_locations":{"type":"array","items":{"type":"object","additionalProperties":true}},"languages":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"replace-ad-campaign-targeting","x-feature":"ads","x-zernio":["PUT /v1/ads/campaigns/{campaignId}/targeting"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["campaign_targeting"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/negative-keywords":{"get":{"operationId":"listAdCampaignNegativeKeywords","summary":"List campaign negative keywords","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-campaign-negative-keywords","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}/negative-keywords"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["negative_keyword"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"operationId":"replaceAdCampaignNegativeKeywords","summary":"Replace campaign negative keywords","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["keywords"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"keywords":{"type":"array","maxItems":5000,"items":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":80},"match_type":{"type":"string","enum":["exact","phrase","broad"]}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"replace-ad-campaign-negative-keywords","x-feature":"ads","x-zernio":["PUT /v1/ads/campaigns/{campaignId}/negative-keywords"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["negative_keyword"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/negative-keyword-lists":{"get":{"operationId":"listAdCampaignNegativeKeywordLists","summary":"List campaign negative keyword lists","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-campaign-negative-keyword-lists","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}/negative-keyword-lists"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["negative_keyword_list"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"put":{"operationId":"replaceAdCampaignNegativeKeywordLists","summary":"Replace campaign negative keyword lists","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["list_ids"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"list_ids":{"type":"array","maxItems":20,"items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"replace-ad-campaign-negative-keyword-lists","x-feature":"ads","x-zernio":["PUT /v1/ads/campaigns/{campaignId}/negative-keyword-lists"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["negative_keyword_list"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/assets":{"get":{"operationId":"listAdCampaignAssets","summary":"List campaign assets","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-campaign-assets","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}/assets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_asset"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"addAdCampaignAssets","summary":"Attach campaign assets","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"sitelinks":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":true}},"callouts":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":true}},"structured_snippets":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":true}},"images":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":true}},"customer_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"add-ad-campaign-assets","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/campaigns/{campaignId}/assets"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_asset"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAdCampaignAssets","summary":"Update campaign assets","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["updates"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"updates":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":true}},"customer_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"update-ad-campaign-assets","x-feature":"ads","x-zernio":["PUT /v1/ads/campaigns/{campaignId}/assets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_asset"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"removeAdCampaignAssets","summary":"Remove campaign assets","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"asset_ids","required":false},{"schema":{"type":"string"},"in":"query","name":"link_ids","required":false},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"remove-ad-campaign-assets","x-feature":"ads","x-zernio":["DELETE /v1/ads/campaigns/{campaignId}/assets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_asset_removal"]},"removed":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/conversion-goals":{"get":{"operationId":"getAdCampaignConversionGoals","summary":"Get campaign conversion goals","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-campaign-conversion-goals","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}/conversion-goals"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["campaign_conversion_goals"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAdCampaignConversionGoals","summary":"Update campaign conversion goals","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"goals":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["category","origin","biddable"],"properties":{"category":{"type":"string"},"origin":{"type":"string"},"biddable":{"type":"boolean"}}}},"goal_config_level":{"type":"string","enum":["customer","campaign"]},"custom_conversion_goal_id":{"type":["string","null"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"update-ad-campaign-conversion-goals","x-feature":"ads","x-zernio":["PATCH /v1/ads/campaigns/{campaignId}/conversion-goals"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["campaign_conversion_goals"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/asset-groups":{"get":{"operationId":"listAdAssetGroups","summary":"List Performance Max asset groups","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-asset-groups","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}/asset-groups"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["asset_group"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAdAssetGroup","summary":"Create a Performance Max asset group","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","final_urls"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"name":{"type":"string","minLength":1,"maxLength":255},"final_urls":{"type":"array","minItems":1,"items":{"type":"string"}},"final_mobile_urls":{"type":"array","items":{"type":"string"}},"path1":{"type":"string"},"path2":{"type":"string"},"status":{"type":"string","enum":["enabled","paused"]},"assets":{"type":"object","additionalProperties":true},"listing_group_filter":{"type":"object","additionalProperties":true},"validate_only":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-ad-asset-group","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/campaigns/{campaignId}/asset-groups"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_validation"]},"valid":{"type":"boolean"},"platform":{"type":"string"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["asset_group"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/asset-groups/{assetGroupId}":{"get":{"operationId":"getAdAssetGroup","summary":"Get a Performance Max asset group","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"assetGroupId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-asset-group","x-feature":"ads","x-zernio":["GET /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["asset_group"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAdAssetGroup","summary":"Update a Performance Max asset group","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"name":{"type":"string"},"status":{"type":"string","enum":["enabled","paused"]},"final_urls":{"type":"array","items":{"type":"string"}},"final_mobile_urls":{"type":"array","items":{"type":"string"}},"path1":{"type":"string"},"path2":{"type":"string"},"validate_only":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"assetGroupId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"update-ad-asset-group","x-feature":"ads","x-zernio":["PATCH /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["asset_group"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAdAssetGroup","summary":"Remove a Performance Max asset group","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"boolean"},"in":"query","name":"validate_only","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"assetGroupId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"delete-ad-asset-group","x-feature":"ads","x-zernio":["DELETE /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["asset_group"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"archived":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/asset-groups/{assetGroupId}/assets":{"post":{"operationId":"linkAdAssetGroupAssets","summary":"Link or unlink asset group assets","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"link":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":true}},"unlink":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":true}},"validate_only":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"assetGroupId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads","x-mcp-tool":"link-ad-asset-group-assets","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}/assets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["asset_group"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/campaigns/{id}/asset-groups/{assetGroupId}/listing-group-filters":{"put":{"operationId":"replaceAdListingGroupFilters","summary":"Replace an asset group's listing-group tree","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["tree"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"tree":{"type":"object","additionalProperties":true},"validate_only":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"assetGroupId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"replace-ad-listing-group-filters","x-feature":"ads","x-zernio":["PUT /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId}/listing-group-filters"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["listing_group_tree"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/ad-sets/{id}":{"get":{"operationId":"getAdSet","summary":"Get ad set details","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"boolean"},"in":"query","name":"live","required":false},{"schema":{"type":"string"},"in":"query","name":"fields","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-set","x-feature":"ads","x-zernio":["GET /v1/ads/ad-sets/{adSetId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAdSet","summary":"Update an ad set","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"name":{"type":"string"},"status":{"type":"string","enum":["active","paused"]},"budget":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"number","minimum":0},"type":{"type":"string","enum":["daily","lifetime"],"default":"daily"}}},"bid_strategy":{"type":"string"},"bid_amount":{"type":"number"},"roas_average_floor":{"type":"number"},"smart_targeting":{"type":"boolean"},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"start_time":{"type":"string"},"end_time":{"type":"string"},"value_rule_set_id":{"type":"string"},"value_rules_applied":{"type":"boolean"},"optimization_goal":{"type":"string"},"platform_specific_data":{"type":"object","additionalProperties":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"update-ad-set","x-feature":"ads","x-zernio":["PUT /v1/ads/ad-sets/{adSetId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"campaign_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["null","number"]},"optimization_goal":{"type":["null","string"]},"billing_event":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["null","object"],"additionalProperties":true},"learning_phase":{"type":["null","string"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAdSet","summary":"Delete an ad set","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"delete-ad-set","x-feature":"ads","x-zernio":["DELETE /v1/ads/ad-sets/{adSetId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"archived":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/ad-sets/{id}/status":{"patch":{"operationId":"setAdSetStatus","summary":"Pause or resume an ad set","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"status":{"type":"string","enum":["active","paused"]},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"set-ad-set-status","x-feature":"ads","x-zernio":["PUT /v1/ads/ad-sets/{adSetId}/status"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_status_change"]},"level":{"type":"string"},"id":{"type":["null","string"]},"external_id":{"type":"string"},"platform":{"type":"string"},"status":{"type":"string"},"platform_status":{"type":["null","string"]},"updated":{"type":"boolean"},"skipped":{"type":"boolean"},"skipped_reasons":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/ad-sets/{id}/duplicate":{"post":{"operationId":"duplicateAdSet","summary":"Duplicate an ad set","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"deep_copy":{"type":"boolean"},"status_option":{"type":"string","enum":["paused","active","inherited"]},"start_time":{"type":"string"},"end_time":{"type":"string"},"rename_strategy":{"type":"string","enum":["none","prefix","suffix","deep_rename"]},"rename_prefix":{"type":"string"},"rename_suffix":{"type":"string"},"sync_after":{"type":"boolean"},"campaign_id":{"type":"string"},"ad_set_id":{"type":"string"},"reuse_source_creative":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"duplicate-ad-set","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/ad-sets/{adSetId}/duplicate"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_duplicate"]},"level":{"type":"string"},"source_id":{"type":"string"},"copied_external_id":{"type":["null","string"]},"copied_id":{"type":["null","string"]},"sync":{"type":"string"},"raw":{"type":"object","additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/ad-sets/{id}/assets":{"get":{"operationId":"listAdSetAssets","summary":"List ad-group assets","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-set-assets","x-feature":"ads","x-zernio":["GET /v1/ads/ad-sets/{adSetId}/assets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_asset"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"addAdSetAssets","summary":"Attach ad-group assets","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"sitelinks":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":true}},"callouts":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":true}},"structured_snippets":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":true}},"images":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":true}},"customer_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"add-ad-set-assets","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/ad-sets/{adSetId}/assets"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_asset"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAdSetAssets","summary":"Update ad-group assets","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["updates"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"updates":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":true}},"customer_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"update-ad-set-assets","x-feature":"ads","x-zernio":["PUT /v1/ads/ad-sets/{adSetId}/assets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_asset"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"removeAdSetAssets","summary":"Remove ad-group assets","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"asset_ids","required":false},{"schema":{"type":"string"},"in":"query","name":"link_ids","required":false},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"remove-ad-set-assets","x-feature":"ads","x-zernio":["DELETE /v1/ads/ad-sets/{adSetId}/assets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_asset_removal"]},"removed":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/boost":{"post":{"operationId":"boostAdPost","summary":"Boost a post as an ad","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["name","goal"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string","minLength":1,"maxLength":400},"campaign_name":{"type":"string"},"ad_set_name":{"type":"string"},"ad_name":{"type":"string"},"goal":{"type":"string","enum":["engagement","traffic","awareness","video_views","lead_generation","lead_conversion","conversions","app_promotion","catalog_sales","page_likes","page_visits","job_applicants"]},"existing_campaign_id":{"type":"string"},"ad_set_id":{"type":"string"},"status":{"type":"string","enum":["active","paused"]},"campaign_status":{"type":"string","enum":["active","paused"]},"ad_set_status":{"type":"string","enum":["active","paused"]},"ad_status":{"type":"string","enum":["active","paused"]},"budget":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"number","minimum":0},"type":{"type":"string","enum":["daily","lifetime"],"default":"daily"}}},"budget_amount":{"type":"number","minimum":0},"budget_type":{"type":"string","enum":["daily","lifetime"]},"budget_level":{"type":"string","enum":["campaign","ad_set"]},"currency":{"type":"string"},"start_time":{"type":"string"},"end_time":{"type":"string"},"bid_strategy":{"type":"string"},"bid_amount":{"type":"number"},"roas_average_floor":{"type":"number"},"optimization_goal":{"type":"string"},"billing_event":{"type":"string"},"buying_type":{"type":"string"},"rf_prediction_id":{"type":"string"},"special_ad_categories":{"type":"array","items":{"type":"string"}},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"creative":{"type":"object","additionalProperties":true,"description":"CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …"},"creatives":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":true,"description":"CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …"}},"optimize_card_order":{"type":"boolean","description":"Meta carousels: false keeps your card order (max 5 cards); omit for Meta's default (true). Only with carousel_cards."},"page_id":{"type":"string"},"instagram_account_id":{"type":"string"},"identity_id":{"type":"string"},"identity_type":{"type":"string"},"organization_id":{"type":"string"},"board_id":{"type":"string"},"lead_gen_form_id":{"type":"string"},"phone_number":{"type":"string"},"campaign_type":{"type":"string","enum":["search","display","performance_max","demand_gen","video"]},"keywords":{"type":"array","items":{"type":"object","additionalProperties":true}},"negative_keywords":{"type":"array","items":{"type":"object","additionalProperties":true}},"headlines":{"type":"array","items":{}},"long_headline":{"type":"string"},"descriptions":{"type":"array","items":{}},"business_name":{"type":"string"},"asset_group":{"type":"object","additionalProperties":true},"demand_gen":{"type":"object","additionalProperties":true},"tracking":{"type":"object","additionalProperties":true},"platform_specific_data":{"type":"object","additionalProperties":true},"validate_only":{"type":"boolean"},"post_id":{"type":"string"},"platform_post_id":{"type":"string"},"link_url":{"type":"string"},"body":{"type":"string"},"headline":{"type":"string"},"image_url":{"type":"string"},"destination_type":{"type":"string","enum":["WEBSITE","MESSENGER","INSTAGRAM_DIRECT"]},"spark_auth_code":{"type":"string"},"call_to_action":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"boost-ad-post","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/boost"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_validation"]},"valid":{"type":"boolean"},"platform":{"type":"string"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_creation","ad_validation"]},"status":{"type":"string"},"platform":{"type":"string"},"valid":{"type":"boolean"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"campaign":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"goal":{"type":["string","null"]},"objective":{"type":["string","null"]},"review_status":{"type":["string","null"]},"buying_type":{"type":["string","null"]},"channel_type":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"campaign_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"optimization_goal":{"type":["string","null"]},"billing_event":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["object","null"],"additionalProperties":true},"learning_phase":{"type":["string","null"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"ad_set":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"campaign_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"optimization_goal":{"type":["string","null"]},"billing_event":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["object","null"],"additionalProperties":true},"learning_phase":{"type":["string","null"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"created":{"type":"array","items":{"type":"object","additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/messaging":{"post":{"operationId":"createMessagingAd","summary":"Create a click-to-message ad","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["name","destination"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string","minLength":1,"maxLength":400},"campaign_name":{"type":"string"},"ad_set_name":{"type":"string"},"ad_name":{"type":"string"},"goal":{"type":"string","enum":["engagement","traffic","awareness","video_views","lead_generation","lead_conversion","conversions","app_promotion","catalog_sales","page_likes","page_visits","job_applicants"]},"existing_campaign_id":{"type":"string"},"ad_set_id":{"type":"string"},"status":{"type":"string","enum":["active","paused"]},"campaign_status":{"type":"string","enum":["active","paused"]},"ad_set_status":{"type":"string","enum":["active","paused"]},"ad_status":{"type":"string","enum":["active","paused"]},"budget":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"number","minimum":0},"type":{"type":"string","enum":["daily","lifetime"],"default":"daily"}}},"budget_amount":{"type":"number","minimum":0},"budget_type":{"type":"string","enum":["daily","lifetime"]},"budget_level":{"type":"string","enum":["campaign","ad_set"]},"currency":{"type":"string"},"start_time":{"type":"string"},"end_time":{"type":"string"},"bid_strategy":{"type":"string"},"bid_amount":{"type":"number"},"roas_average_floor":{"type":"number"},"optimization_goal":{"type":"string"},"billing_event":{"type":"string"},"buying_type":{"type":"string"},"rf_prediction_id":{"type":"string"},"special_ad_categories":{"type":"array","items":{"type":"string"}},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"creative":{"type":"object","additionalProperties":true,"description":"CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …"},"creatives":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":true,"description":"CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …"}},"optimize_card_order":{"type":"boolean","description":"Meta carousels: false keeps your card order (max 5 cards); omit for Meta's default (true). Only with carousel_cards."},"page_id":{"type":"string"},"instagram_account_id":{"type":"string"},"identity_id":{"type":"string"},"identity_type":{"type":"string"},"organization_id":{"type":"string"},"board_id":{"type":"string"},"lead_gen_form_id":{"type":"string"},"phone_number":{"type":"string"},"campaign_type":{"type":"string","enum":["search","display","performance_max","demand_gen","video"]},"keywords":{"type":"array","items":{"type":"object","additionalProperties":true}},"negative_keywords":{"type":"array","items":{"type":"object","additionalProperties":true}},"headlines":{"type":"array","items":{}},"long_headline":{"type":"string"},"descriptions":{"type":"array","items":{}},"business_name":{"type":"string"},"asset_group":{"type":"object","additionalProperties":true},"demand_gen":{"type":"object","additionalProperties":true},"tracking":{"type":"object","additionalProperties":true},"platform_specific_data":{"type":"object","additionalProperties":true},"validate_only":{"type":"boolean"},"post_id":{"type":"string"},"platform_post_id":{"type":"string"},"link_url":{"type":"string"},"body":{"type":"string"},"headline":{"type":"string"},"image_url":{"type":"string"},"destination":{"type":"string","enum":["messenger","instagram_direct"]},"welcome_message":{"type":"object","additionalProperties":true},"workflow_id":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-messaging-ad","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/messaging"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_validation"]},"valid":{"type":"boolean"},"platform":{"type":"string"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_creation","ad_validation"]},"status":{"type":"string"},"platform":{"type":"string"},"valid":{"type":"boolean"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"campaign":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"goal":{"type":["string","null"]},"objective":{"type":["string","null"]},"review_status":{"type":["string","null"]},"buying_type":{"type":["string","null"]},"channel_type":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"campaign_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"optimization_goal":{"type":["string","null"]},"billing_event":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["object","null"],"additionalProperties":true},"learning_phase":{"type":["string","null"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"ad_set":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"campaign_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"optimization_goal":{"type":["string","null"]},"billing_event":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["object","null"],"additionalProperties":true},"learning_phase":{"type":["string","null"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"created":{"type":"array","items":{"type":"object","additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/call":{"post":{"operationId":"createCallAd","summary":"Create a click-to-call ad","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["name","phone_number"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string","minLength":1,"maxLength":400},"campaign_name":{"type":"string"},"ad_set_name":{"type":"string"},"ad_name":{"type":"string"},"goal":{"type":"string","enum":["engagement","traffic","awareness","video_views","lead_generation","lead_conversion","conversions","app_promotion","catalog_sales","page_likes","page_visits","job_applicants"]},"existing_campaign_id":{"type":"string"},"ad_set_id":{"type":"string"},"status":{"type":"string","enum":["active","paused"]},"campaign_status":{"type":"string","enum":["active","paused"]},"ad_set_status":{"type":"string","enum":["active","paused"]},"ad_status":{"type":"string","enum":["active","paused"]},"budget":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"number","minimum":0},"type":{"type":"string","enum":["daily","lifetime"],"default":"daily"}}},"budget_amount":{"type":"number","minimum":0},"budget_type":{"type":"string","enum":["daily","lifetime"]},"budget_level":{"type":"string","enum":["campaign","ad_set"]},"currency":{"type":"string"},"start_time":{"type":"string"},"end_time":{"type":"string"},"bid_strategy":{"type":"string"},"bid_amount":{"type":"number"},"roas_average_floor":{"type":"number"},"optimization_goal":{"type":"string"},"billing_event":{"type":"string"},"buying_type":{"type":"string"},"rf_prediction_id":{"type":"string"},"special_ad_categories":{"type":"array","items":{"type":"string"}},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"creative":{"type":"object","additionalProperties":true,"description":"CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …"},"creatives":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":true,"description":"CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …"}},"optimize_card_order":{"type":"boolean","description":"Meta carousels: false keeps your card order (max 5 cards); omit for Meta's default (true). Only with carousel_cards."},"page_id":{"type":"string"},"instagram_account_id":{"type":"string"},"identity_id":{"type":"string"},"identity_type":{"type":"string"},"organization_id":{"type":"string"},"board_id":{"type":"string"},"lead_gen_form_id":{"type":"string"},"phone_number":{"type":"string"},"campaign_type":{"type":"string","enum":["search","display","performance_max","demand_gen","video"]},"keywords":{"type":"array","items":{"type":"object","additionalProperties":true}},"negative_keywords":{"type":"array","items":{"type":"object","additionalProperties":true}},"headlines":{"type":"array","items":{}},"long_headline":{"type":"string"},"descriptions":{"type":"array","items":{}},"business_name":{"type":"string"},"asset_group":{"type":"object","additionalProperties":true},"demand_gen":{"type":"object","additionalProperties":true},"tracking":{"type":"object","additionalProperties":true},"platform_specific_data":{"type":"object","additionalProperties":true},"validate_only":{"type":"boolean"},"post_id":{"type":"string"},"platform_post_id":{"type":"string"},"link_url":{"type":"string"},"body":{"type":"string"},"headline":{"type":"string"},"image_url":{"type":"string"},"call_to_action":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-call-ad","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/call"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_validation"]},"valid":{"type":"boolean"},"platform":{"type":"string"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_creation","ad_validation"]},"status":{"type":"string"},"platform":{"type":"string"},"valid":{"type":"boolean"},"results":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"campaign":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad_campaign"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"goal":{"type":["string","null"]},"objective":{"type":["string","null"]},"review_status":{"type":["string","null"]},"buying_type":{"type":["string","null"]},"channel_type":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"special_ad_categories":{"type":"array","items":{"type":"string"}},"ad_set_count":{"type":"integer"},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}},"ad_sets":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"campaign_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"optimization_goal":{"type":["string","null"]},"billing_event":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["object","null"],"additionalProperties":true},"learning_phase":{"type":["string","null"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"ad_set":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad_set"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"campaign_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"is_smart_plus":{"type":"boolean"},"roas_average_floor":{"type":["number","null"]},"optimization_goal":{"type":["string","null"]},"billing_event":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"promoted_object":{"type":["object","null"],"additionalProperties":true},"learning_phase":{"type":["string","null"]},"ad_count":{"type":"integer"},"settings":{"type":"object","additionalProperties":true},"ads":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"null"}]},"created":{"type":"array","items":{"type":"object","additionalProperties":true}},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/{id}":{"get":{"operationId":"getAd","summary":"Get an ad","tags":["Ads"],"description":"With a Facebook post id (`<pageId>_<postId>`) and `ad_account_id`, a placement dark post that maps to no single ad answers `ad: null` + `dark_post`; moderate its comments with the same id on `/ads/{id}/comments`.","parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"boolean"},"in":"query","name":"live","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad","x-feature":"ads","x-zernio":["GET /v1/ads/{adId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["string","null"]},"connection_id":{"type":["string","null"]},"profile_id":{"type":["string","null"]},"external_id":{"type":"string"},"name":{"type":["string","null"]},"status":{"type":"string"},"configured_status":{"type":["string","null"]},"platform_status":{"type":["string","null"]},"budget":{"type":["object","null"],"properties":{"amount":{"type":["number","null"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["string","null"]}}},"currency":{"type":["string","null"]},"bid_strategy":{"type":["string","null"]},"bid_amount":{"type":["number","null"]},"start_time":{"type":["string","null"],"format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["object","null"],"properties":{"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["string","null"]},"last_synced_at":{"type":["string","null"],"format":"date-time"}}},"platform_created_at":{"type":["string","null"],"format":"date-time"},"synced_at":{"type":["string","null"],"format":"date-time"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"network":{"type":["string","null"]},"campaign_id":{"type":["string","null"]},"ad_set_id":{"type":["string","null"]},"campaign_external_id":{"type":["string","null"]},"ad_set_external_id":{"type":["string","null"]},"campaign_name":{"type":["string","null"]},"ad_set_name":{"type":["string","null"]},"ad_type":{"type":"string"},"creative_type":{"type":["string","null"]},"goal":{"type":["string","null"]},"review_status":{"type":["string","null"]},"rejection_reason":{"type":["string","null"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["string","null"]},"platform_post_id":{"type":["string","null"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["number","null"]},"impressions":{"type":["number","null"]},"reach":{"type":["number","null"]},"frequency":{"type":["number","null"]},"clicks":{"type":["number","null"]},"link_clicks":{"type":["number","null"]},"ctr":{"type":["number","null"]},"cpc":{"type":["number","null"]},"cpm":{"type":["number","null"]},"engagement":{"type":["number","null"]},"video_views":{"type":["number","null"]},"conversions":{"type":["number","null"]},"conversion_value":{"type":["number","null"]},"cost_per_conversion":{"type":["number","null"]},"roas":{"type":["number","null"]},"leads":{"type":["number","null"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}},{"type":"object","properties":{"object":{"type":"string","enum":["ad_dark_post"]},"id":{"type":"string"},"platform":{"type":"string"},"ad":{"type":"null"},"dark_post":{"type":"object","properties":{"platform":{"type":"string"},"platform_post_id":{"type":"string"},"page_id":{"type":"string"},"platform_ad_account_ids":{"type":"array","items":{"type":"string"}},"is_published":{"type":"boolean"},"first_seen_at":{"type":["string","null"],"format":"date-time"},"last_activity_at":{"type":["string","null"],"format":"date-time"}}}}}]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAd","summary":"Update an ad","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"name":{"type":"string"},"status":{"type":"string","enum":["active","paused"]},"budget":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"number","minimum":0},"type":{"type":"string","enum":["daily","lifetime"],"default":"daily"}}},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"creative":{"type":"object","additionalProperties":true,"description":"CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …"},"headlines":{"type":"array","maxItems":15,"items":{}},"descriptions":{"type":"array","maxItems":5,"items":{}},"final_urls":{"type":"array","items":{"type":"string"}},"asset_group":{"type":"object","additionalProperties":true},"demand_gen":{"type":"object","additionalProperties":true},"page_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"update-ad","x-feature":"ads","x-zernio":["PUT /v1/ads/{adId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":"string"},"configured_status":{"type":["null","string"]},"platform_status":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"currency":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"bid_amount":{"type":["null","number"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"is_external":{"type":"boolean"},"metrics":{"type":["null","object"],"properties":{"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true},"currency":{"type":["null","string"]},"last_synced_at":{"type":["null","string"],"format":"date-time"}}},"platform_created_at":{"type":["null","string"],"format":"date-time"},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"network":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"campaign_external_id":{"type":["null","string"]},"ad_set_external_id":{"type":["null","string"]},"campaign_name":{"type":["null","string"]},"ad_set_name":{"type":["null","string"]},"ad_type":{"type":"string"},"creative_type":{"type":["null","string"]},"goal":{"type":["null","string"]},"review_status":{"type":["null","string"]},"rejection_reason":{"type":["null","string"]},"creative":{"type":"object","additionalProperties":true},"post_id":{"type":["null","string"]},"platform_post_id":{"type":["null","string"]},"targeting":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAd","summary":"Delete an ad","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"delete-ad","x-feature":"ads","x-zernio":["DELETE /v1/ads/{adId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"archived":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{id}/status":{"patch":{"operationId":"setAdStatus","summary":"Pause or resume an ad","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"status":{"type":"string","enum":["active","paused"]},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"set-ad-status","x-feature":"ads","x-zernio":["PUT /v1/ads/{adId}/status"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_status_change"]},"level":{"type":"string"},"id":{"type":["null","string"]},"external_id":{"type":"string"},"platform":{"type":"string"},"status":{"type":"string"},"platform_status":{"type":["null","string"]},"updated":{"type":"boolean"},"skipped":{"type":"boolean"},"skipped_reasons":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{id}/duplicate":{"post":{"operationId":"duplicateAd","summary":"Duplicate an ad","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"platform":{"type":"string","minLength":1,"maxLength":40,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},"deep_copy":{"type":"boolean"},"status_option":{"type":"string","enum":["paused","active","inherited"]},"start_time":{"type":"string"},"end_time":{"type":"string"},"rename_strategy":{"type":"string","enum":["none","prefix","suffix","deep_rename"]},"rename_prefix":{"type":"string"},"rename_suffix":{"type":"string"},"sync_after":{"type":"boolean"},"campaign_id":{"type":"string"},"ad_set_id":{"type":"string"},"reuse_source_creative":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"duplicate-ad","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/{adId}/duplicate"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_duplicate"]},"level":{"type":"string"},"source_id":{"type":"string"},"copied_external_id":{"type":["null","string"]},"copied_id":{"type":["null","string"]},"sync":{"type":"string"},"raw":{"type":"object","additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{id}/analytics":{"get":{"operationId":"getAdAnalytics","summary":"Get ad analytics","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string"},"in":"query","name":"breakdowns","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-analytics","x-feature":"ads","x-zernio":["GET /v1/ads/{adId}/analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_analytics"]},"level":{"type":"string"},"id":{"type":"string"},"platform":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"currency":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"from_date":{"type":"string"},"to_date":{"type":"string"},"backfill_pending":{"type":"boolean"},"summary":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}},"breakdowns":{"type":"object","additionalProperties":true},"unsupported_breakdowns":{"type":"array","items":{"type":"string"}},"breakdown_hints":{"type":"object","additionalProperties":true},"breakdown_errors":{"type":"object","additionalProperties":true},"breakdown_dropped_metrics":{"type":"object","additionalProperties":true},"breakdowns_range":{"anyOf":[{"type":"null"},{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}}}]}}}}}},"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_analytics"]},"level":{"type":"string"},"id":{"type":"string"},"platform":{"type":"string"},"name":{"type":["null","string"]},"status":{"type":["null","string"]},"currency":{"type":["null","string"]},"budget":{"type":["null","object"],"properties":{"amount":{"type":["null","number"]},"type":{"type":"string"},"level":{"type":"string"},"shared_budget_id":{"type":["null","string"]}}},"from_date":{"type":"string"},"to_date":{"type":"string"},"backfill_pending":{"type":"boolean"},"summary":{"type":"object","additionalProperties":true},"daily":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"spend":{"type":["null","number"]},"impressions":{"type":["null","number"]},"reach":{"type":["null","number"]},"frequency":{"type":["null","number"]},"clicks":{"type":["null","number"]},"link_clicks":{"type":["null","number"]},"ctr":{"type":["null","number"]},"cpc":{"type":["null","number"]},"cpm":{"type":["null","number"]},"engagement":{"type":["null","number"]},"video_views":{"type":["null","number"]},"conversions":{"type":["null","number"]},"conversion_value":{"type":["null","number"]},"cost_per_conversion":{"type":["null","number"]},"roas":{"type":["null","number"]},"leads":{"type":["null","number"]},"actions":{"type":"object","additionalProperties":true},"action_values":{"type":"object","additionalProperties":true}}}},"breakdowns":{"type":"object","additionalProperties":true},"unsupported_breakdowns":{"type":"array","items":{"type":"string"}},"breakdown_hints":{"type":"object","additionalProperties":true},"breakdown_errors":{"type":"object","additionalProperties":true},"breakdown_dropped_metrics":{"type":"object","additionalProperties":true},"breakdowns_range":{"anyOf":[{"type":"null"},{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}}}]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{id}/preview":{"get":{"operationId":"getAdPreviews","summary":"Render previews of an ad","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string"},"in":"query","name":"formats","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-previews","x-feature":"ads","x-zernio":["GET /v1/ads/{adId}/preview"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_preview"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{id}/review":{"get":{"operationId":"getAdReview","summary":"Read an ad's review verdict","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-review","x-feature":"ads","x-zernio":["GET /v1/ads/{adId}/review"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_review"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/{id}/media":{"get":{"operationId":"getAdMedia","summary":"Direct URLs of an ad's media","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-media","x-feature":"ads","x-zernio":["GET /v1/ads/{adId}/media"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_media"]},"ad_id":{"type":["null","string"]},"platform":{"type":"string"},"media":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/preview":{"post":{"operationId":"previewAdCreative","summary":"Render pre-create ad previews","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"formats":{"type":"array","items":{"type":"string"}},"existing_creative_id":{"type":"string"},"creative":{"type":"object","additionalProperties":true,"description":"CreativeInput: headline, body, description, call_to_action, link_url, image_url, image_hash, video { url | id }, carousel_cards[], existing_creative_id, url_tags, …"},"creative_spec":{"type":"object","additionalProperties":true},"page_id":{"type":"string"},"instagram_account_id":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"preview-ad-creative","x-feature":"ads","x-zernio":["POST /v1/ads/preview"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_preview"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/creatives":{"get":{"operationId":"listAdCreatives","summary":"Creative library","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"string"},"in":"query","name":"fields","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-creatives","x-feature":"ads","x-zernio":["GET /v1/ads/creatives"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_creative"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAdCreative","summary":"Create a standalone creative","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["headline","body","link_url"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string"},"page_id":{"type":"string"},"instagram_account_id":{"type":"string"},"headline":{"type":"string"},"body":{"type":"string"},"description":{"type":"string"},"call_to_action":{"type":"string"},"link_url":{"type":"string"},"optimize_card_order":{"type":"boolean"},"image_url":{"type":"string"},"image_hash":{"type":"string"},"video":{"type":"object","additionalProperties":true},"carousel_cards":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":true}},"url_tags":{"type":"string"},"promotion":{"type":"object","additionalProperties":true},"creative_features":{"type":"object","additionalProperties":true},"multi_advertiser":{"type":"boolean"},"ai_disclosure":{"type":"object","additionalProperties":true}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-ad-creative","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/creatives"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_creative"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/creatives/{creativeId}":{"get":{"operationId":"getAdCreative","summary":"Creative details","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"fields","required":false},{"schema":{"type":"integer"},"in":"query","name":"thumbnail_width","required":false},{"schema":{"type":"integer"},"in":"query","name":"thumbnail_height","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"creativeId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-creative","x-feature":"ads","x-zernio":["GET /v1/ads/creatives/{creativeId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_creative"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"renameAdCreative","summary":"Rename a creative","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string","minLength":1,"maxLength":400}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"creativeId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"rename-ad-creative","x-feature":"ads","x-zernio":["PUT /v1/ads/creatives/{creativeId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_creative"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAdCreative","summary":"Delete a creative","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"creativeId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"delete-ad-creative","x-feature":"ads","x-zernio":["DELETE /v1/ads/creatives/{creativeId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_creative"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"archived":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/images":{"post":{"operationId":"uploadAdImage","summary":"Upload an ad image","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"image_base64":{"type":"string","maxLength":41000000},"image_url":{"type":"string"},"filename":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"upload-ad-image","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/images"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_image"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listAdImages","summary":"Ad image library","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"string"},"in":"query","name":"fields","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-images","x-feature":"ads","x-zernio":["GET /v1/ads/images"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_image"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/videos":{"post":{"operationId":"uploadAdVideo","summary":"Upload an ad video","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"video_url":{"type":"string"},"video_base64":{"type":"string","maxLength":140000000},"filename":{"type":"string"},"title":{"type":"string"},"async":{"type":"boolean"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"upload-ad-video","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/videos"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_video"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listAdVideos","summary":"Ad video library","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"string"},"in":"query","name":"fields","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-videos","x-feature":"ads","x-zernio":["GET /v1/ads/videos"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_video"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/videos/{videoId}":{"get":{"operationId":"getAdVideo","summary":"Get ad video processing status","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"videoId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-video","x-feature":"ads","x-zernio":["GET /v1/ads/videos/{videoId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_video"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAdVideo","summary":"Delete an ad video","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"videoId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"delete-ad-video","x-feature":"ads","x-zernio":["DELETE /v1/ads/videos/{videoId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_video"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"archived":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/tiktok-identities":{"get":{"operationId":"listTiktokAdIdentities","summary":"List TikTok ad identities","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-tiktok-ad-identities","x-feature":"ads","x-zernio":["GET /v1/ads/tiktok-identities"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["tiktok_identity"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/partnership-content":{"get":{"operationId":"listAdPartnershipContent","summary":"List partnership ad content","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"creator_username","required":false},{"schema":{"type":"string"},"in":"query","name":"post_url","required":false},{"schema":{"type":"boolean"},"in":"query","name":"only_allowlisted","required":false},{"schema":{"type":"string"},"in":"query","name":"instagram_account_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-partnership-content","x-feature":"ads","x-zernio":["GET /v1/ads/partnership-content"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["partnership_content"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/partnership-permissions":{"get":{"operationId":"listAdPartnershipPermissions","summary":"List partnership permissions","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"creator_username","required":false},{"schema":{"type":"string"},"in":"query","name":"instagram_account_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-partnership-permissions","x-feature":"ads","x-zernio":["GET /v1/ads/partnership-permissions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["partnership_permission"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"setAdPartnershipPermission","summary":"Set a partnership permission","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["creator_username"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"creator_username":{"type":"string","minLength":1,"maxLength":100},"revoke":{"type":"boolean"},"instagram_account_id":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads","x-mcp-tool":"set-ad-partnership-permission","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/partnership-permissions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["partnership_permission"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/insights":{"get":{"operationId":"getAdInsights","summary":"Flexible live insights query","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"object_id","required":false},{"schema":{"type":"string","enum":["account","campaign","ad_set","ad"]},"in":"query","name":"level","required":false},{"schema":{"type":"string"},"in":"query","name":"fields","required":false},{"schema":{"type":"string"},"in":"query","name":"breakdowns","required":false},{"schema":{"type":"string"},"in":"query","name":"action_breakdowns","required":false},{"schema":{"type":"string"},"in":"query","name":"action_attribution_windows","required":false},{"schema":{"type":"string"},"in":"query","name":"action_report_time","required":false},{"schema":{"type":"boolean"},"in":"query","name":"use_unified_attribution_setting","required":false},{"schema":{"type":"string"},"in":"query","name":"filtering","required":false},{"schema":{"type":"string"},"in":"query","name":"date_preset","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string"},"in":"query","name":"time_increment","required":false},{"schema":{"type":"string","maxLength":10000},"in":"query","name":"query","required":false},{"schema":{"type":"string"},"in":"query","name":"report_type","required":false},{"schema":{"type":"string"},"in":"query","name":"data_level","required":false},{"schema":{"type":"string"},"in":"query","name":"dimensions","required":false},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false},{"schema":{"type":"integer","minimum":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":1000},"in":"query","name":"page_size","required":false},{"schema":{"type":"string"},"in":"query","name":"page_token","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-insights","x-feature":"ads","x-zernio":["GET /v1/ads/insights"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_insights"]},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"level":{"type":["null","string"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"summary":{"type":["null","object"],"additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/insights/reports":{"post":{"operationId":"createAdInsightsReport","summary":"Submit an async insights report","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"object_id":{"type":"string"},"level":{"type":"string","enum":["account","campaign","ad_set","ad"]},"fields":{"type":"array","items":{"type":"string"}},"breakdowns":{"type":"array","items":{"type":"string"}},"action_breakdowns":{"type":"array","items":{"type":"string"}},"action_attribution_windows":{"type":"array","items":{"type":"string"}},"action_report_time":{"type":"string"},"use_unified_attribution_setting":{"type":"boolean"},"filtering":{"type":"array","items":{"type":"object","additionalProperties":true}},"date_preset":{"type":"string"},"from_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"time_increment":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-ad-insights-report","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/insights/reports"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_insights_report"]},"id":{"type":"string"},"status":{"type":"string"},"percent_complete":{"type":["null","number"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/insights/reports/{reportId}":{"get":{"operationId":"getAdInsightsReport","summary":"Poll an async insights report","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"reportId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-insights-report","x-feature":"ads","x-zernio":["GET /v1/ads/insights/reports/{reportRunId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_insights_report"]},"id":{"type":"string"},"status":{"type":"string"},"percent_complete":{"type":["null","number"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/tiktok-smart-plus-materials":{"get":{"operationId":"getTiktokSmartPlusMaterials","summary":"TikTok Smart+ per-creative performance","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"start_date","required":true},{"schema":{"type":"string"},"in":"query","name":"end_date","required":true},{"schema":{"type":"string","enum":["ad","material"]},"in":"query","name":"level","required":false},{"schema":{"type":"string"},"in":"query","name":"smart_plus_ad_ids","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_group_ids","required":false},{"schema":{"type":"integer","minimum":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"page_size","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-tiktok-smart-plus-materials","x-feature":"ads","x-zernio":["GET /v1/ads/tiktok-smart-plus-materials"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["smart_plus_material"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/search-terms":{"get":{"operationId":"getAdSearchTerms","summary":"Google Ads search terms report","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string"},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_set_id","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_group_id","required":false},{"schema":{"type":"string"},"in":"query","name":"page_token","required":false},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-search-terms","x-feature":"ads","x-zernio":["GET /v1/ads/search-terms"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["search_term"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/local-services/leads":{"get":{"operationId":"listLocalServicesLeads","summary":"Google Local Services Ads leads","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string"},"in":"query","name":"lead_type","required":false},{"schema":{"type":"string"},"in":"query","name":"lead_status","required":false},{"schema":{"type":"boolean"},"in":"query","name":"charged_only","required":false},{"schema":{"type":"string"},"in":"query","name":"page_token","required":false},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-local-services-leads","x-feature":"ads","x-zernio":["GET /v1/ads/local-services/leads"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["local_services_lead"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/local-services/leads/{leadId}/conversations":{"get":{"operationId":"listLocalServicesLeadConversations","summary":"List Local Services lead conversations","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"page_token","required":false},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"leadId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-local-services-lead-conversations","x-feature":"ads","x-zernio":["GET /v1/ads/local-services/leads/{leadId}/conversations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["local_services_lead_conversation"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/keywords/ideas":{"post":{"operationId":"generateAdKeywordIdeas","summary":"Generate keyword ideas","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"customer_id":{"type":"string"},"countries":{"type":"array","items":{"type":"string"}},"language_id":{"type":"string"},"network":{"type":"string","enum":["GOOGLE_SEARCH","GOOGLE_SEARCH_AND_PARTNERS"]},"include_adult_keywords":{"type":"boolean"},"seed_keywords":{"type":"array","maxItems":20,"items":{"type":"string"}},"seed_url":{"type":"string"},"page_size":{"type":"integer","minimum":1,"maximum":10000},"page_token":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"generate-ad-keyword-ideas","x-feature":"ads","x-zernio":["POST /v1/ads/keywords/ideas"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["keyword_idea"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/keywords/historical-metrics":{"post":{"operationId":"getAdKeywordHistoricalMetrics","summary":"Get historical keyword metrics","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["keywords"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"customer_id":{"type":"string"},"countries":{"type":"array","items":{"type":"string"}},"language_id":{"type":"string"},"network":{"type":"string","enum":["GOOGLE_SEARCH","GOOGLE_SEARCH_AND_PARTNERS"]},"include_adult_keywords":{"type":"boolean"},"keywords":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"string"}},"include_average_cpc":{"type":"boolean"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-keyword-historical-metrics","x-feature":"ads","x-zernio":["POST /v1/ads/keywords/historical-metrics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["keyword_idea"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/keywords":{"get":{"operationId":"listAdKeywords","summary":"List Search keywords","tags":["Ads"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","text"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_set_id","required":false},{"schema":{"type":"string","enum":["enabled","paused","removed"]},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["exact","phrase","broad"]},"in":"query","name":"match_type","required":false},{"schema":{"type":"boolean"},"in":"query","name":"negative","required":false},{"schema":{"type":"string"},"in":"query","name":"search","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-keywords","x-feature":"ads","x-zernio":["GET /v1/ads/keywords"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_keyword"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"external_id":{"type":"string"},"criterion_id":{"type":["null","string"]},"text":{"type":"string"},"match_type":{"type":["null","string"]},"negative":{"type":"boolean"},"status":{"type":"string"},"cpc_bid":{"type":["null","number"]},"final_url":{"type":["null","string"]},"quality_score":{"type":["null","integer"]},"metrics":{"type":["null","object"],"additionalProperties":true},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"addAdKeywords","summary":"Add Search keywords","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ad_set_id","keywords"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"ad_set_id":{"type":"string"},"keywords":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","minLength":1,"maxLength":80},"match_type":{"type":"string","enum":["exact","phrase","broad"]},"cpc_bid":{"type":"number","minimum":0},"final_url":{"type":"string"}}}},"negative":{"type":"boolean"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"add-ad-keywords","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/keywords"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_keyword"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"external_id":{"type":"string"},"criterion_id":{"type":["null","string"]},"text":{"type":"string"},"match_type":{"type":["null","string"]},"negative":{"type":"boolean"},"status":{"type":"string"},"cpc_bid":{"type":["null","number"]},"final_url":{"type":["null","string"]},"quality_score":{"type":["null","integer"]},"metrics":{"type":["null","object"],"additionalProperties":true},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/keywords/{id}":{"patch":{"operationId":"updateAdKeyword","summary":"Pause or enable a Search keyword","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"status":{"type":"string","enum":["enabled","paused"]},"cpc_bid":{"type":"number","minimum":0}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"update-ad-keyword","x-feature":"ads","x-zernio":["PATCH /v1/ads/keywords/{keywordId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_keyword"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"campaign_id":{"type":["null","string"]},"ad_set_id":{"type":["null","string"]},"external_id":{"type":"string"},"criterion_id":{"type":["null","string"]},"text":{"type":"string"},"match_type":{"type":["null","string"]},"negative":{"type":"boolean"},"status":{"type":"string"},"cpc_bid":{"type":["null","number"]},"final_url":{"type":["null","string"]},"quality_score":{"type":["null","integer"]},"metrics":{"type":["null","object"],"additionalProperties":true},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAdKeyword","summary":"Remove a Search keyword","tags":["Ads"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"delete-ad-keyword","x-feature":"ads","x-zernio":["DELETE /v1/ads/keywords/{keywordId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_keyword"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"archived":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/recommendations":{"get":{"operationId":"listAdRecommendations","summary":"List Google Ads recommendations","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"string"},"in":"query","name":"types","required":false},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-recommendations","x-feature":"ads","x-zernio":["GET /v1/ads/recommendations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_recommendation"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/recommendations/apply":{"post":{"operationId":"applyAdRecommendations","summary":"Apply Google Ads recommendations","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["recommendations"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"recommendations":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["id"],"properties":{"id":{"type":"string"},"parameters":{"type":"object","additionalProperties":true}}}},"customer_id":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads","x-mcp-tool":"apply-ad-recommendations","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/recommendations/apply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_recommendation_result"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/recommendations/dismiss":{"post":{"operationId":"dismissAdRecommendations","summary":"Dismiss Google Ads recommendations","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"ids":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string"}},"resource_names":{"type":"array","maxItems":100,"items":{"type":"string"}},"customer_id":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads","x-mcp-tool":"dismiss-ad-recommendations","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/recommendations/dismiss"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_recommendation_result"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/bid-strategies":{"get":{"operationId":"listAdBidStrategies","summary":"List portfolio bid strategies","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from_date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to_date","required":false},{"schema":{"type":"string"},"in":"query","name":"customer_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-bid-strategies","x-feature":"ads","x-zernio":["GET /v1/ads/bid-strategies"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["bid_strategy"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAdBidStrategy","summary":"Create a portfolio bid strategy","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","type"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string","minLength":1,"maxLength":255},"type":{"type":"string","enum":["TARGET_CPA","TARGET_ROAS","MAXIMIZE_CONVERSIONS","MAXIMIZE_CONVERSION_VALUE","TARGET_IMPRESSION_SHARE","TARGET_SPEND"]},"target_cpa":{"type":"number"},"target_roas":{"type":"number"},"target_impression_share":{"type":"object","additionalProperties":true},"customer_id":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-ad-bid-strategy","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/bid-strategies"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["bid_strategy"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/bid-strategies/{strategyId}":{"patch":{"operationId":"updateAdBidStrategy","summary":"Update a portfolio bid strategy","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string"},"type":{"type":"string"},"target_cpa":{"type":"number"},"target_roas":{"type":"number"},"target_impression_share":{"type":"object","additionalProperties":true},"customer_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"strategyId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"update-ad-bid-strategy","x-feature":"ads","x-zernio":["PATCH /v1/ads/bid-strategies/{strategyId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["bid_strategy"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/shared-budgets":{"get":{"operationId":"listAdSharedBudgets","summary":"List shared budgets","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-shared-budgets","x-feature":"ads","x-zernio":["GET /v1/ads/shared-budgets"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["shared_budget"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAdSharedBudget","summary":"Create a shared budget","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","amount"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string","minLength":1,"maxLength":255},"amount":{"type":"number","exclusiveMinimum":0},"type":{"type":"string","enum":["daily"]},"delivery_method":{"type":"string","enum":["standard","accelerated"]}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-ad-shared-budget","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/shared-budgets"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["shared_budget"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/interests":{"get":{"operationId":"searchAdInterests","summary":"Search targeting interests","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"query","name":"q","required":true},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"search-ad-interests","x-feature":"ads","x-zernio":["GET /v1/ads/interests"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["targeting_option"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/targeting/search":{"get":{"operationId":"searchAdTargeting","summary":"Search targeting options","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":200},"in":"query","name":"q","required":true},{"schema":{"type":"string"},"in":"query","name":"dimension","required":false},{"schema":{"type":"string"},"in":"query","name":"geo_type","required":false},{"schema":{"type":"string"},"in":"query","name":"country_code","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"search-ad-targeting","x-feature":"ads","x-zernio":["GET /v1/ads/targeting/search"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["targeting_option"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/targeting/browse":{"get":{"operationId":"browseAdTargeting","summary":"Browse targeting categories","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string"},"in":"query","name":"type","required":false},{"schema":{"type":"string"},"in":"query","name":"parent_id","required":false},{"schema":{"type":"boolean"},"in":"query","name":"selectable","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"browse-ad-targeting","x-feature":"ads","x-zernio":["GET /v1/ads/targeting/browse"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["targeting_option"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/targeting/reach-estimate":{"post":{"operationId":"estimateAdReach","summary":"Estimate audience reach","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"spec":{"type":"object","additionalProperties":true},"optimization_goal":{"type":"string"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"estimate-ad-reach","x-feature":"ads","x-zernio":["POST /v1/ads/targeting/reach-estimate"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["reach_estimate"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/targeting/bid-pricing":{"post":{"operationId":"getAdBidPricing","summary":"Suggested bid and budget bounds","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"spec":{"type":"object","additionalProperties":true},"campaign_type":{"type":"string"},"bid_type":{"type":"string","enum":["CPM","CPC","CPV"]},"match_type":{"type":"string"},"currency":{"type":"string"},"objective_type":{"type":"string"},"optimization_target_type":{"type":"string"},"daily_budget":{"type":"number"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-bid-pricing","x-feature":"ads","x-zernio":["POST /v1/ads/targeting/bid-pricing"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["bid_pricing"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/targeting/supply-forecast":{"post":{"operationId":"getAdSupplyForecast","summary":"Forecast ad delivery","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["time_range_start","time_range_end"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"spec":{"type":"object","additionalProperties":true},"campaign_type":{"type":"string"},"time_range_start":{"type":"string"},"time_range_end":{"type":"string"},"objective_type":{"type":"string"},"optimization_target":{"type":"string"},"daily_budget":{"type":"number"},"total_budget":{"type":"number"},"currency":{"type":"string"},"competing_bid":{"type":"number"},"enable_audience_network":{"type":"boolean"},"enable_audience_expansion":{"type":"boolean"},"connected_television_only":{"type":"boolean"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-supply-forecast","x-feature":"ads","x-zernio":["POST /v1/ads/targeting/supply-forecast"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["supply_forecast"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/audiences":{"get":{"operationId":"listAdAudiences","summary":"List custom audiences","tags":["Ads"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","name"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"type","required":false},{"schema":{"type":"boolean"},"in":"query","name":"live","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"list-ad-audiences","x-feature":"ads","x-zernio":["GET /v1/ads/audiences"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["ad_audience"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"type":{"type":"string"},"subtype":{"type":["null","string"]},"status":{"type":"string"},"size":{"type":["null","number"]},"size_lower":{"type":["null","number"]},"size_upper":{"type":["null","number"]},"spec":{"type":"object","additionalProperties":true},"uploaded_count":{"type":"integer"},"last_uploaded_at":{"type":["null","string"],"format":"date-time"},"platform_status":{"type":["null","string"]},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createAdAudience","summary":"Create a custom audience","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name","type"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"name":{"type":"string","minLength":1,"maxLength":255},"description":{"type":"string","maxLength":1000},"type":{"type":"string","enum":["customer_list","website","lookalike","engagement","saved","company_list"]},"customer_file_source":{"type":"string"},"retention_days":{"type":"integer","minimum":1,"maximum":540},"rule":{"type":"object","additionalProperties":true},"pixel_id":{"type":"string"},"source_audience_id":{"type":"string"},"country":{"type":"string"},"ratio":{"type":"number","minimum":0.01,"maximum":0.2},"engagement_source":{"type":"object","additionalProperties":true},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"spec":{"type":"object","additionalProperties":true},"users":{"type":"array","maxItems":10000,"items":{"type":"object","additionalProperties":true}},"hashed":{"type":"boolean"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-ad-audience","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/audiences"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_audience"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"type":{"type":"string"},"subtype":{"type":["null","string"]},"status":{"type":"string"},"size":{"type":["null","number"]},"size_lower":{"type":["null","number"]},"size_upper":{"type":["null","number"]},"spec":{"type":"object","additionalProperties":true},"uploaded_count":{"type":"integer"},"last_uploaded_at":{"type":["null","string"],"format":"date-time"},"platform_status":{"type":["null","string"]},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/audiences/{id}":{"get":{"operationId":"getAdAudience","summary":"Get audience details","tags":["Ads"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-audience","x-feature":"ads","x-zernio":["GET /v1/ads/audiences/{audienceId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_audience"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"type":{"type":"string"},"subtype":{"type":["null","string"]},"status":{"type":"string"},"size":{"type":["null","number"]},"size_lower":{"type":["null","number"]},"size_upper":{"type":["null","number"]},"spec":{"type":"object","additionalProperties":true},"uploaded_count":{"type":"integer"},"last_uploaded_at":{"type":["null","string"],"format":"date-time"},"platform_status":{"type":["null","string"]},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateAdAudience","summary":"Update an audience","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"type":["string","null"],"maxLength":1000},"spec":{"type":"object","additionalProperties":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"ads","x-mcp-tool":"update-ad-audience","x-feature":"ads","x-zernio":["PUT /v1/ads/audiences/{audienceId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_audience"]},"id":{"type":"string"},"platform":{"type":"string"},"ad_account_id":{"type":["null","string"]},"connection_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"external_id":{"type":"string"},"name":{"type":["null","string"]},"description":{"type":["null","string"]},"type":{"type":"string"},"subtype":{"type":["null","string"]},"status":{"type":"string"},"size":{"type":["null","number"]},"size_lower":{"type":["null","number"]},"size_upper":{"type":["null","number"]},"spec":{"type":"object","additionalProperties":true},"uploaded_count":{"type":"integer"},"last_uploaded_at":{"type":["null","string"],"format":"date-time"},"platform_status":{"type":["null","string"]},"synced_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteAdAudience","summary":"Delete a custom audience","tags":["Ads"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"delete-ad-audience","x-feature":"ads","x-zernio":["DELETE /v1/ads/audiences/{audienceId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["ad_audience"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"archived":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/audiences/{id}/users":{"post":{"operationId":"addAdAudienceUsers","summary":"Add users to an audience","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["users"],"properties":{"users":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string"},"phone":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"},"country":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"external_id":{"type":"string"},"mobile_advertiser_id":{"type":"string"}}}},"operation":{"type":"string","enum":["add","remove"]},"hashed":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads","x-mcp-tool":"add-ad-audience-users","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/audiences/{audienceId}/users"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_audience_upload"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/audiences/{id}/companies":{"post":{"operationId":"replaceAdAudienceCompanies","summary":"Replace audience companies","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["companies"],"properties":{"companies":{"type":"array","minItems":1,"maxItems":300000,"items":{"type":"object","additionalProperties":false,"properties":{"company_name":{"type":"string"},"company_website":{"type":"string"},"company_email_domain":{"type":"string"},"linkedin_company_page_url":{"type":"string"},"organization_urn":{"type":"string"}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads","x-mcp-tool":"replace-ad-audience-companies","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/audiences/{audienceId}/companies"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_audience_upload"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/library":{"get":{"operationId":"searchAdLibrary","summary":"Search the public Ad Library","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"platform","required":false,"description":"Ad platform (meta_ads, google_ads, linkedin_ads, tiktok_ads, pinterest_ads, x_ads, reddit_ads, openai_ads) or an alias (facebook, instagram, googleads, twitter, …)"},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"string"},"in":"query","name":"page_ids","required":false},{"schema":{"type":"string"},"in":"query","name":"advertiser","required":false},{"schema":{"type":"string"},"in":"query","name":"countries","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_type","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"platforms","required":false},{"schema":{"type":"string"},"in":"query","name":"media_type","required":false},{"schema":{"type":"string"},"in":"query","name":"languages","required":false},{"schema":{"type":"string"},"in":"query","name":"since","required":false},{"schema":{"type":"string"},"in":"query","name":"until","required":false},{"schema":{"type":"string"},"in":"query","name":"search_type","required":false},{"schema":{"type":"string"},"in":"query","name":"fields","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"search-ad-library","x-feature":"ads","x-zernio":["GET /v1/ads/library"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["ad_library_ad"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"next_cursor":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/rf-predictions":{"post":{"operationId":"createAdReachFrequencyPrediction","summary":"Create a reach & frequency prediction","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["start_time","end_time"],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},"budget_amount":{"type":"number","exclusiveMinimum":0},"reach":{"type":"integer","minimum":1},"start_time":{"type":"string"},"end_time":{"type":"string"},"frequency_cap":{"type":"object","additionalProperties":true},"targeting":{"type":"object","additionalProperties":true,"description":"Normalized targeting (countries, regions, cities, zips, age_min, age_max, genders, languages, interests, audience_ids, placements, keywords, subreddits, job_titles, …) or `raw` (native spec)"},"placements":{"type":"object","additionalProperties":true},"objective":{"type":"string"},"prediction_mode":{"type":"integer"}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"ads","x-mcp-tool":"create-ad-reach-frequency-prediction","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/rf-predictions"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["rf_prediction"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/ads/rf-predictions/{predictionId}":{"get":{"operationId":"getAdReachFrequencyPrediction","summary":"Get a reach & frequency prediction","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"predictionId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"ads","x-mcp-tool":"get-ad-reach-frequency-prediction","x-feature":"ads","x-zernio":["GET /v1/ads/rf-predictions/{predictionId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["rf_prediction"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"cancelAdReachFrequencyPrediction","summary":"Cancel a reach & frequency booking","tags":["Ads"],"parameters":[{"schema":{"type":"string","maxLength":80},"in":"query","name":"ad_account_id","required":false,"description":"Ad account (ada_…)"},{"schema":{"type":"string","maxLength":80},"in":"query","name":"connection_id","required":false,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},{"schema":{"type":"string","maxLength":120},"in":"query","name":"platform_ad_account_id","required":false,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"},{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"predictionId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"ads","x-mcp-tool":"cancel-ad-reach-frequency-prediction","x-feature":"ads","x-zernio":["DELETE /v1/ads/rf-predictions/{predictionId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["rf_prediction"]},"id":{"type":"string"},"deleted":{"type":"boolean"},"archived":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/ads/rf-predictions/{predictionId}/reserve":{"post":{"operationId":"reserveAdReachFrequencyPrediction","summary":"Reserve reach & frequency inventory","tags":["Ads"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":[],"properties":{"ad_account_id":{"type":"string","maxLength":80,"description":"Ad account (ada_…)"},"connection_id":{"type":"string","maxLength":80,"description":"Ads connection (adc_…); with platform_ad_account_id when it reaches several ad accounts"},"platform_ad_account_id":{"type":"string","maxLength":120,"description":"Network ad account id (act_123, Google customer id, TikTok advertiser id…)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":300},"in":"path","name":"predictionId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"ads","x-mcp-tool":"reserve-ad-reach-frequency-prediction","x-idempotent":true,"x-feature":"ads","x-zernio":["POST /v1/ads/rf-predictions/{predictionId}/reserve"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"object":{"type":"string","enum":["rf_prediction"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers":{"get":{"operationId":"listPhoneNumbers","summary":"List phone numbers","tags":["Telephony"],"description":"Numbers bought or ported into Socialit (released numbers only with status=released).","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string","enum":["created_at","phone_number"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","enum":["pending_payment","pending_regulatory","regulatory_declined","provisioning","verifying","porting","active","suspended","releasing","released"]},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string","minLength":2,"maxLength":2},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2 country"},{"schema":{"type":"string","enum":["sms","voice"]},"in":"query","name":"feature","required":false},{"schema":{"type":"string","maxLength":32},"in":"query","name":"q","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-phone-numbers","x-feature":"telephony","x-zernio":["GET /v1/phone-numbers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"purchasePhoneNumber","summary":"Purchase a phone number","tags":["Telephony"],"description":"Buys a number (201), or returns 202 kyc_required for regulated countries. purchase_intent_id makes retries idempotent (200 with the bought number).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"profile_id":{"type":"string","maxLength":80,"minLength":1},"country":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"number_type":{"type":"string","enum":["local","mobile","national","toll_free"]},"area_code":{"type":"string","maxLength":10},"phone_number":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"},"claim_id":{"type":"string","maxLength":80},"wants_sms":{"type":"boolean"},"purchase_intent_id":{"type":"string","maxLength":100,"minLength":1},"allow_multiple":{"type":"boolean"}},"required":["profile_id"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"purchase-phone-number","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/purchase"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_order"]},"id":{"type":["null","string"]},"status":{"type":"string"},"country":{"type":"string"},"number_type":{"type":"string"},"kyc_url":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"purchase_intent_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/phone-numbers/countries":{"get":{"operationId":"listPhoneNumberCountries","summary":"List offerable number countries","tags":["Telephony"],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-phone-number-countries","x-zernio":["GET /v1/phone-numbers/countries"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_country"]},"code":{"type":"string"},"name":{"type":"string"},"tier":{"type":"integer"},"monthly_cents":{"type":"integer"},"needs_kyc":{"type":"boolean"},"calls_available":{"type":"boolean"},"sms_available":{"type":"boolean"},"in_stock":{"type":"boolean"},"pre_orderable":{"type":"boolean"},"number_types":{"type":"array","items":{"type":"string"}},"types":{"type":"array","items":{"type":"object","properties":{"number_type":{"type":"string"},"tier":{"type":["null","integer"]},"needs_kyc":{"type":"boolean"},"monthly_cents":{"type":"integer"},"sms_available":{"type":"boolean"},"calls_available":{"type":"boolean"},"in_stock":{"type":"boolean"},"fulfilment":{"type":"string"},"pre_orderable":{"type":"boolean"}}}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/available":{"get":{"operationId":"searchAvailablePhoneNumbers","summary":"Search available numbers","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":2,"maxLength":2},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2 country"},{"schema":{"type":"string","enum":["local","mobile","national","toll_free"]},"in":"query","name":"number_type","required":false},{"schema":{"type":"string","maxLength":10},"in":"query","name":"area_code","required":false},{"schema":{"type":"string","maxLength":120},"in":"query","name":"locality","required":false},{"schema":{"type":"string","maxLength":15},"in":"query","name":"contains","required":false},{"schema":{"type":"string","maxLength":15},"in":"query","name":"prefix","required":false},{"schema":{"type":"boolean"},"in":"query","name":"sms","required":false},{"schema":{"type":"boolean"},"in":"query","name":"voice","required":false},{"schema":{"type":"integer","minimum":1,"maximum":50},"in":"query","name":"limit","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"search-available-phone-numbers","x-rate-limit":{"max":60,"timeWindow":"1 minute"},"x-zernio":["GET /v1/phone-numbers/available"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["available_phone_number"]},"phone_number":{"type":"string"},"masked_number":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"locality":{"type":["null","string"]},"region":{"type":["null","string"]},"best_effort":{"type":"boolean"},"features":{"type":"array","items":{"type":"string"}},"monthly_cents":{"type":"integer"},"claim_id":{"type":["null","string"]},"claim_url":{"type":["null","string"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/availability":{"get":{"operationId":"checkPhoneNumberAvailability","summary":"Check country availability","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":2,"maxLength":2},"in":"query","name":"country","required":true,"description":"ISO 3166-1 alpha-2 country"},{"schema":{"type":"string","enum":["local","mobile","national","toll_free"]},"in":"query","name":"number_type","required":false},{"schema":{"type":"boolean"},"in":"query","name":"sms","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"check-phone-number-availability","x-zernio":["GET /v1/phone-numbers/availability"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_availability"]},"country":{"type":"string"},"number_type":{"type":"string"},"available":{"type":"boolean"},"pre_orderable":{"type":"boolean"},"address_constraint":{"type":"string"},"areas":{"type":"array","items":{"type":"string"}},"area_options":{"type":"array","items":{"type":"object","properties":{"ndc":{"type":["null","string"]},"name":{"type":["null","string"]},"count":{"type":"integer"}}}},"sold_out_areas":{"type":"array","items":{"type":"object","properties":{"ndc":{"type":["null","string"]},"name":{"type":["null","string"]},"pre_orderable":{"type":"boolean"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/claims/{claimId}":{"get":{"operationId":"getPhoneNumberClaim","summary":"Resolve a number claim","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"claimId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-phone-number-claim","x-zernio":["GET /v1/phone-numbers/claims/{claimId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_claim"]},"id":{"type":"string"},"country":{"type":"object","properties":{"code":{"type":"string"},"needs_kyc":{"type":"boolean"},"monthly_cents":{"type":"integer"}}},"number_type":{"type":"string"},"area":{"type":["null","object"],"properties":{"ndc":{"type":["null","string"]},"name":{"type":["null","string"]},"count":{"type":"integer"}}},"phone_number":{"type":["null","string"]},"expires_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/kyc":{"get":{"operationId":"getPhoneNumberKycSpec","summary":"Get the KYC form spec","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":2,"maxLength":2},"in":"query","name":"country","required":true,"description":"ISO 3166-1 alpha-2 country"},{"schema":{"type":"string","enum":["local","mobile","national","toll_free"]},"in":"query","name":"number_type","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-phone-number-kyc-spec","x-feature":"telephony","x-zernio":["GET /v1/phone-numbers/kyc"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_kyc_spec"]},"country":{"type":"string"},"number_type":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"requirement_id":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string"},"description":{"type":["null","string"]},"example":{"type":["null","string"]},"local_to":{"type":["null","string"]},"acceptance_criteria":{"type":["null","object"],"additionalProperties":true}}}},"reusable":{"type":"object","properties":{"available":{"type":"boolean"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"from_phone_number":{"type":["null","string"]},"instant":{"type":"boolean"},"details":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":["null","string"]}}}}}}}}},"pending_review":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"submitPhoneNumberKyc","summary":"Submit KYC","tags":["Telephony"],"description":"Files the regulatory packet; the numbers are ordered once approved (phone_number.* events).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"profile_id":{"type":"string","maxLength":80,"minLength":1},"country":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"number_type":{"type":"string","enum":["local","mobile","national","toll_free"]},"submission_id":{"type":"string","maxLength":100,"minLength":1},"quantity":{"type":"integer","minimum":1,"maximum":5},"area_code":{"type":"string","maxLength":10},"pre_order":{"type":"boolean"},"reuse":{"type":"boolean"},"reuse_option_id":{"type":"string","maxLength":80},"end_user_first_name":{"type":"string","maxLength":120},"end_user_last_name":{"type":"string","maxLength":120},"values":{"type":"object","additionalProperties":{"type":["string","number","boolean"]},"maxProperties":50},"documents":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["requirement_id"],"properties":{"requirement_id":{"type":"string","maxLength":120,"minLength":1},"document_id":{"type":"string","maxLength":120},"issued_at":{"type":"string","format":"date"},"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"},"mime_type":{"type":"string","maxLength":100}}}},"address":{"type":"object","additionalProperties":false,"properties":{"requirement_id":{"type":"string","maxLength":120},"country_code":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"business_name":{"type":"string","maxLength":255},"first_name":{"type":"string","maxLength":120},"last_name":{"type":"string","maxLength":120},"street_address":{"type":"string","maxLength":255},"extended_address":{"type":"string","maxLength":255},"locality":{"type":"string","maxLength":120},"administrative_area":{"type":"string","maxLength":120},"postal_code":{"type":"string","maxLength":32}}}},"required":["profile_id","country"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"submit-phone-number-kyc","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/kyc"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["kyc_submission"]},"id":{"type":"string"},"status":{"type":"string"},"submission_id":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"pre_order":{"type":"boolean"},"phone_numbers":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["kyc_submission"]},"id":{"type":"string"},"status":{"type":"string"},"submission_id":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"pre_order":{"type":"boolean"},"phone_numbers":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/phone-numbers/kyc/documents":{"post":{"operationId":"uploadPhoneNumberKycDocument","summary":"Upload a KYC document","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"},"mime_type":{"type":"string","maxLength":100}},"required":["filename","content_base64"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"upload-phone-number-kyc-document","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/kyc/upload-document"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["telephony_document"]},"id":{"type":"string"},"provider_document_id":{"type":["null","string"]},"kind":{"type":"string"},"filename":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"status":{"type":["null","string"]},"url":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/phone-numbers/kyc/documents/{documentId}":{"get":{"operationId":"getPhoneNumberKycDocument","summary":"View a KYC document on file","tags":["Telephony"],"description":"Metadata with a short-lived download URL; download=true streams the file.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"download","required":false},{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"documentId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"read","x-toolset":"telephony","x-mcp-tool":null,"x-feature":"telephony","x-zernio":["GET /v1/phone-numbers/kyc/document/{documentId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["telephony_document"]},"id":{"type":"string"},"provider_document_id":{"type":["null","string"]},"kind":{"type":"string"},"filename":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"status":{"type":["null","string"]},"url":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/kyc/validate-address":{"post":{"operationId":"validatePhoneNumberKycAddress","summary":"Pre-validate a KYC address","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"street_address":{"type":"string","maxLength":255,"minLength":1},"extended_address":{"type":"string","maxLength":255},"locality":{"type":"string","maxLength":120,"minLength":1},"administrative_area":{"type":"string","maxLength":120},"postal_code":{"type":"string","maxLength":32,"minLength":1}},"required":["country","street_address","locality","postal_code"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"validate-phone-number-kyc-address","x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/kyc/validate-address"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_address_validation"]},"ok":{"type":"boolean"},"skipped":{"type":"boolean"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":["null","string"]},"message":{"type":"string"}}}},"suggested":{"type":["null","object"],"additionalProperties":true}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/kyc/review-packet":{"post":{"operationId":"reviewPhoneNumberKycPacket","summary":"Pre-review a KYC packet","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"number_type":{"type":"string","enum":["local","mobile","national","toll_free"]},"values":{"type":"object","additionalProperties":{"type":["string","number","boolean"]},"maxProperties":50},"address":{"type":"object","additionalProperties":false,"properties":{"requirement_id":{"type":"string","maxLength":120},"country_code":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"business_name":{"type":"string","maxLength":255},"first_name":{"type":"string","maxLength":120},"last_name":{"type":"string","maxLength":120},"street_address":{"type":"string","maxLength":255},"extended_address":{"type":"string","maxLength":255},"locality":{"type":"string","maxLength":120},"administrative_area":{"type":"string","maxLength":120},"postal_code":{"type":"string","maxLength":32}}},"documents":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["requirement_id"],"properties":{"requirement_id":{"type":"string","maxLength":120,"minLength":1},"document_id":{"type":"string","maxLength":120},"issued_at":{"type":"string","format":"date"},"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"},"mime_type":{"type":"string","maxLength":100}}}}},"required":["country","number_type","documents"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"review-phone-number-kyc-packet","x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/kyc/review-packet"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_kyc_review"]},"country":{"type":"string"},"number_type":{"type":"string"},"advisories":{"type":"array","items":{"type":"object","properties":{"requirement_id":{"type":["null","string"]},"concern":{"type":"string"},"severity":{"type":"string"}}}},"verdict":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/kyc/share":{"post":{"operationId":"createPhoneNumberKycLink","summary":"Create a hosted KYC link","tags":["Telephony"],"description":"Single-use 7-day link an end customer completes without a Socialit login (public GET / POST /phone-numbers/kyc/links/:token).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"profile_id":{"type":"string","maxLength":80,"minLength":1},"country":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"number_type":{"type":"string","enum":["local","mobile","national","toll_free"]},"area_code":{"type":"string","maxLength":10},"language":{"type":"string","enum":["en","es","pt-BR"]},"branding":{"type":"object","additionalProperties":false,"properties":{"company_name":{"type":"string","maxLength":120},"logo_url":{"type":"string","format":"uri","maxLength":2048},"brand_color":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"}}},"redirect_url":{"type":"string","format":"uri","maxLength":2048}},"required":["profile_id","country"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-phone-number-kyc-link","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/kyc/share"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_kyc_link"]},"id":{"type":"string"},"url":{"type":["null","string"]},"token":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"country":{"type":"string"},"language":{"type":"string"},"expires_at":{"type":["null","string"],"format":"date-time"},"used_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/phone-numbers/{id}":{"get":{"operationId":"getPhoneNumber","summary":"Get a phone number","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-phone-number","x-zernio":["GET /v1/phone-numbers/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updatePhoneNumber","summary":"Move or rename a phone number","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"profile_id":{"type":"string","maxLength":80,"minLength":1},"label":{"type":["string","null"],"maxLength":100}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"telephony","x-mcp-tool":"update-phone-number","x-feature":"telephony","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"releasePhoneNumber","summary":"Release a phone number","tags":["Telephony"],"description":"Terminal: the number goes back to the carrier and its SMS account is disconnected.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"destructive","x-toolset":"telephony","x-mcp-tool":"release-phone-number","x-feature":"telephony","x-zernio":["DELETE /v1/phone-numbers/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/{id}/remediate":{"get":{"operationId":"getPhoneNumberRemediation","summary":"Get declined requirements","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-phone-number-remediation","x-feature":"telephony","x-zernio":["GET /v1/phone-numbers/{id}/remediate"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_remediation"]},"phone_number_id":{"type":"string"},"country":{"type":"string"},"number_type":{"type":"string"},"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"fields":{"type":"array","items":{"type":"object","properties":{"requirement_id":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string"},"description":{"type":["null","string"]},"example":{"type":["null","string"]},"status":{"type":["null","string"]},"decline_reason":{"type":["null","string"]}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"remediatePhoneNumber","summary":"Resubmit a declined number","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"values":{"type":"object","additionalProperties":{"type":["string","number","boolean"]},"maxProperties":50},"documents":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["requirement_id"],"properties":{"requirement_id":{"type":"string","maxLength":120,"minLength":1},"document_id":{"type":"string","maxLength":120},"issued_at":{"type":"string","format":"date"},"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"},"mime_type":{"type":"string","maxLength":100}}}},"address":{"type":"object","additionalProperties":false,"properties":{"requirement_id":{"type":"string","maxLength":120},"country_code":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"business_name":{"type":"string","maxLength":255},"first_name":{"type":"string","maxLength":120},"last_name":{"type":"string","maxLength":120},"street_address":{"type":"string","maxLength":255},"extended_address":{"type":"string","maxLength":255},"locality":{"type":"string","maxLength":120},"administrative_area":{"type":"string","maxLength":120},"postal_code":{"type":"string","maxLength":32}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"remediate-phone-number","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/{id}/remediate"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/{id}/remediate/reply":{"post":{"operationId":"replyPhoneNumberReviewer","summary":"Reply to the regulatory reviewer","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"text":{"type":"string","maxLength":5000},"attachments":{"type":"array","maxItems":5,"items":{"type":"object","additionalProperties":false,"required":["filename","content_base64"],"properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"reply-phone-number-reviewer","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/{id}/remediate/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_remediation_reply"]},"phone_number_id":{"type":"string"},"posted":{"type":"boolean"},"attachments":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/{id}/remediate/respond":{"post":{"operationId":"respondPhoneNumberReviewer","summary":"Respond to the regulatory reviewer (message + corrections)","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"message":{"type":"string","maxLength":5000},"documents":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["requirement_id"],"properties":{"requirement_id":{"type":"string","maxLength":120,"minLength":1},"document_id":{"type":"string","maxLength":120},"issued_at":{"type":"string","format":"date"},"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"},"mime_type":{"type":"string","maxLength":100}}}},"address":{"type":"object","additionalProperties":false,"properties":{"requirement_id":{"type":"string","maxLength":120},"country_code":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"business_name":{"type":"string","maxLength":255},"first_name":{"type":"string","maxLength":120},"last_name":{"type":"string","maxLength":120},"street_address":{"type":"string","maxLength":255},"extended_address":{"type":"string","maxLength":255},"locality":{"type":"string","maxLength":120},"administrative_area":{"type":"string","maxLength":120},"postal_code":{"type":"string","maxLength":32}}},"entity_type":{"type":"string","enum":["individual","business"]},"attachments":{"type":"array","maxItems":5,"items":{"type":"object","additionalProperties":false,"required":["filename","content_base64"],"properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"respond-phone-number-reviewer","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/{id}/remediate/respond"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_remediation_response"]},"phone_number_id":{"type":"string"},"status":{"type":"string"},"posted":{"type":"boolean"},"siblings_resubmitted":{"type":"integer"},"phone_number":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/stock-watches":{"post":{"operationId":"createPhoneNumberStockWatch","summary":"Watch an out-of-stock country","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"number_type":{"type":"string","enum":["local","mobile","national","toll_free"]},"area_code":{"type":"string","maxLength":10}},"required":["country"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-phone-number-stock-watch","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/stock-watches"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["stock_watch"]},"id":{"type":"string"},"country":{"type":"string"},"country_name":{"type":"string"},"number_type":{"type":["null","string"]},"area_code":{"type":["null","string"]},"pre_orderable":{"type":"boolean"},"notified_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["stock_watch"]},"id":{"type":"string"},"country":{"type":"string"},"country_name":{"type":"string"},"number_type":{"type":["null","string"]},"area_code":{"type":["null","string"]},"pre_orderable":{"type":"boolean"},"notified_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listPhoneNumberStockWatches","summary":"List stock watches","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-phone-number-stock-watches","x-feature":"telephony","x-zernio":["GET /v1/phone-numbers/stock-watches"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["stock_watch"]},"id":{"type":"string"},"country":{"type":"string"},"country_name":{"type":"string"},"number_type":{"type":["null","string"]},"area_code":{"type":["null","string"]},"pre_orderable":{"type":"boolean"},"notified_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/stock-watches/{id}":{"delete":{"operationId":"deletePhoneNumberStockWatch","summary":"Stop watching a country","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"delete-phone-number-stock-watch","x-feature":"telephony","x-zernio":["DELETE /v1/phone-numbers/stock-watches/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["stock_watch"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/port-ins/check":{"post":{"operationId":"checkPortability","summary":"Check portability","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phone_numbers":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"}},"claim_links":{"type":"boolean"}},"required":["phone_numbers"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"check-portability","x-feature":"telephony","x-rate-limit":{"max":30,"timeWindow":"1 minute"},"x-zernio":["POST /v1/phone-numbers/port-in/check"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["portability_check"]},"results":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["portability_result"]},"phone_number":{"type":"string"},"portable":{"type":"boolean"},"fast_portable":{"type":"boolean"},"messaging_capable":{"type":["null","boolean"]},"line_type":{"type":["null","string"]},"carrier_name":{"type":["null","string"]},"country_code":{"type":["null","string"]},"not_portable_reason":{"type":["null","string"]},"claim_id":{"type":["null","string"]},"claim_url":{"type":["null","string"]}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/port-ins/requirements":{"get":{"operationId":"getPortingRequirements","summary":"Country porting requirements","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":2,"maxLength":2},"in":"query","name":"country","required":true,"description":"ISO 3166-1 alpha-2 country"},{"schema":{"type":"string","enum":["local","mobile","national","toll_free"]},"in":"query","name":"number_type","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-porting-requirements","x-feature":"telephony","x-zernio":["GET /v1/phone-numbers/port-in/requirements"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["porting_requirements"]},"country":{"type":"string"},"number_type":{"type":"string"},"supported":{"type":"boolean"},"fields":{"type":"array","items":{"type":"object","properties":{"requirement_id":{"type":["null","string"]},"label":{"type":"string"},"kind":{"type":"string"},"description":{"type":["null","string"]},"example":{"type":["null","string"]},"acceptable_values":{"type":"array","items":{"type":"string"}}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/port-ins/documents":{"post":{"operationId":"uploadPortingDocument","summary":"Upload a porting document","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"},"kind":{"type":"string","enum":["loa","invoice","other"]},"mime_type":{"type":"string","maxLength":100}},"required":["filename","content_base64"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"upload-porting-document","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/port-in/documents"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["telephony_document"]},"id":{"type":"string"},"provider_document_id":{"type":["null","string"]},"kind":{"type":"string"},"filename":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"status":{"type":["null","string"]},"url":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/phone-numbers/port-ins/claims/{claimId}":{"get":{"operationId":"getPortClaim","summary":"Resolve a port claim","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"claimId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-port-claim","x-feature":"telephony","x-zernio":["GET /v1/phone-numbers/port-in/claims/{claimId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["port_in_claim"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"country":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/port-ins":{"post":{"operationId":"createPortIn","summary":"Port numbers in","tags":["Telephony"],"description":"Creates (and submits) one porting order per losing carrier; the numbers appear as `porting` phone numbers.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"profile_id":{"type":"string","maxLength":80,"minLength":1},"phone_numbers":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"}},"end_user":{"type":"object","additionalProperties":false,"required":["entity_name","auth_person_name","account_number","street_address","locality","postal_code","country_code"],"properties":{"entity_name":{"type":"string","maxLength":255,"minLength":1},"auth_person_name":{"type":"string","maxLength":255,"minLength":1},"billing_phone_number":{"type":"string","maxLength":32},"account_number":{"type":"string","maxLength":64,"minLength":1},"pin_passcode":{"type":"string","maxLength":32},"tax_identifier":{"type":"string","maxLength":64},"business_identifier":{"type":"string","maxLength":64},"street_address":{"type":"string","maxLength":255,"minLength":1},"extended_address":{"type":"string","maxLength":255},"locality":{"type":"string","maxLength":120,"minLength":1},"administrative_area":{"type":"string","maxLength":120},"postal_code":{"type":"string","maxLength":32,"minLength":1},"country_code":{"type":"string","enum":["US","CA","GB","ES","DE","FR","NL","AU","BR"]}}},"loa_document_id":{"type":"string","maxLength":80,"minLength":1},"invoice_document_id":{"type":"string","maxLength":80,"minLength":1},"foc_datetime_requested":{"type":"string","format":"date-time"},"customer_reference":{"type":"string","maxLength":120},"port_type":{"type":"string","enum":["full","partial"]},"requirements":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["requirement_type_id","field_value"],"properties":{"requirement_type_id":{"type":"string","maxLength":120,"minLength":1},"field_value":{"type":"string","maxLength":1000,"minLength":1}}}}},"required":["profile_id","phone_numbers","end_user","loa_document_id","invoice_document_id"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-port-in","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/port-in"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["port_in_order"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"status":{"type":"string"},"provider_status":{"type":["null","string"]},"provider_order_id":{"type":["null","string"]},"phone_numbers":{"type":"array","items":{"type":"string"}},"country":{"type":["null","string"]},"port_type":{"type":"string"},"fast_port_eligible":{"type":["null","boolean"]},"foc_datetime_requested":{"type":["null","string"],"format":"date-time"},"foc_datetime_actual":{"type":["null","string"],"format":"date-time"},"decline_reason":{"type":["null","string"]},"customer_reference":{"type":["null","string"]},"end_user":{"type":"object","properties":{"entity_name":{"type":["null","string"]},"auth_person_name":{"type":["null","string"]},"account_number_last4":{"type":["null","string"]},"street_address":{"type":["null","string"]},"locality":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country_code":{"type":["null","string"]}}},"loa_document_id":{"type":["null","string"]},"invoice_document_id":{"type":["null","string"]},"phone_number_ids":{"type":"array","items":{"type":"string"}},"submitted_at":{"type":["null","string"],"format":"date-time"},"ported_at":{"type":["null","string"],"format":"date-time"},"cancelled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"orders":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["port_in_order"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"status":{"type":"string"},"provider_status":{"type":["null","string"]},"provider_order_id":{"type":["null","string"]},"phone_numbers":{"type":"array","items":{"type":"string"}},"country":{"type":["null","string"]},"port_type":{"type":"string"},"fast_port_eligible":{"type":["null","boolean"]},"foc_datetime_requested":{"type":["null","string"],"format":"date-time"},"foc_datetime_actual":{"type":["null","string"],"format":"date-time"},"decline_reason":{"type":["null","string"]},"customer_reference":{"type":["null","string"]},"end_user":{"type":"object","properties":{"entity_name":{"type":["null","string"]},"auth_person_name":{"type":["null","string"]},"account_number_last4":{"type":["null","string"]},"street_address":{"type":["null","string"]},"locality":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country_code":{"type":["null","string"]}}},"loa_document_id":{"type":["null","string"]},"invoice_document_id":{"type":["null","string"]},"phone_number_ids":{"type":"array","items":{"type":"string"}},"submitted_at":{"type":["null","string"],"format":"date-time"},"ported_at":{"type":["null","string"],"format":"date-time"},"cancelled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listPortIns","summary":"List port-in orders","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","enum":["draft","pending","foc_confirmed","ported","exception","cancelled"]},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-port-ins","x-feature":"telephony","x-zernio":["GET /v1/phone-numbers/port-in"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["port_in_order"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"status":{"type":"string"},"provider_status":{"type":["null","string"]},"provider_order_id":{"type":["null","string"]},"phone_numbers":{"type":"array","items":{"type":"string"}},"country":{"type":["null","string"]},"port_type":{"type":"string"},"fast_port_eligible":{"type":["null","boolean"]},"foc_datetime_requested":{"type":["null","string"],"format":"date-time"},"foc_datetime_actual":{"type":["null","string"],"format":"date-time"},"decline_reason":{"type":["null","string"]},"customer_reference":{"type":["null","string"]},"end_user":{"type":"object","properties":{"entity_name":{"type":["null","string"]},"auth_person_name":{"type":["null","string"]},"account_number_last4":{"type":["null","string"]},"street_address":{"type":["null","string"]},"locality":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country_code":{"type":["null","string"]}}},"loa_document_id":{"type":["null","string"]},"invoice_document_id":{"type":["null","string"]},"phone_number_ids":{"type":"array","items":{"type":"string"}},"submitted_at":{"type":["null","string"],"format":"date-time"},"ported_at":{"type":["null","string"],"format":"date-time"},"cancelled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/port-ins/{id}":{"get":{"operationId":"getPortIn","summary":"Get a port-in order","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-port-in","x-feature":"telephony","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["port_in_order"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"status":{"type":"string"},"provider_status":{"type":["null","string"]},"provider_order_id":{"type":["null","string"]},"phone_numbers":{"type":"array","items":{"type":"string"}},"country":{"type":["null","string"]},"port_type":{"type":"string"},"fast_port_eligible":{"type":["null","boolean"]},"foc_datetime_requested":{"type":["null","string"],"format":"date-time"},"foc_datetime_actual":{"type":["null","string"],"format":"date-time"},"decline_reason":{"type":["null","string"]},"customer_reference":{"type":["null","string"]},"end_user":{"type":"object","properties":{"entity_name":{"type":["null","string"]},"auth_person_name":{"type":["null","string"]},"account_number_last4":{"type":["null","string"]},"street_address":{"type":["null","string"]},"locality":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country_code":{"type":["null","string"]}}},"loa_document_id":{"type":["null","string"]},"invoice_document_id":{"type":["null","string"]},"phone_number_ids":{"type":"array","items":{"type":"string"}},"submitted_at":{"type":["null","string"],"format":"date-time"},"ported_at":{"type":["null","string"],"format":"date-time"},"cancelled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"cancelPortIn","summary":"Cancel a port-in","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"destructive","x-toolset":"telephony","x-mcp-tool":"cancel-port-in","x-feature":"telephony","x-zernio":["DELETE /v1/phone-numbers/port-in/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["port_in_order"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"status":{"type":"string"},"provider_status":{"type":["null","string"]},"provider_order_id":{"type":["null","string"]},"phone_numbers":{"type":"array","items":{"type":"string"}},"country":{"type":["null","string"]},"port_type":{"type":"string"},"fast_port_eligible":{"type":["null","boolean"]},"foc_datetime_requested":{"type":["null","string"],"format":"date-time"},"foc_datetime_actual":{"type":["null","string"],"format":"date-time"},"decline_reason":{"type":["null","string"]},"customer_reference":{"type":["null","string"]},"end_user":{"type":"object","properties":{"entity_name":{"type":["null","string"]},"auth_person_name":{"type":["null","string"]},"account_number_last4":{"type":["null","string"]},"street_address":{"type":["null","string"]},"locality":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country_code":{"type":["null","string"]}}},"loa_document_id":{"type":["null","string"]},"invoice_document_id":{"type":["null","string"]},"phone_number_ids":{"type":"array","items":{"type":"string"}},"submitted_at":{"type":["null","string"],"format":"date-time"},"ported_at":{"type":["null","string"],"format":"date-time"},"cancelled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/port-ins/{id}/requirements":{"get":{"operationId":"getPortInRequirements","summary":"A port-in order's pending requirements","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-port-in-requirements","x-feature":"telephony","x-zernio":["GET /v1/phone-numbers/port-in/{id}/requirements"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["port_in_requirements"]},"port_in_id":{"type":"string"},"country":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","properties":{"requirement_id":{"type":["null","string"]},"label":{"type":"string"},"kind":{"type":"string"},"description":{"type":["null","string"]},"example":{"type":["null","string"]},"acceptable_values":{"type":"array","items":{"type":"string"}},"status":{"type":["null","string"]},"filled":{"type":"boolean"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/messages":{"post":{"operationId":"sendSms","summary":"Send an SMS / MMS","tags":["Telephony"],"description":"From a number with SMS enabled or an alphanumeric sender ID. 409 recipient_opted_out after STOP. send_at schedules 5 min – 5 days ahead.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"from":{"type":"string","maxLength":80,"minLength":1},"to":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"},"text":{"type":"string","maxLength":1600},"media_urls":{"type":"array","maxItems":10,"items":{"type":"string","format":"uri","maxLength":2048}},"send_at":{"type":"string","format":"date-time"},"profile_id":{"type":"string","maxLength":80}},"required":["from","to"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"telephony","x-mcp-tool":"send-sms","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/messages"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_message"]},"id":{"type":"string"},"direction":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"sender_id":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"message_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"text":{"type":["null","string"]},"media_urls":{"type":"array","items":{"type":"string"}},"segments":{"type":"integer"},"encoding":{"type":["null","string"]},"provider_message_id":{"type":["null","string"]},"carrier":{"type":["null","string"]},"line_type":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"detail":{"type":["null","string"]}}}},"cost_usd":{"type":["null","number"]},"sent_via":{"type":["null","string"]},"send_at":{"type":["null","string"],"format":"date-time"},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"failed_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listSmsMessages","summary":"List SMS / MMS","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","enum":["inbound","outbound"]},"in":"query","name":"direction","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"phone_number_id","required":false},{"schema":{"type":"string"},"in":"query","name":"from","required":false},{"schema":{"type":"string"},"in":"query","name":"to","required":false},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-sms-messages","x-feature":"telephony","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["sms_message"]},"id":{"type":"string"},"direction":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"sender_id":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"message_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"text":{"type":["null","string"]},"media_urls":{"type":"array","items":{"type":"string"}},"segments":{"type":"integer"},"encoding":{"type":["null","string"]},"provider_message_id":{"type":["null","string"]},"carrier":{"type":["null","string"]},"line_type":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"detail":{"type":["null","string"]}}}},"cost_usd":{"type":["null","number"]},"sent_via":{"type":["null","string"]},"send_at":{"type":["null","string"],"format":"date-time"},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"failed_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/messages/{id}":{"get":{"operationId":"getSmsMessage","summary":"Get an SMS","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-sms-message","x-feature":"telephony","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_message"]},"id":{"type":"string"},"direction":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"sender_id":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"message_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"text":{"type":["null","string"]},"media_urls":{"type":"array","items":{"type":"string"}},"segments":{"type":"integer"},"encoding":{"type":["null","string"]},"provider_message_id":{"type":["null","string"]},"carrier":{"type":["null","string"]},"line_type":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"detail":{"type":["null","string"]}}}},"cost_usd":{"type":["null","number"]},"sent_via":{"type":["null","string"]},"send_at":{"type":["null","string"],"format":"date-time"},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"failed_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/messages/{id}/cancel":{"post":{"operationId":"cancelSmsMessage","summary":"Cancel a scheduled SMS","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"cancel-sms-message","x-idempotent":true,"x-feature":"telephony","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_message"]},"id":{"type":"string"},"direction":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"sender_id":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"message_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"text":{"type":["null","string"]},"media_urls":{"type":"array","items":{"type":"string"}},"segments":{"type":"integer"},"encoding":{"type":["null","string"]},"provider_message_id":{"type":["null","string"]},"carrier":{"type":["null","string"]},"line_type":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string"]},"title":{"type":["null","string"]},"detail":{"type":["null","string"]}}}},"cost_usd":{"type":["null","number"]},"sent_via":{"type":["null","string"]},"send_at":{"type":["null","string"],"format":"date-time"},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"failed_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/lookup":{"get":{"operationId":"lookupPhoneNumber","summary":"Look up carrier + line type","tags":["Telephony"],"description":"Billed per lookup.","parameters":[{"schema":{"type":"string","maxLength":32,"minLength":3},"in":"query","name":"number","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"lookup-phone-number","x-rate-limit":{"max":60,"timeWindow":"1 minute"},"x-zernio":["GET /v1/sms/lookup"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["number_lookup"]},"phone_number":{"type":"string"},"country":{"type":["null","string"]},"carrier_name":{"type":["null","string"]},"line_type":{"type":"string"},"sms_reachable":{"type":"boolean"},"mobile_country_code":{"type":["null","string"]},"mobile_network_code":{"type":["null","string"]},"cost_usd":{"type":"number"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/opt-outs":{"get":{"operationId":"listSmsOptOuts","summary":"List SMS opt-outs","tags":["Telephony"],"description":"format=csv returns every row as text/csv.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","enum":["json","csv"]},"in":"query","name":"format","required":false},{"schema":{"type":"string"},"in":"query","name":"phone_number","required":false},{"schema":{"type":"string"},"in":"query","name":"from","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-sms-opt-outs","x-feature":"telephony","x-zernio":["GET /v1/sms/opt-outs"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["sms_opt_out"]},"id":{"type":"string"},"phone_number":{"type":"string"},"from":{"type":["null","string"]},"keyword":{"type":["null","string"]},"source":{"type":"string"},"opted_out_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createSmsOptOut","summary":"Add a number to the opt-out list","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phone_number":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"},"from":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"}},"required":["phone_number"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-sms-opt-out","x-idempotent":true,"x-feature":"telephony","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_opt_out"]},"id":{"type":"string"},"phone_number":{"type":"string"},"from":{"type":["null","string"]},"keyword":{"type":["null","string"]},"source":{"type":"string"},"opted_out_at":{"type":["null","string"],"format":"date-time"}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_opt_out"]},"id":{"type":"string"},"phone_number":{"type":"string"},"from":{"type":["null","string"]},"keyword":{"type":["null","string"]},"source":{"type":"string"},"opted_out_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/sms/opt-outs/{phoneNumber}":{"delete":{"operationId":"deleteSmsOptOut","summary":"Remove an opt-out","tags":["Telephony"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"from","required":false},{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"phoneNumber","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"delete-sms-opt-out","x-feature":"telephony","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_opt_out"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/sender-ids":{"post":{"operationId":"createSenderId","summary":"Create an alphanumeric sender ID","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"sender_id":{"type":"string","maxLength":11,"minLength":3},"profile_id":{"type":"string","maxLength":80}},"required":["sender_id"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-sender-id","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/sender-ids"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sender_id"]},"id":{"type":"string"},"sender_id":{"type":"string"},"profile_id":{"type":["null","string"]},"status":{"type":"string"},"is_active":{"type":"boolean"},"rejection_reason":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listSenderIds","summary":"List alphanumeric sender IDs","tags":["Telephony"],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-sender-ids","x-feature":"telephony","x-zernio":["GET /v1/sms/sender-ids"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["sender_id"]},"id":{"type":"string"},"sender_id":{"type":"string"},"profile_id":{"type":["null","string"]},"status":{"type":"string"},"is_active":{"type":"boolean"},"rejection_reason":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]},"budget":{"type":"object","properties":{"object":{"type":"string","enum":["sender_id_budget"]},"cap":{"type":"integer"},"used_today":{"type":"integer"},"level":{"type":"integer"},"pending_request":{"type":["null","object"],"properties":{"requested_cap":{"type":"integer"},"level":{"type":"integer"},"requested_at":{"type":["null","string"],"format":"date-time"}}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/sender-ids/limit-request":{"post":{"operationId":"requestSenderIdLimit","summary":"Request a higher sender ID daily limit","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"requested_cap":{"type":"integer","minimum":500,"maximum":25000},"reason":{"type":"string","maxLength":1000,"minLength":1}},"required":["requested_cap","reason"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"request-sender-id-limit","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/sender-ids/limit-request"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sender_id_limit_request"]},"requested":{"type":"boolean"},"requested_cap":{"type":"integer"},"level":{"type":"integer"},"requested_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/sms/sender-ids/{id}":{"delete":{"operationId":"deleteSenderId","summary":"Delete an alphanumeric sender ID","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"delete-sender-id","x-feature":"telephony","x-zernio":["DELETE /v1/sms/sender-ids/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sender_id"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/{id}/sms":{"post":{"operationId":"enablePhoneNumberSms","summary":"Enable SMS on a number","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"enable-phone-number-sms","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/{id}/sms"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["number_sms_status"]},"phone_number_id":{"type":"string"},"phone_number":{"type":["null","string"]},"enabled":{"type":"boolean"},"account_id":{"type":["null","string"]},"country":{"type":"string"},"sms_capable":{"type":"boolean"},"mms_capable":{"type":"boolean"},"domestic_only":{"type":"boolean"},"not_ready":{"type":"boolean"},"needs_registration":{"type":"boolean"},"already_registered":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"reusable_registration":{"type":["null","object"],"properties":{"id":{"type":"string"},"status":{"type":"string"}}},"message":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"disablePhoneNumberSms","summary":"Disable SMS on a number","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"disable-phone-number-sms","x-feature":"telephony","x-zernio":["DELETE /v1/phone-numbers/{id}/sms"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["number_sms_status"]},"phone_number_id":{"type":"string"},"phone_number":{"type":["null","string"]},"enabled":{"type":"boolean"},"account_id":{"type":["null","string"]},"country":{"type":"string"},"sms_capable":{"type":"boolean"},"mms_capable":{"type":"boolean"},"domestic_only":{"type":"boolean"},"not_ready":{"type":"boolean"},"needs_registration":{"type":"boolean"},"already_registered":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"reusable_registration":{"type":["null","object"],"properties":{"id":{"type":"string"},"status":{"type":"string"}}},"message":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/{id}/sms/reuse-registration":{"post":{"operationId":"reusePhoneNumberSmsRegistration","summary":"Add a number to an approved SMS registration","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"registration_id":{"type":"string","maxLength":80}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"reuse-phone-number-sms-registration","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/{id}/sms/reuse-registration"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["number_sms_status"]},"phone_number_id":{"type":"string"},"phone_number":{"type":["null","string"]},"enabled":{"type":"boolean"},"account_id":{"type":["null","string"]},"country":{"type":"string"},"sms_capable":{"type":"boolean"},"mms_capable":{"type":"boolean"},"domestic_only":{"type":"boolean"},"not_ready":{"type":"boolean"},"needs_registration":{"type":"boolean"},"already_registered":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"reusable_registration":{"type":["null","object"],"properties":{"id":{"type":"string"},"status":{"type":"string"}}},"message":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/registrations/preflight":{"post":{"operationId":"preflightSmsRegistration","summary":"Pre-check a carrier registration","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"registration_type":{"type":"string","enum":["standard_10dlc","sole_prop_10dlc"]},"phone_numbers":{"type":"array","items":{"type":"string"}},"brand":{"type":"object","additionalProperties":false,"required":["entity_type","display_name","street","city","state","postal_code","country","website","vertical"],"properties":{"entity_type":{"type":"string","enum":["PRIVATE_PROFIT","PUBLIC_PROFIT","NON_PROFIT","GOVERNMENT","SOLE_PROPRIETOR"]},"display_name":{"type":"string","maxLength":255,"minLength":1},"company_name":{"type":"string","maxLength":255},"ein":{"type":"string","maxLength":32},"phone":{"type":"string","maxLength":32},"mobile_phone":{"type":"string","maxLength":32},"street":{"type":"string","maxLength":255,"minLength":1},"city":{"type":"string","maxLength":120,"minLength":1},"state":{"type":"string","maxLength":64,"minLength":1},"postal_code":{"type":"string","maxLength":32,"minLength":1},"country":{"type":"string","maxLength":2,"minLength":2},"email":{"type":"string","format":"email","maxLength":254},"website":{"type":"string","maxLength":255,"minLength":1},"vertical":{"type":"string","enum":["AGRICULTURE","COMMUNICATION","CONSTRUCTION","EDUCATION","ENERGY","ENTERTAINMENT","FINANCIAL","GAMBLING","GOVERNMENT","HEALTHCARE","HOSPITALITY","HUMAN_RESOURCES","INSURANCE","LEGAL","MANUFACTURING","NGO","POLITICAL","POSTAL","PROFESSIONAL","REAL_ESTATE","RETAIL","TECHNOLOGY","TRANSPORTATION"]},"stock_symbol":{"type":"string","maxLength":16},"first_name":{"type":"string","maxLength":120},"last_name":{"type":"string","maxLength":120}}},"campaign":{"type":"object","additionalProperties":false,"required":["usecase","description","message_flow","sample1","sample2","optin_keywords","optout_keywords","help_keywords"],"properties":{"usecase":{"type":"string","maxLength":64,"minLength":1},"sub_usecases":{"type":"array","maxItems":5,"items":{"type":"string","maxLength":64,"minLength":1}},"description":{"type":"string","maxLength":4096,"minLength":1},"message_flow":{"type":"string","maxLength":4096,"minLength":1},"sample1":{"type":"string","maxLength":1024,"minLength":1},"sample2":{"type":"string","maxLength":1024,"minLength":1},"help_message":{"type":"string","maxLength":320},"optin_keywords":{"type":"string","maxLength":255,"minLength":1},"optin_message":{"type":"string","maxLength":320},"optout_keywords":{"type":"string","maxLength":255,"minLength":1},"optout_message":{"type":"string","maxLength":320},"help_keywords":{"type":"string","maxLength":255,"minLength":1},"embedded_link":{"type":"boolean"},"embedded_phone":{"type":"boolean"},"number_pool":{"type":"boolean"},"age_gated":{"type":"boolean"},"direct_lending":{"type":"boolean"},"privacy_policy_link":{"type":"string","maxLength":2048},"terms_and_conditions_link":{"type":"string","maxLength":2048}}},"messaging_brand_name":{"type":"string","maxLength":64}},"required":["registration_type","brand","campaign"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"preflight-sms-registration","x-feature":"telephony","x-zernio":["POST /v1/sms/registrations/preflight"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_registration_preflight"]},"verdict":{"type":"string"},"composed":{"type":"object","properties":{"brand":{"type":"object","additionalProperties":true},"campaign":{"type":"object","additionalProperties":true}}},"advisories":{"type":"array","items":{"type":"object","properties":{"field":{"type":["null","string"]},"code":{"type":["null","string"]},"concern":{"type":"string"},"severity":{"type":"string"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/registrations":{"post":{"operationId":"createSmsRegistration","summary":"Start a carrier registration","tags":["Telephony"],"description":"10DLC brand + campaign, sole-proprietor 10DLC (OTP step) or toll-free verification.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"registration_type":{"type":"string","enum":["standard_10dlc","sole_prop_10dlc","toll_free"]},"phone_numbers":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":80,"minLength":1}},"brand":{"type":"object","additionalProperties":false,"required":["entity_type","display_name","street","city","state","postal_code","country","website","vertical"],"properties":{"entity_type":{"type":"string","enum":["PRIVATE_PROFIT","PUBLIC_PROFIT","NON_PROFIT","GOVERNMENT","SOLE_PROPRIETOR"]},"display_name":{"type":"string","maxLength":255,"minLength":1},"company_name":{"type":"string","maxLength":255},"ein":{"type":"string","maxLength":32},"phone":{"type":"string","maxLength":32},"mobile_phone":{"type":"string","maxLength":32},"street":{"type":"string","maxLength":255,"minLength":1},"city":{"type":"string","maxLength":120,"minLength":1},"state":{"type":"string","maxLength":64,"minLength":1},"postal_code":{"type":"string","maxLength":32,"minLength":1},"country":{"type":"string","maxLength":2,"minLength":2},"email":{"type":"string","format":"email","maxLength":254},"website":{"type":"string","maxLength":255,"minLength":1},"vertical":{"type":"string","enum":["AGRICULTURE","COMMUNICATION","CONSTRUCTION","EDUCATION","ENERGY","ENTERTAINMENT","FINANCIAL","GAMBLING","GOVERNMENT","HEALTHCARE","HOSPITALITY","HUMAN_RESOURCES","INSURANCE","LEGAL","MANUFACTURING","NGO","POLITICAL","POSTAL","PROFESSIONAL","REAL_ESTATE","RETAIL","TECHNOLOGY","TRANSPORTATION"]},"stock_symbol":{"type":"string","maxLength":16},"first_name":{"type":"string","maxLength":120},"last_name":{"type":"string","maxLength":120}}},"campaign":{"type":"object","additionalProperties":false,"required":["usecase","description","message_flow","sample1","sample2","optin_keywords","optout_keywords","help_keywords"],"properties":{"usecase":{"type":"string","maxLength":64,"minLength":1},"sub_usecases":{"type":"array","maxItems":5,"items":{"type":"string","maxLength":64,"minLength":1}},"description":{"type":"string","maxLength":4096,"minLength":1},"message_flow":{"type":"string","maxLength":4096,"minLength":1},"sample1":{"type":"string","maxLength":1024,"minLength":1},"sample2":{"type":"string","maxLength":1024,"minLength":1},"help_message":{"type":"string","maxLength":320},"optin_keywords":{"type":"string","maxLength":255,"minLength":1},"optin_message":{"type":"string","maxLength":320},"optout_keywords":{"type":"string","maxLength":255,"minLength":1},"optout_message":{"type":"string","maxLength":320},"help_keywords":{"type":"string","maxLength":255,"minLength":1},"embedded_link":{"type":"boolean"},"embedded_phone":{"type":"boolean"},"number_pool":{"type":"boolean"},"age_gated":{"type":"boolean"},"direct_lending":{"type":"boolean"},"privacy_policy_link":{"type":"string","maxLength":2048},"terms_and_conditions_link":{"type":"string","maxLength":2048}}},"toll_free":{"type":"object","additionalProperties":false,"required":["business_name","corporate_website","use_case","use_case_summary","production_message_content","opt_in_workflow","opt_in_workflow_image_urls","message_volume","additional_information","business_addr1","business_city","business_state","business_zip","business_contact_first_name","business_contact_last_name","business_contact_email","business_contact_phone"],"properties":{"business_name":{"type":"string","maxLength":255,"minLength":1},"corporate_website":{"type":"string","format":"uri","maxLength":2048},"use_case":{"type":"string","maxLength":120,"minLength":1},"use_case_summary":{"type":"string","maxLength":2000,"minLength":1},"production_message_content":{"type":"string","maxLength":2000,"minLength":1},"opt_in_workflow":{"type":"string","maxLength":2000,"minLength":1},"opt_in_workflow_image_urls":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","format":"uri","maxLength":2048}},"message_volume":{"type":"string","enum":["10","100","1,000","10,000","100,000","250,000","500,000","750,000","1,000,000","5,000,000","10,000,000+"]},"additional_information":{"type":"string","maxLength":2000,"minLength":1},"business_addr1":{"type":"string","maxLength":255,"minLength":1},"business_addr2":{"type":"string","maxLength":255},"business_city":{"type":"string","maxLength":120,"minLength":1},"business_state":{"type":"string","maxLength":64,"minLength":1},"business_zip":{"type":"string","maxLength":32,"minLength":1},"business_contact_first_name":{"type":"string","maxLength":120,"minLength":1},"business_contact_last_name":{"type":"string","maxLength":120,"minLength":1},"business_contact_email":{"type":"string","format":"email","maxLength":254},"business_contact_phone":{"type":"string","maxLength":32,"minLength":1},"business_registration_number":{"type":"string","maxLength":64},"business_registration_type":{"type":"string","maxLength":64},"business_registration_country":{"type":"string","maxLength":2}}},"messaging_brand_name":{"type":"string","maxLength":64},"resubmit_registration_id":{"type":"string","maxLength":80},"profile_id":{"type":"string","maxLength":80}},"required":["registration_type"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-sms-registration","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/registrations"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_registration"]},"id":{"type":"string"},"registration_type":{"type":"string"},"status":{"type":"string"},"display_name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"brand_status":{"type":["null","string"]},"campaign_status":{"type":["null","string"]},"provider_brand_id":{"type":["null","string"]},"provider_campaign_id":{"type":["null","string"]},"toll_free_request_id":{"type":["null","string"]},"brand":{"type":["null","object"],"additionalProperties":true},"campaign":{"type":["null","object"],"additionalProperties":true},"toll_free":{"type":["null","object"],"additionalProperties":true},"phone_numbers":{"type":"array","items":{"type":"string"}},"awaiting_otp":{"type":"boolean"},"otp_expired":{"type":"boolean"},"decline_reason":{"type":["null","string"]},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"trust_score":{"type":["null","integer"]},"throughput":{"type":["null","object"],"additionalProperties":true},"previously_rejected":{"type":"boolean"},"last_rejected_at":{"type":["null","string"],"format":"date-time"},"last_response_at":{"type":["null","string"],"format":"date-time"},"fees":{"type":"object","properties":{"brand_cents":{"type":"integer"},"campaign_monthly_cents":{"type":"integer"}}},"submitted_at":{"type":["null","string"],"format":"date-time"},"approved_at":{"type":["null","string"],"format":"date-time"},"deactivated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listSmsRegistrations","summary":"List carrier registrations","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"registration_type","required":false},{"schema":{"type":"boolean"},"in":"query","name":"include_deactivated","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-sms-registrations","x-feature":"telephony","x-zernio":["GET /v1/sms/registrations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["sms_registration"]},"id":{"type":"string"},"registration_type":{"type":"string"},"status":{"type":"string"},"display_name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"brand_status":{"type":["null","string"]},"campaign_status":{"type":["null","string"]},"provider_brand_id":{"type":["null","string"]},"provider_campaign_id":{"type":["null","string"]},"toll_free_request_id":{"type":["null","string"]},"brand":{"type":["null","object"],"additionalProperties":true},"campaign":{"type":["null","object"],"additionalProperties":true},"toll_free":{"type":["null","object"],"additionalProperties":true},"phone_numbers":{"type":"array","items":{"type":"string"}},"awaiting_otp":{"type":"boolean"},"otp_expired":{"type":"boolean"},"decline_reason":{"type":["null","string"]},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"trust_score":{"type":["null","integer"]},"throughput":{"type":["null","object"],"additionalProperties":true},"previously_rejected":{"type":"boolean"},"last_rejected_at":{"type":["null","string"],"format":"date-time"},"last_response_at":{"type":["null","string"],"format":"date-time"},"fees":{"type":"object","properties":{"brand_cents":{"type":"integer"},"campaign_monthly_cents":{"type":"integer"}}},"submitted_at":{"type":["null","string"],"format":"date-time"},"approved_at":{"type":["null","string"],"format":"date-time"},"deactivated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/registrations/{id}":{"get":{"operationId":"getSmsRegistration","summary":"Get a carrier registration","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-sms-registration","x-feature":"telephony","x-zernio":["GET /v1/sms/registrations/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_registration"]},"id":{"type":"string"},"registration_type":{"type":"string"},"status":{"type":"string"},"display_name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"brand_status":{"type":["null","string"]},"campaign_status":{"type":["null","string"]},"provider_brand_id":{"type":["null","string"]},"provider_campaign_id":{"type":["null","string"]},"toll_free_request_id":{"type":["null","string"]},"brand":{"type":["null","object"],"additionalProperties":true},"campaign":{"type":["null","object"],"additionalProperties":true},"toll_free":{"type":["null","object"],"additionalProperties":true},"phone_numbers":{"type":"array","items":{"type":"string"}},"awaiting_otp":{"type":"boolean"},"otp_expired":{"type":"boolean"},"decline_reason":{"type":["null","string"]},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"trust_score":{"type":["null","integer"]},"throughput":{"type":["null","object"],"additionalProperties":true},"previously_rejected":{"type":"boolean"},"last_rejected_at":{"type":["null","string"],"format":"date-time"},"last_response_at":{"type":["null","string"],"format":"date-time"},"fees":{"type":"object","properties":{"brand_cents":{"type":"integer"},"campaign_monthly_cents":{"type":"integer"}}},"submitted_at":{"type":["null","string"],"format":"date-time"},"approved_at":{"type":["null","string"],"format":"date-time"},"deactivated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deactivateSmsRegistration","summary":"Deactivate a brand / campaign registration","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"destructive","x-toolset":"telephony","x-mcp-tool":"deactivate-sms-registration","x-feature":"telephony","x-zernio":["DELETE /v1/sms/registrations/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_registration"]},"id":{"type":"string"},"registration_type":{"type":"string"},"status":{"type":"string"},"display_name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"brand_status":{"type":["null","string"]},"campaign_status":{"type":["null","string"]},"provider_brand_id":{"type":["null","string"]},"provider_campaign_id":{"type":["null","string"]},"toll_free_request_id":{"type":["null","string"]},"brand":{"type":["null","object"],"additionalProperties":true},"campaign":{"type":["null","object"],"additionalProperties":true},"toll_free":{"type":["null","object"],"additionalProperties":true},"phone_numbers":{"type":"array","items":{"type":"string"}},"awaiting_otp":{"type":"boolean"},"otp_expired":{"type":"boolean"},"decline_reason":{"type":["null","string"]},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"trust_score":{"type":["null","integer"]},"throughput":{"type":["null","object"],"additionalProperties":true},"previously_rejected":{"type":"boolean"},"last_rejected_at":{"type":["null","string"],"format":"date-time"},"last_response_at":{"type":["null","string"],"format":"date-time"},"fees":{"type":"object","properties":{"brand_cents":{"type":"integer"},"campaign_monthly_cents":{"type":"integer"}}},"submitted_at":{"type":["null","string"],"format":"date-time"},"approved_at":{"type":["null","string"],"format":"date-time"},"deactivated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/registrations/{id}/verify-otp":{"post":{"operationId":"verifySmsRegistrationOtp","summary":"Submit the sole-prop OTP","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"otp_pin":{"type":"string","maxLength":12,"minLength":4}},"required":["otp_pin"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"verify-sms-registration-otp","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/registrations/{id}/verify-otp"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_registration"]},"id":{"type":"string"},"registration_type":{"type":"string"},"status":{"type":"string"},"display_name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"brand_status":{"type":["null","string"]},"campaign_status":{"type":["null","string"]},"provider_brand_id":{"type":["null","string"]},"provider_campaign_id":{"type":["null","string"]},"toll_free_request_id":{"type":["null","string"]},"brand":{"type":["null","object"],"additionalProperties":true},"campaign":{"type":["null","object"],"additionalProperties":true},"toll_free":{"type":["null","object"],"additionalProperties":true},"phone_numbers":{"type":"array","items":{"type":"string"}},"awaiting_otp":{"type":"boolean"},"otp_expired":{"type":"boolean"},"decline_reason":{"type":["null","string"]},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"trust_score":{"type":["null","integer"]},"throughput":{"type":["null","object"],"additionalProperties":true},"previously_rejected":{"type":"boolean"},"last_rejected_at":{"type":["null","string"],"format":"date-time"},"last_response_at":{"type":["null","string"],"format":"date-time"},"fees":{"type":"object","properties":{"brand_cents":{"type":"integer"},"campaign_monthly_cents":{"type":"integer"}}},"submitted_at":{"type":["null","string"],"format":"date-time"},"approved_at":{"type":["null","string"],"format":"date-time"},"deactivated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/registrations/{id}/resend-otp":{"post":{"operationId":"resendSmsRegistrationOtp","summary":"Re-send the sole-prop OTP","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"resend-sms-registration-otp","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/registrations/{id}/resend-otp"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_registration_otp"]},"registration_id":{"type":"string"},"sent":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/registrations/{id}/appeal":{"post":{"operationId":"appealSmsRegistration","summary":"Appeal a rejected campaign","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"appeal_reason":{"type":"string","maxLength":2000,"minLength":1},"message_flow":{"type":"string","maxLength":4096},"sample1":{"type":"string","maxLength":1024},"sample2":{"type":"string","maxLength":1024}},"required":["appeal_reason"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"appeal-sms-registration","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/registrations/{id}/appeal"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_registration"]},"id":{"type":"string"},"registration_type":{"type":"string"},"status":{"type":"string"},"display_name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"brand_status":{"type":["null","string"]},"campaign_status":{"type":["null","string"]},"provider_brand_id":{"type":["null","string"]},"provider_campaign_id":{"type":["null","string"]},"toll_free_request_id":{"type":["null","string"]},"brand":{"type":["null","object"],"additionalProperties":true},"campaign":{"type":["null","object"],"additionalProperties":true},"toll_free":{"type":["null","object"],"additionalProperties":true},"phone_numbers":{"type":"array","items":{"type":"string"}},"awaiting_otp":{"type":"boolean"},"otp_expired":{"type":"boolean"},"decline_reason":{"type":["null","string"]},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"trust_score":{"type":["null","integer"]},"throughput":{"type":["null","object"],"additionalProperties":true},"previously_rejected":{"type":"boolean"},"last_rejected_at":{"type":["null","string"],"format":"date-time"},"last_response_at":{"type":["null","string"],"format":"date-time"},"fees":{"type":"object","properties":{"brand_cents":{"type":"integer"},"campaign_monthly_cents":{"type":"integer"}}},"submitted_at":{"type":["null","string"],"format":"date-time"},"approved_at":{"type":["null","string"],"format":"date-time"},"deactivated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/registrations/{id}/respond":{"post":{"operationId":"respondSmsRegistration","summary":"Reply to a change request","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"note":{"type":"string","maxLength":5000},"files":{"type":"array","maxItems":10,"items":{"type":"string","format":"uri","maxLength":2048}},"request_id":{"type":"string","maxLength":80},"answers":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["point_id"],"properties":{"point_id":{"type":"string","maxLength":80,"minLength":1},"text":{"type":"string","maxLength":5000},"url":{"type":"string","format":"uri","maxLength":2048},"files":{"type":"array","maxItems":5,"items":{"type":"string","format":"uri","maxLength":2048}}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"respond-sms-registration","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/registrations/{id}/respond"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_registration"]},"id":{"type":"string"},"registration_type":{"type":"string"},"status":{"type":"string"},"display_name":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"brand_status":{"type":["null","string"]},"campaign_status":{"type":["null","string"]},"provider_brand_id":{"type":["null","string"]},"provider_campaign_id":{"type":["null","string"]},"toll_free_request_id":{"type":["null","string"]},"brand":{"type":["null","object"],"additionalProperties":true},"campaign":{"type":["null","object"],"additionalProperties":true},"toll_free":{"type":["null","object"],"additionalProperties":true},"phone_numbers":{"type":"array","items":{"type":"string"}},"awaiting_otp":{"type":"boolean"},"otp_expired":{"type":"boolean"},"decline_reason":{"type":["null","string"]},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"trust_score":{"type":["null","integer"]},"throughput":{"type":["null","object"],"additionalProperties":true},"previously_rejected":{"type":"boolean"},"last_rejected_at":{"type":["null","string"],"format":"date-time"},"last_response_at":{"type":["null","string"],"format":"date-time"},"fees":{"type":"object","properties":{"brand_cents":{"type":"integer"},"campaign_monthly_cents":{"type":"integer"}}},"submitted_at":{"type":["null","string"],"format":"date-time"},"approved_at":{"type":["null","string"],"format":"date-time"},"deactivated_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/registrations/{id}/opt-in-proof":{"post":{"operationId":"uploadSmsRegistrationOptInProof","summary":"Upload opt-in form proof for an appeal","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"},"mime_type":{"type":"string","maxLength":100}},"required":["filename","content_base64"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"upload-sms-registration-opt-in-proof","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/registrations/{id}/opt-in-proof"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["telephony_document"]},"id":{"type":"string"},"provider_document_id":{"type":["null","string"]},"kind":{"type":"string"},"filename":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"status":{"type":["null","string"]},"url":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sms/opt-in-proof":{"post":{"operationId":"uploadSmsOptInProof","summary":"Upload opt-in form proof","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"},"mime_type":{"type":"string","maxLength":100}},"required":["filename","content_base64"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"upload-sms-opt-in-proof","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/opt-in-proof"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["telephony_document"]},"id":{"type":"string"},"provider_document_id":{"type":["null","string"]},"kind":{"type":"string"},"filename":{"type":"string"},"mime_type":{"type":["null","string"]},"size":{"type":["null","integer"]},"status":{"type":["null","string"]},"url":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/sms/registrations/share":{"post":{"operationId":"shareSmsRegistration","summary":"Create a registration share link","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phone_number_id":{"type":"string","maxLength":80,"minLength":1},"language":{"type":"string","enum":["en","es","pt-BR"]},"branding":{"type":"object","additionalProperties":false,"properties":{"company_name":{"type":"string","maxLength":120},"logo_url":{"type":"string","format":"uri","maxLength":2048},"brand_color":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"}}},"redirect_url":{"type":"string","format":"uri","maxLength":2048}},"required":["phone_number_id"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"share-sms-registration","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/sms/registrations/share"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["telephony_share_link"]},"id":{"type":"string"},"kind":{"type":"string"},"url":{"type":["null","string"]},"token":{"type":["null","string"]},"expires_at":{"type":["null","string"],"format":"date-time"},"used_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/calls":{"get":{"operationId":"listCalls","summary":"List all calls","tags":["Telephony"],"description":"Call history, newest first; filter by number, account or contact.","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","enum":["pstn"]},"in":"query","name":"channel","required":false},{"schema":{"type":"string","enum":["dialing","ringing","answered","ended","failed"]},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["inbound","outbound"]},"in":"query","name":"direction","required":false},{"schema":{"type":"string","maxLength":32},"in":"query","name":"number","required":false},{"schema":{"type":"string"},"in":"query","name":"phone_number_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"contact_id","required":false},{"schema":{"type":"string","maxLength":64},"in":"query","name":"search","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-calls","x-feature":"telephony","x-zernio":["GET /v1/calls"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["call"]},"id":{"type":"string"},"channel":{"type":"string"},"direction":{"type":"string"},"status":{"type":"string"},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"forward_to":{"type":["null","string"]},"forward_caller_id":{"type":"string"},"greeting":{"type":["null","string"]},"source":{"type":"string"},"is_voicemail":{"type":"boolean"},"amd":{"type":"boolean"},"answered_by_machine":{"type":["null","boolean"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"has_recording":{"type":"boolean"},"recording_url":{"type":["null","string"]},"transcript":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"confidence":{"type":["null","number"]},"at":{"type":["null","string"]}}}},"last_transcript_snippet":{"type":["null","string"]},"duration_seconds":{"type":"integer"},"end_reason":{"type":["null","string"]},"hangup_cause":{"type":["null","string"]},"sip_hangup_cause":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string","number"]},"message":{"type":["null","string"]}}}},"transferred_to":{"type":["null","string"]},"branded":{"type":"boolean"},"billing":{"type":"object","properties":{"carrier_seconds":{"type":"number"},"carrier_cost_usd":{"type":"number"},"recording_cost_usd":{"type":"number"},"transcription_cost_usd":{"type":"number"},"branded_call_usd":{"type":"number"},"billable_cost_usd":{"type":"number"},"total_cost_usd":{"type":"number"},"currency":{"type":"string"}}},"provider_call_control_id":{"type":["null","string"]},"started_at":{"type":["null","string"],"format":"date-time"},"answered_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"transferred_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/calls/{id}":{"get":{"operationId":"getCall","summary":"Get a call","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-call","x-feature":"telephony","x-zernio":["GET /v1/calls/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["call"]},"id":{"type":"string"},"channel":{"type":"string"},"direction":{"type":"string"},"status":{"type":"string"},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"forward_to":{"type":["null","string"]},"forward_caller_id":{"type":"string"},"greeting":{"type":["null","string"]},"source":{"type":"string"},"is_voicemail":{"type":"boolean"},"amd":{"type":"boolean"},"answered_by_machine":{"type":["null","boolean"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"has_recording":{"type":"boolean"},"recording_url":{"type":["null","string"]},"transcript":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"confidence":{"type":["null","number"]},"at":{"type":["null","string"]}}}},"last_transcript_snippet":{"type":["null","string"]},"duration_seconds":{"type":"integer"},"end_reason":{"type":["null","string"]},"hangup_cause":{"type":["null","string"]},"sip_hangup_cause":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string","number"]},"message":{"type":["null","string"]}}}},"transferred_to":{"type":["null","string"]},"branded":{"type":"boolean"},"billing":{"type":"object","properties":{"carrier_seconds":{"type":"number"},"carrier_cost_usd":{"type":"number"},"recording_cost_usd":{"type":"number"},"transcription_cost_usd":{"type":"number"},"branded_call_usd":{"type":"number"},"billable_cost_usd":{"type":"number"},"total_cost_usd":{"type":"number"},"currency":{"type":"string"}}},"provider_call_control_id":{"type":["null","string"]},"started_at":{"type":["null","string"],"format":"date-time"},"answered_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"transferred_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/calls/{id}/recording":{"get":{"operationId":"getCallRecording","summary":"Get a call recording","tags":["Telephony"],"description":"302 to a short-lived URL, or format=json.","parameters":[{"schema":{"type":"string","enum":["redirect","json"]},"in":"query","name":"format","required":false},{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":null,"x-feature":"telephony","x-zernio":["GET /v1/calls/{id}/recording"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["call_recording"]},"call_id":{"type":"string"},"url":{"type":"string"},"expires_at":{"type":["null","string"],"format":"date-time"},"duration_seconds":{"type":["null","integer"]},"format":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/voice/calls":{"post":{"operationId":"placeCall","summary":"Place an outbound phone call","tags":["Telephony"],"description":"Dials `to` and bridges it to the number destination (or forward_to). 60 calls per hour.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"to":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"},"from":{"type":"string","maxLength":80},"profile_id":{"type":"string","maxLength":80},"forward_to":{"type":"string","maxLength":500},"greeting":{"type":"string","maxLength":500},"record":{"type":"boolean"},"transcribe":{"type":"boolean"},"transcription_language":{"type":"string","enum":["auto","en","es"]},"amd":{"type":"boolean"},"voicemail_drop_message":{"type":"string","maxLength":500},"ring_timeout_seconds":{"type":"integer","minimum":10,"maximum":120}},"required":["to"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"telephony","x-mcp-tool":"place-call","x-idempotent":true,"x-feature":"telephony","x-rate-limit":{"max":60,"timeWindow":"1 hour"},"x-zernio":["POST /v1/voice/calls"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["call"]},"id":{"type":"string"},"channel":{"type":"string"},"direction":{"type":"string"},"status":{"type":"string"},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"forward_to":{"type":["null","string"]},"forward_caller_id":{"type":"string"},"greeting":{"type":["null","string"]},"source":{"type":"string"},"is_voicemail":{"type":"boolean"},"amd":{"type":"boolean"},"answered_by_machine":{"type":["null","boolean"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"has_recording":{"type":"boolean"},"recording_url":{"type":["null","string"]},"transcript":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"confidence":{"type":["null","number"]},"at":{"type":["null","string"]}}}},"last_transcript_snippet":{"type":["null","string"]},"duration_seconds":{"type":"integer"},"end_reason":{"type":["null","string"]},"hangup_cause":{"type":["null","string"]},"sip_hangup_cause":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string","number"]},"message":{"type":["null","string"]}}}},"transferred_to":{"type":["null","string"]},"branded":{"type":"boolean"},"billing":{"type":"object","properties":{"carrier_seconds":{"type":"number"},"carrier_cost_usd":{"type":"number"},"recording_cost_usd":{"type":"number"},"transcription_cost_usd":{"type":"number"},"branded_call_usd":{"type":"number"},"billable_cost_usd":{"type":"number"},"total_cost_usd":{"type":"number"},"currency":{"type":"string"}}},"provider_call_control_id":{"type":["null","string"]},"started_at":{"type":["null","string"],"format":"date-time"},"answered_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"transferred_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listPhoneCalls","summary":"List phone calls","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string","enum":["dialing","ringing","answered","ended","failed"]},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["inbound","outbound"]},"in":"query","name":"direction","required":false},{"schema":{"type":"string","maxLength":32},"in":"query","name":"number","required":false},{"schema":{"type":"string"},"in":"query","name":"phone_number_id","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"contact_id","required":false},{"schema":{"type":"string","maxLength":64},"in":"query","name":"search","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-phone-calls","x-feature":"telephony","x-zernio":["GET /v1/voice/calls"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["call"]},"id":{"type":"string"},"channel":{"type":"string"},"direction":{"type":"string"},"status":{"type":"string"},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"forward_to":{"type":["null","string"]},"forward_caller_id":{"type":"string"},"greeting":{"type":["null","string"]},"source":{"type":"string"},"is_voicemail":{"type":"boolean"},"amd":{"type":"boolean"},"answered_by_machine":{"type":["null","boolean"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"has_recording":{"type":"boolean"},"recording_url":{"type":["null","string"]},"transcript":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"confidence":{"type":["null","number"]},"at":{"type":["null","string"]}}}},"last_transcript_snippet":{"type":["null","string"]},"duration_seconds":{"type":"integer"},"end_reason":{"type":["null","string"]},"hangup_cause":{"type":["null","string"]},"sip_hangup_cause":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string","number"]},"message":{"type":["null","string"]}}}},"transferred_to":{"type":["null","string"]},"branded":{"type":"boolean"},"billing":{"type":"object","properties":{"carrier_seconds":{"type":"number"},"carrier_cost_usd":{"type":"number"},"recording_cost_usd":{"type":"number"},"transcription_cost_usd":{"type":"number"},"branded_call_usd":{"type":"number"},"billable_cost_usd":{"type":"number"},"total_cost_usd":{"type":"number"},"currency":{"type":"string"}}},"provider_call_control_id":{"type":["null","string"]},"started_at":{"type":["null","string"],"format":"date-time"},"answered_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"transferred_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/voice/calls/estimate":{"get":{"operationId":"estimateCall","summary":"Estimate call cost","tags":["Telephony"],"parameters":[{"schema":{"type":"string","maxLength":32,"minLength":3},"in":"query","name":"to","required":true},{"schema":{"type":"string","maxLength":80},"in":"query","name":"from","required":false},{"schema":{"type":"integer","minimum":1,"maximum":600},"in":"query","name":"minutes","required":false},{"schema":{"type":"boolean"},"in":"query","name":"recording","required":false},{"schema":{"type":"boolean"},"in":"query","name":"transcription","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"estimate-call","x-zernio":["GET /v1/voice/calls/estimate"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["call_estimate"]},"to":{"type":"string"},"destination_country":{"type":["null","string"]},"minutes":{"type":"integer"},"per_minute_usd":{"type":"number"},"breakdown":{"type":"object","properties":{"carrier_cost_usd":{"type":"number"},"recording_cost_usd":{"type":"number"},"transcription_cost_usd":{"type":"number"},"branded_call_usd":{"type":"number"},"billable_cost_usd":{"type":"number"},"total_cost_usd":{"type":"number"}}},"currency":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/voice/calls/{id}":{"get":{"operationId":"getPhoneCall","summary":"Get a phone call","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-phone-call","x-feature":"telephony","x-zernio":["GET /v1/voice/calls/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["call"]},"id":{"type":"string"},"channel":{"type":"string"},"direction":{"type":"string"},"status":{"type":"string"},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"forward_to":{"type":["null","string"]},"forward_caller_id":{"type":"string"},"greeting":{"type":["null","string"]},"source":{"type":"string"},"is_voicemail":{"type":"boolean"},"amd":{"type":"boolean"},"answered_by_machine":{"type":["null","boolean"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"has_recording":{"type":"boolean"},"recording_url":{"type":["null","string"]},"transcript":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"confidence":{"type":["null","number"]},"at":{"type":["null","string"]}}}},"last_transcript_snippet":{"type":["null","string"]},"duration_seconds":{"type":"integer"},"end_reason":{"type":["null","string"]},"hangup_cause":{"type":["null","string"]},"sip_hangup_cause":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string","number"]},"message":{"type":["null","string"]}}}},"transferred_to":{"type":["null","string"]},"branded":{"type":"boolean"},"billing":{"type":"object","properties":{"carrier_seconds":{"type":"number"},"carrier_cost_usd":{"type":"number"},"recording_cost_usd":{"type":"number"},"transcription_cost_usd":{"type":"number"},"branded_call_usd":{"type":"number"},"billable_cost_usd":{"type":"number"},"total_cost_usd":{"type":"number"},"currency":{"type":"string"}}},"provider_call_control_id":{"type":["null","string"]},"started_at":{"type":["null","string"],"format":"date-time"},"answered_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"transferred_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/voice/calls/{id}/end":{"post":{"operationId":"endPhoneCall","summary":"Hang up a live call","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"telephony","x-mcp-tool":"end-phone-call","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/voice/calls/{id}/end"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["call"]},"id":{"type":"string"},"channel":{"type":"string"},"direction":{"type":"string"},"status":{"type":"string"},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"forward_to":{"type":["null","string"]},"forward_caller_id":{"type":"string"},"greeting":{"type":["null","string"]},"source":{"type":"string"},"is_voicemail":{"type":"boolean"},"amd":{"type":"boolean"},"answered_by_machine":{"type":["null","boolean"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"has_recording":{"type":"boolean"},"recording_url":{"type":["null","string"]},"transcript":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"confidence":{"type":["null","number"]},"at":{"type":["null","string"]}}}},"last_transcript_snippet":{"type":["null","string"]},"duration_seconds":{"type":"integer"},"end_reason":{"type":["null","string"]},"hangup_cause":{"type":["null","string"]},"sip_hangup_cause":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string","number"]},"message":{"type":["null","string"]}}}},"transferred_to":{"type":["null","string"]},"branded":{"type":"boolean"},"billing":{"type":"object","properties":{"carrier_seconds":{"type":"number"},"carrier_cost_usd":{"type":"number"},"recording_cost_usd":{"type":"number"},"transcription_cost_usd":{"type":"number"},"branded_call_usd":{"type":"number"},"billable_cost_usd":{"type":"number"},"total_cost_usd":{"type":"number"},"currency":{"type":"string"}}},"provider_call_control_id":{"type":["null","string"]},"started_at":{"type":["null","string"],"format":"date-time"},"answered_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"transferred_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/voice/calls/{id}/transfer":{"post":{"operationId":"transferPhoneCall","summary":"Blind-transfer a live call","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"to":{"type":"string","maxLength":500,"minLength":3}},"required":["to"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"telephony","x-mcp-tool":"transfer-phone-call","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/voice/calls/{id}/transfer"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["call"]},"id":{"type":"string"},"channel":{"type":"string"},"direction":{"type":"string"},"status":{"type":"string"},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"forward_to":{"type":["null","string"]},"forward_caller_id":{"type":"string"},"greeting":{"type":["null","string"]},"source":{"type":"string"},"is_voicemail":{"type":"boolean"},"amd":{"type":"boolean"},"answered_by_machine":{"type":["null","boolean"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"has_recording":{"type":"boolean"},"recording_url":{"type":["null","string"]},"transcript":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"confidence":{"type":["null","number"]},"at":{"type":["null","string"]}}}},"last_transcript_snippet":{"type":["null","string"]},"duration_seconds":{"type":"integer"},"end_reason":{"type":["null","string"]},"hangup_cause":{"type":["null","string"]},"sip_hangup_cause":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string","number"]},"message":{"type":["null","string"]}}}},"transferred_to":{"type":["null","string"]},"branded":{"type":"boolean"},"billing":{"type":"object","properties":{"carrier_seconds":{"type":"number"},"carrier_cost_usd":{"type":"number"},"recording_cost_usd":{"type":"number"},"transcription_cost_usd":{"type":"number"},"branded_call_usd":{"type":"number"},"billable_cost_usd":{"type":"number"},"total_cost_usd":{"type":"number"},"currency":{"type":"string"}}},"provider_call_control_id":{"type":["null","string"]},"started_at":{"type":["null","string"],"format":"date-time"},"answered_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"transferred_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/voice/calls/{id}/recording":{"get":{"operationId":"getPhoneCallRecording","summary":"Get a phone call recording","tags":["Telephony"],"parameters":[{"schema":{"type":"string","enum":["redirect","json"]},"in":"query","name":"format","required":false},{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":null,"x-feature":"telephony","x-zernio":["GET /v1/voice/calls/{id}/recording"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["call_recording"]},"call_id":{"type":"string"},"url":{"type":"string"},"expires_at":{"type":["null","string"],"format":"date-time"},"duration_seconds":{"type":["null","integer"]},"format":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/voice/calls/web":{"post":{"operationId":"createSoftphoneSession","summary":"Mint a browser softphone session","tags":["Telephony"],"description":"A 24 h Telnyx WebRTC login token for @telnyx/webrtc.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phone_number_id":{"type":"string","maxLength":80}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"telephony","x-mcp-tool":null,"x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/voice/calls/web"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["softphone_session"]},"id":{"type":"string"},"token":{"type":"string"},"credential_id":{"type":"string"},"sip_username":{"type":["null","string"]},"expires_at":{"type":["null","string"],"format":"date-time"},"sdk":{"type":"string"},"phone_number_id":{"type":["null","string"]},"caller_id":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/voice/calls/web/dial":{"post":{"operationId":"dialFromSoftphone","summary":"Dial from the browser softphone","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"to":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"},"session_id":{"type":"string","maxLength":80,"minLength":1},"from":{"type":"string","maxLength":80},"record":{"type":"boolean"},"ring_timeout_seconds":{"type":"integer","minimum":10,"maximum":120}},"required":["to","session_id"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"external","x-toolset":"telephony","x-mcp-tool":null,"x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/voice/calls/web/dial"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["call"]},"id":{"type":"string"},"channel":{"type":"string"},"direction":{"type":"string"},"status":{"type":"string"},"from":{"type":["null","string"]},"to":{"type":["null","string"]},"phone_number_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"profile_id":{"type":["null","string"]},"contact_id":{"type":["null","string"]},"contact_name":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"forward_to":{"type":["null","string"]},"forward_caller_id":{"type":"string"},"greeting":{"type":["null","string"]},"source":{"type":"string"},"is_voicemail":{"type":"boolean"},"amd":{"type":"boolean"},"answered_by_machine":{"type":["null","boolean"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"has_recording":{"type":"boolean"},"recording_url":{"type":["null","string"]},"transcript":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"confidence":{"type":["null","number"]},"at":{"type":["null","string"]}}}},"last_transcript_snippet":{"type":["null","string"]},"duration_seconds":{"type":"integer"},"end_reason":{"type":["null","string"]},"hangup_cause":{"type":["null","string"]},"sip_hangup_cause":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":["null","string","number"]},"message":{"type":["null","string"]}}}},"transferred_to":{"type":["null","string"]},"branded":{"type":"boolean"},"billing":{"type":"object","properties":{"carrier_seconds":{"type":"number"},"carrier_cost_usd":{"type":"number"},"recording_cost_usd":{"type":"number"},"transcription_cost_usd":{"type":"number"},"branded_call_usd":{"type":"number"},"billable_cost_usd":{"type":"number"},"total_cost_usd":{"type":"number"},"currency":{"type":"string"}}},"provider_call_control_id":{"type":["null","string"]},"started_at":{"type":["null","string"],"format":"date-time"},"answered_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"transferred_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/phone-numbers/{id}/voice":{"get":{"operationId":"getPhoneNumberVoice","summary":"Get the inbound call routing of a number","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-phone-number-voice","x-feature":"telephony","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["number_voice_settings"]},"phone_number_id":{"type":"string"},"phone_number":{"type":["null","string"]},"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"voicemail_enabled":{"type":"boolean"},"voicemail_greeting":{"type":["null","string"]},"voicemail_email":{"type":"boolean"},"business_hours_enabled":{"type":"boolean"},"business_hours_timezone":{"type":["null","string"]},"business_hours":{"type":"array","items":{"type":"object","properties":{"day":{"type":"integer"},"open":{"type":"string"},"close":{"type":"string"}}}},"blocked_callers":{"type":"array","items":{"type":"string"}},"forward_caller_id":{"type":"string"},"ivr_enabled":{"type":"boolean"},"ivr_prompt":{"type":["null","string"]},"ivr_options":{"type":"array","items":{"type":"object","properties":{"digit":{"type":"string"},"forward_to":{"type":"string"},"label":{"type":["null","string"]}}}},"max_call_duration_seconds":{"type":"integer"},"sip_trunk_id":{"type":["null","string"]},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"enablePhoneNumberVoice","summary":"Enable / configure phone calling on a number","tags":["Telephony"],"description":"Only sent fields change; null clears.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"forward_to":{"type":["string","null"],"maxLength":500},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string","enum":["auto","en","es"]},"voicemail_enabled":{"type":"boolean"},"voicemail_greeting":{"type":["string","null"],"maxLength":500},"voicemail_email":{"type":"boolean"},"business_hours_enabled":{"type":"boolean"},"business_hours_timezone":{"type":["string","null"],"maxLength":64},"business_hours":{"type":"array","maxItems":21,"items":{"type":"object","additionalProperties":false,"required":["day","open","close"],"properties":{"day":{"type":"integer","minimum":0,"maximum":6},"open":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"close":{"type":"string","pattern":"^([01]\\d|2[0-4]):[0-5]\\d$"}}}},"blocked_callers":{"type":"array","maxItems":500,"items":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"}},"forward_caller_id":{"type":"string","enum":["business","caller"]},"ivr_enabled":{"type":"boolean"},"ivr_prompt":{"type":["string","null"],"maxLength":1000},"ivr_options":{"type":"array","maxItems":12,"items":{"type":"object","additionalProperties":false,"required":["digit","forward_to"],"properties":{"digit":{"type":"string","pattern":"^[0-9*#]$"},"forward_to":{"type":"string","maxLength":500,"minLength":1},"label":{"type":"string","maxLength":60}}}},"max_call_duration_seconds":{"type":"integer","minimum":60,"maximum":14400}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"telephony","x-mcp-tool":"enable-phone-number-voice","x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/{id}/voice"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["number_voice_settings"]},"phone_number_id":{"type":"string"},"phone_number":{"type":["null","string"]},"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"voicemail_enabled":{"type":"boolean"},"voicemail_greeting":{"type":["null","string"]},"voicemail_email":{"type":"boolean"},"business_hours_enabled":{"type":"boolean"},"business_hours_timezone":{"type":["null","string"]},"business_hours":{"type":"array","items":{"type":"object","properties":{"day":{"type":"integer"},"open":{"type":"string"},"close":{"type":"string"}}}},"blocked_callers":{"type":"array","items":{"type":"string"}},"forward_caller_id":{"type":"string"},"ivr_enabled":{"type":"boolean"},"ivr_prompt":{"type":["null","string"]},"ivr_options":{"type":"array","items":{"type":"object","properties":{"digit":{"type":"string"},"forward_to":{"type":"string"},"label":{"type":["null","string"]}}}},"max_call_duration_seconds":{"type":"integer"},"sip_trunk_id":{"type":["null","string"]},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"disablePhoneNumberVoice","summary":"Disable phone calling on a number","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"disable-phone-number-voice","x-feature":"telephony","x-zernio":["DELETE /v1/phone-numbers/{id}/voice"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["number_voice_settings"]},"phone_number_id":{"type":"string"},"phone_number":{"type":["null","string"]},"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"transcription_language":{"type":"string"},"voicemail_enabled":{"type":"boolean"},"voicemail_greeting":{"type":["null","string"]},"voicemail_email":{"type":"boolean"},"business_hours_enabled":{"type":"boolean"},"business_hours_timezone":{"type":["null","string"]},"business_hours":{"type":"array","items":{"type":"object","properties":{"day":{"type":"integer"},"open":{"type":"string"},"close":{"type":"string"}}}},"blocked_callers":{"type":"array","items":{"type":"string"}},"forward_caller_id":{"type":"string"},"ivr_enabled":{"type":"boolean"},"ivr_prompt":{"type":["null","string"]},"ivr_options":{"type":"array","items":{"type":"object","properties":{"digit":{"type":"string"},"forward_to":{"type":"string"},"label":{"type":["null","string"]}}}},"max_call_duration_seconds":{"type":"integer"},"sip_trunk_id":{"type":["null","string"]},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sip-trunks":{"post":{"operationId":"createSipTrunk","summary":"Create a SIP trunk","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string","maxLength":100,"minLength":1},"sip_host":{"type":"string","maxLength":255,"minLength":3},"sip_port":{"type":"integer","minimum":1,"maximum":65535},"transport":{"type":"string","enum":["tls","tcp","udp"]},"profile_id":{"type":"string","maxLength":80}},"required":["label","sip_host"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-sip-trunk","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/sip-trunks"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sip_trunk"]},"id":{"type":"string"},"label":{"type":"string"},"profile_id":{"type":["null","string"]},"sip_host":{"type":"string"},"sip_port":{"type":"integer"},"transport":{"type":"string"},"termination":{"type":"object","properties":{"uri":{"type":"string"},"username":{"type":"string"}}},"numbers_attached":{"type":"integer"},"numbers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"phone_number":{"type":["null","string"]}}}},"provider_connection_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"digest_password":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listSipTrunks","summary":"List SIP trunks","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-sip-trunks","x-feature":"telephony","x-zernio":["GET /v1/phone-numbers/sip-trunks"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["sip_trunk"]},"id":{"type":"string"},"label":{"type":"string"},"profile_id":{"type":["null","string"]},"sip_host":{"type":"string"},"sip_port":{"type":"integer"},"transport":{"type":"string"},"termination":{"type":"object","properties":{"uri":{"type":"string"},"username":{"type":"string"}}},"numbers_attached":{"type":"integer"},"numbers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"phone_number":{"type":["null","string"]}}}},"provider_connection_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sip-trunks/{id}":{"get":{"operationId":"getSipTrunk","summary":"Get a SIP trunk","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-sip-trunk","x-feature":"telephony","x-zernio":["GET /v1/phone-numbers/sip-trunks/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sip_trunk"]},"id":{"type":"string"},"label":{"type":"string"},"profile_id":{"type":["null","string"]},"sip_host":{"type":"string"},"sip_port":{"type":"integer"},"transport":{"type":"string"},"termination":{"type":"object","properties":{"uri":{"type":"string"},"username":{"type":"string"}}},"numbers_attached":{"type":"integer"},"numbers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"phone_number":{"type":["null","string"]}}}},"provider_connection_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateSipTrunk","summary":"Update a SIP trunk","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string","maxLength":100,"minLength":1},"sip_host":{"type":"string","maxLength":255,"minLength":3},"sip_port":{"type":"integer","minimum":1,"maximum":65535},"transport":{"type":"string","enum":["tls","tcp","udp"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"telephony","x-mcp-tool":"update-sip-trunk","x-feature":"telephony","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sip_trunk"]},"id":{"type":"string"},"label":{"type":"string"},"profile_id":{"type":["null","string"]},"sip_host":{"type":"string"},"sip_port":{"type":"integer"},"transport":{"type":"string"},"termination":{"type":"object","properties":{"uri":{"type":"string"},"username":{"type":"string"}}},"numbers_attached":{"type":"integer"},"numbers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"phone_number":{"type":["null","string"]}}}},"provider_connection_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteSipTrunk","summary":"Delete a SIP trunk","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"delete-sip-trunk","x-feature":"telephony","x-zernio":["DELETE /v1/phone-numbers/sip-trunks/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sip_trunk"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/sip-trunks/{id}/rotate-credentials":{"post":{"operationId":"rotateSipTrunkCredentials","summary":"Rotate a SIP trunk's password","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"rotate-sip-trunk-credentials","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/sip-trunks/{id}/rotate-credentials"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sip_trunk"]},"id":{"type":"string"},"label":{"type":"string"},"profile_id":{"type":["null","string"]},"sip_host":{"type":"string"},"sip_port":{"type":"integer"},"transport":{"type":"string"},"termination":{"type":"object","properties":{"uri":{"type":"string"},"username":{"type":"string"}}},"numbers_attached":{"type":"integer"},"numbers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"phone_number":{"type":["null","string"]}}}},"provider_connection_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"digest_password":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/{id}/sip-trunk":{"post":{"operationId":"attachPhoneNumberSipTrunk","summary":"Attach a number to a SIP trunk","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"trunk_id":{"type":"string","maxLength":80,"minLength":1}},"required":["trunk_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"attach-phone-number-sip-trunk","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/phone-numbers/{id}/sip-trunk"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"detachPhoneNumberSipTrunk","summary":"Detach a number from its SIP trunk","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"detach-phone-number-sip-trunk","x-feature":"telephony","x-zernio":["DELETE /v1/phone-numbers/{id}/sip-trunk"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/rcs/brands":{"get":{"operationId":"listRcsBrands","summary":"List RCS brands","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-rcs-brands","x-feature":"telephony","x-zernio":["GET /v1/rcs/brands"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_brand"]},"id":{"type":"string"},"display_name":{"type":"string"},"legal_name":{"type":"string"},"legal_entity_type":{"type":"string"},"organization_type":{"type":"string"},"website_url":{"type":"string"},"tax_id_last4":{"type":["null","string"]},"stock_symbol":{"type":["null","string"]},"address":{"type":"object","properties":{"line1":{"type":["null","string"]},"line2":{"type":["null","string"]},"city":{"type":["null","string"]},"state":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"title":{"type":["null","string"]},"email":{"type":["null","string"]},"phone":{"type":["null","string"]}}},"status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/rcs/agents":{"post":{"operationId":"createRcsAgent","summary":"Request an RCS agent","tags":["Telephony"],"description":"One open agent per profile. A live agent becomes an `rcs` inbox account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"profile_id":{"type":"string","maxLength":80,"minLength":1},"brand_id":{"type":"string","maxLength":80},"brand":{"type":"object","additionalProperties":false,"required":["display_name","legal_name","legal_entity_type","organization_type","website_url","tax_id","address","contact"],"properties":{"display_name":{"type":"string","maxLength":100,"minLength":1},"legal_name":{"type":"string","maxLength":100,"minLength":1},"legal_entity_type":{"type":"string","enum":["LIMITED_LIABILITY_COMPANY","SOLE_PROPRIETORSHIP","PARTNERSHIP","CORPORATION","S_CORPORATION"]},"organization_type":{"type":"string","enum":["PRIVATE_PROFIT","PUBLIC_PROFIT","NON_PROFIT","GOVERNMENT"]},"website_url":{"type":"string","format":"uri","maxLength":2048},"tax_id":{"type":"string","maxLength":32,"minLength":1},"stock_symbol":{"type":"string","maxLength":16},"address":{"type":"object","additionalProperties":false,"required":["line1","city","postal_code","country"],"properties":{"line1":{"type":"string","maxLength":255,"minLength":1},"line2":{"type":"string","maxLength":255},"city":{"type":"string","maxLength":120,"minLength":1},"state":{"type":"string","maxLength":64},"postal_code":{"type":"string","maxLength":32,"minLength":1},"country":{"type":"string","maxLength":2,"minLength":2}}},"contact":{"type":"object","additionalProperties":false,"required":["first_name","last_name","email","phone"],"properties":{"first_name":{"type":"string","maxLength":120,"minLength":1},"last_name":{"type":"string","maxLength":120,"minLength":1},"title":{"type":"string","maxLength":120},"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string","maxLength":32,"minLength":1}}}}},"display_name":{"type":"string","maxLength":40,"minLength":1},"use_case":{"type":"string","enum":["TRANSACTIONAL","PROMOTIONAL","MULTI_USE","OTP"]},"country":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"agent_profile":{"type":"object","additionalProperties":false,"required":["description","logo_url","banner_url","brand_color","privacy_policy_url","terms_url"],"properties":{"description":{"type":"string","maxLength":100,"minLength":1},"logo_url":{"type":"string","format":"uri","maxLength":2048},"banner_url":{"type":"string","format":"uri","maxLength":2048},"brand_color":{"type":"string","pattern":"^#(?:[0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$"},"privacy_policy_url":{"type":"string","format":"uri","maxLength":2048},"terms_url":{"type":"string","format":"uri","maxLength":2048},"phone":{"type":["object","null"],"additionalProperties":false,"required":["number","label"],"properties":{"number":{"type":"string","maxLength":32,"minLength":1},"label":{"type":"string","maxLength":25,"minLength":1}}},"website":{"type":["object","null"],"additionalProperties":false,"required":["url","label"],"properties":{"url":{"type":"string","format":"uri","maxLength":2048},"label":{"type":"string","maxLength":25,"minLength":1}}},"email":{"type":["object","null"],"additionalProperties":false,"required":["address","label"],"properties":{"address":{"type":"string","format":"email","maxLength":254},"label":{"type":"string","maxLength":25,"minLength":1}}}}},"sms_fallback_from":{"type":"string","maxLength":80}},"required":["profile_id","display_name","use_case","agent_profile"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-rcs-agent","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/rcs/agents"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_agent"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"country":{"type":"string"},"status":{"type":"string"},"display_name":{"type":"string"},"use_case":{"type":"string"},"agent_profile":{"type":"object","properties":{"description":{"type":["null","string"]},"logo_url":{"type":["null","string"]},"banner_url":{"type":["null","string"]},"brand_color":{"type":["null","string"]},"privacy_policy_url":{"type":["null","string"]},"terms_url":{"type":["null","string"]},"phone":{"type":["null","object"],"additionalProperties":true},"website":{"type":["null","object"],"additionalProperties":true},"email":{"type":["null","object"],"additionalProperties":true}}},"brand":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["rcs_brand"]},"id":{"type":"string"},"display_name":{"type":"string"},"legal_name":{"type":"string"},"legal_entity_type":{"type":"string"},"organization_type":{"type":"string"},"website_url":{"type":"string"},"tax_id_last4":{"type":["null","string"]},"stock_symbol":{"type":["null","string"]},"address":{"type":"object","properties":{"line1":{"type":["null","string"]},"line2":{"type":["null","string"]},"city":{"type":["null","string"]},"state":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"title":{"type":["null","string"]},"email":{"type":["null","string"]},"phone":{"type":["null","string"]}}},"status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}},"launch_request":{"type":["null","object"],"additionalProperties":true},"carrier_approvals":{"type":"array","items":{"type":"object","additionalProperties":true}},"test_devices":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_test_device"]},"id":{"type":"string"},"phone_number":{"type":"string"},"invite_status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"sms_fallback_from":{"type":["null","string"]},"provider_agent_id":{"type":["null","string"]},"review_note":{"type":["null","string"]},"decline_reason":{"type":["null","string"]},"fees":{"type":"object","properties":{"setup_cents":{"type":"integer"},"us_approval_cents":{"type":"integer"},"monthly_cents":{"type":"integer"}}},"requested_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"live_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listRcsAgents","summary":"List RCS agents","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"boolean"},"in":"query","name":"include_closed","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-rcs-agents","x-feature":"telephony","x-zernio":["GET /v1/rcs/agents"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_agent"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"country":{"type":"string"},"status":{"type":"string"},"display_name":{"type":"string"},"use_case":{"type":"string"},"agent_profile":{"type":"object","properties":{"description":{"type":["null","string"]},"logo_url":{"type":["null","string"]},"banner_url":{"type":["null","string"]},"brand_color":{"type":["null","string"]},"privacy_policy_url":{"type":["null","string"]},"terms_url":{"type":["null","string"]},"phone":{"type":["null","object"],"additionalProperties":true},"website":{"type":["null","object"],"additionalProperties":true},"email":{"type":["null","object"],"additionalProperties":true}}},"brand":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["rcs_brand"]},"id":{"type":"string"},"display_name":{"type":"string"},"legal_name":{"type":"string"},"legal_entity_type":{"type":"string"},"organization_type":{"type":"string"},"website_url":{"type":"string"},"tax_id_last4":{"type":["null","string"]},"stock_symbol":{"type":["null","string"]},"address":{"type":"object","properties":{"line1":{"type":["null","string"]},"line2":{"type":["null","string"]},"city":{"type":["null","string"]},"state":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"title":{"type":["null","string"]},"email":{"type":["null","string"]},"phone":{"type":["null","string"]}}},"status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}},"launch_request":{"type":["null","object"],"additionalProperties":true},"carrier_approvals":{"type":"array","items":{"type":"object","additionalProperties":true}},"test_devices":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_test_device"]},"id":{"type":"string"},"phone_number":{"type":"string"},"invite_status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"sms_fallback_from":{"type":["null","string"]},"provider_agent_id":{"type":["null","string"]},"review_note":{"type":["null","string"]},"decline_reason":{"type":["null","string"]},"fees":{"type":"object","properties":{"setup_cents":{"type":"integer"},"us_approval_cents":{"type":"integer"},"monthly_cents":{"type":"integer"}}},"requested_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"live_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/rcs/agents/{id}":{"get":{"operationId":"getRcsAgent","summary":"Get an RCS agent","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-rcs-agent","x-feature":"telephony","x-zernio":["GET /v1/rcs/agents/{agentId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_agent"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"country":{"type":"string"},"status":{"type":"string"},"display_name":{"type":"string"},"use_case":{"type":"string"},"agent_profile":{"type":"object","properties":{"description":{"type":["null","string"]},"logo_url":{"type":["null","string"]},"banner_url":{"type":["null","string"]},"brand_color":{"type":["null","string"]},"privacy_policy_url":{"type":["null","string"]},"terms_url":{"type":["null","string"]},"phone":{"type":["null","object"],"additionalProperties":true},"website":{"type":["null","object"],"additionalProperties":true},"email":{"type":["null","object"],"additionalProperties":true}}},"brand":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["rcs_brand"]},"id":{"type":"string"},"display_name":{"type":"string"},"legal_name":{"type":"string"},"legal_entity_type":{"type":"string"},"organization_type":{"type":"string"},"website_url":{"type":"string"},"tax_id_last4":{"type":["null","string"]},"stock_symbol":{"type":["null","string"]},"address":{"type":"object","properties":{"line1":{"type":["null","string"]},"line2":{"type":["null","string"]},"city":{"type":["null","string"]},"state":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"title":{"type":["null","string"]},"email":{"type":["null","string"]},"phone":{"type":["null","string"]}}},"status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}},"launch_request":{"type":["null","object"],"additionalProperties":true},"carrier_approvals":{"type":"array","items":{"type":"object","additionalProperties":true}},"test_devices":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_test_device"]},"id":{"type":"string"},"phone_number":{"type":"string"},"invite_status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"sms_fallback_from":{"type":["null","string"]},"provider_agent_id":{"type":["null","string"]},"review_note":{"type":["null","string"]},"decline_reason":{"type":["null","string"]},"fees":{"type":"object","properties":{"setup_cents":{"type":"integer"},"us_approval_cents":{"type":"integer"},"monthly_cents":{"type":"integer"}}},"requested_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"live_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateRcsAgent","summary":"Update an RCS agent","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"display_name":{"type":"string","maxLength":40,"minLength":1},"use_case":{"type":"string","enum":["TRANSACTIONAL","PROMOTIONAL","MULTI_USE","OTP"]},"agent_profile":{"type":"object","additionalProperties":false,"required":["description","logo_url","banner_url","brand_color","privacy_policy_url","terms_url"],"properties":{"description":{"type":"string","maxLength":100,"minLength":1},"logo_url":{"type":"string","format":"uri","maxLength":2048},"banner_url":{"type":"string","format":"uri","maxLength":2048},"brand_color":{"type":"string","pattern":"^#(?:[0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$"},"privacy_policy_url":{"type":"string","format":"uri","maxLength":2048},"terms_url":{"type":"string","format":"uri","maxLength":2048},"phone":{"type":["object","null"],"additionalProperties":false,"required":["number","label"],"properties":{"number":{"type":"string","maxLength":32,"minLength":1},"label":{"type":"string","maxLength":25,"minLength":1}}},"website":{"type":["object","null"],"additionalProperties":false,"required":["url","label"],"properties":{"url":{"type":"string","format":"uri","maxLength":2048},"label":{"type":"string","maxLength":25,"minLength":1}}},"email":{"type":["object","null"],"additionalProperties":false,"required":["address","label"],"properties":{"address":{"type":"string","format":"email","maxLength":254},"label":{"type":"string","maxLength":25,"minLength":1}}}}},"brand":{"type":"object","additionalProperties":false,"required":["display_name","legal_name","legal_entity_type","organization_type","website_url","tax_id","address","contact"],"properties":{"display_name":{"type":"string","maxLength":100,"minLength":1},"legal_name":{"type":"string","maxLength":100,"minLength":1},"legal_entity_type":{"type":"string","enum":["LIMITED_LIABILITY_COMPANY","SOLE_PROPRIETORSHIP","PARTNERSHIP","CORPORATION","S_CORPORATION"]},"organization_type":{"type":"string","enum":["PRIVATE_PROFIT","PUBLIC_PROFIT","NON_PROFIT","GOVERNMENT"]},"website_url":{"type":"string","format":"uri","maxLength":2048},"tax_id":{"type":"string","maxLength":32,"minLength":1},"stock_symbol":{"type":"string","maxLength":16},"address":{"type":"object","additionalProperties":false,"required":["line1","city","postal_code","country"],"properties":{"line1":{"type":"string","maxLength":255,"minLength":1},"line2":{"type":"string","maxLength":255},"city":{"type":"string","maxLength":120,"minLength":1},"state":{"type":"string","maxLength":64},"postal_code":{"type":"string","maxLength":32,"minLength":1},"country":{"type":"string","maxLength":2,"minLength":2}}},"contact":{"type":"object","additionalProperties":false,"required":["first_name","last_name","email","phone"],"properties":{"first_name":{"type":"string","maxLength":120,"minLength":1},"last_name":{"type":"string","maxLength":120,"minLength":1},"title":{"type":"string","maxLength":120},"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string","maxLength":32,"minLength":1}}}}},"sms_fallback_from":{"type":["string","null"],"maxLength":80}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"telephony","x-mcp-tool":"update-rcs-agent","x-feature":"telephony","x-zernio":["PATCH /v1/rcs/agents/{agentId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_agent"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"country":{"type":"string"},"status":{"type":"string"},"display_name":{"type":"string"},"use_case":{"type":"string"},"agent_profile":{"type":"object","properties":{"description":{"type":["null","string"]},"logo_url":{"type":["null","string"]},"banner_url":{"type":["null","string"]},"brand_color":{"type":["null","string"]},"privacy_policy_url":{"type":["null","string"]},"terms_url":{"type":["null","string"]},"phone":{"type":["null","object"],"additionalProperties":true},"website":{"type":["null","object"],"additionalProperties":true},"email":{"type":["null","object"],"additionalProperties":true}}},"brand":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["rcs_brand"]},"id":{"type":"string"},"display_name":{"type":"string"},"legal_name":{"type":"string"},"legal_entity_type":{"type":"string"},"organization_type":{"type":"string"},"website_url":{"type":"string"},"tax_id_last4":{"type":["null","string"]},"stock_symbol":{"type":["null","string"]},"address":{"type":"object","properties":{"line1":{"type":["null","string"]},"line2":{"type":["null","string"]},"city":{"type":["null","string"]},"state":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"title":{"type":["null","string"]},"email":{"type":["null","string"]},"phone":{"type":["null","string"]}}},"status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}},"launch_request":{"type":["null","object"],"additionalProperties":true},"carrier_approvals":{"type":"array","items":{"type":"object","additionalProperties":true}},"test_devices":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_test_device"]},"id":{"type":"string"},"phone_number":{"type":"string"},"invite_status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"sms_fallback_from":{"type":["null","string"]},"provider_agent_id":{"type":["null","string"]},"review_note":{"type":["null","string"]},"decline_reason":{"type":["null","string"]},"fees":{"type":"object","properties":{"setup_cents":{"type":"integer"},"us_approval_cents":{"type":"integer"},"monthly_cents":{"type":"integer"}}},"requested_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"live_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deactivateRcsAgent","summary":"Deactivate an RCS agent","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"destructive","x-toolset":"telephony","x-mcp-tool":"deactivate-rcs-agent","x-feature":"telephony","x-zernio":["DELETE /v1/rcs/agents/{agentId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_agent"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"country":{"type":"string"},"status":{"type":"string"},"display_name":{"type":"string"},"use_case":{"type":"string"},"agent_profile":{"type":"object","properties":{"description":{"type":["null","string"]},"logo_url":{"type":["null","string"]},"banner_url":{"type":["null","string"]},"brand_color":{"type":["null","string"]},"privacy_policy_url":{"type":["null","string"]},"terms_url":{"type":["null","string"]},"phone":{"type":["null","object"],"additionalProperties":true},"website":{"type":["null","object"],"additionalProperties":true},"email":{"type":["null","object"],"additionalProperties":true}}},"brand":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["rcs_brand"]},"id":{"type":"string"},"display_name":{"type":"string"},"legal_name":{"type":"string"},"legal_entity_type":{"type":"string"},"organization_type":{"type":"string"},"website_url":{"type":"string"},"tax_id_last4":{"type":["null","string"]},"stock_symbol":{"type":["null","string"]},"address":{"type":"object","properties":{"line1":{"type":["null","string"]},"line2":{"type":["null","string"]},"city":{"type":["null","string"]},"state":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"title":{"type":["null","string"]},"email":{"type":["null","string"]},"phone":{"type":["null","string"]}}},"status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}},"launch_request":{"type":["null","object"],"additionalProperties":true},"carrier_approvals":{"type":"array","items":{"type":"object","additionalProperties":true}},"test_devices":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_test_device"]},"id":{"type":"string"},"phone_number":{"type":"string"},"invite_status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"sms_fallback_from":{"type":["null","string"]},"provider_agent_id":{"type":["null","string"]},"review_note":{"type":["null","string"]},"decline_reason":{"type":["null","string"]},"fees":{"type":"object","properties":{"setup_cents":{"type":"integer"},"us_approval_cents":{"type":"integer"},"monthly_cents":{"type":"integer"}}},"requested_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"live_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/rcs/agents/{id}/launch-request":{"post":{"operationId":"sendRcsLaunchRequest","summary":"Send the launch filing","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"company_overview":{"type":"string","maxLength":2000,"minLength":1},"agent_overview":{"type":"string","maxLength":2000,"minLength":1},"interactions":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"object","additionalProperties":false,"required":["type"],"properties":{"type":{"type":"string","enum":["TRANSACTIONAL_UPDATES","CUSTOMER_SUPPORT","LOYALTY_OR_REWARD","MARKETING_OR_PROMOTIONAL","ACCOUNT_ALERTS","TWO_WAY_CONVERSATION","OTHER"]},"description":{"type":"string","maxLength":1000}}}},"message_examples":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","maxLength":1000,"minLength":1}},"consent":{"type":"object","additionalProperties":false,"required":["opt_in_methods","call_to_action","double_opt_in","opt_in_message","help_response","opt_out_response"],"properties":{"opt_in_methods":{"type":"array","minItems":1,"maxItems":6,"items":{"type":"object","additionalProperties":false,"required":["type"],"properties":{"type":{"type":"string","enum":["SMS","WEBSITE","MOBILE_APP","QR_CODE","SALE_POINT","OTHER"]},"description":{"type":"string","maxLength":1000}}}},"call_to_action":{"type":"string","maxLength":1000,"minLength":1},"call_to_action_url":{"type":"string","format":"uri","maxLength":2048},"call_to_action_media_url":{"type":"string","format":"uri","maxLength":2048},"double_opt_in":{"type":"boolean"},"double_opt_in_message":{"type":"string","maxLength":1000},"opt_in_message":{"type":"string","maxLength":1000,"minLength":1},"help_response":{"type":"string","maxLength":1000,"minLength":1},"opt_out_response":{"type":"string","maxLength":1000,"minLength":1}}},"test_video_url":{"type":"string","format":"uri","maxLength":2048},"additional_information":{"type":"string","maxLength":2000}},"required":["company_overview","agent_overview","interactions","message_examples","consent","test_video_url"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"send-rcs-launch-request","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/rcs/agents/{agentId}/launch-request"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_agent"]},"id":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"country":{"type":"string"},"status":{"type":"string"},"display_name":{"type":"string"},"use_case":{"type":"string"},"agent_profile":{"type":"object","properties":{"description":{"type":["null","string"]},"logo_url":{"type":["null","string"]},"banner_url":{"type":["null","string"]},"brand_color":{"type":["null","string"]},"privacy_policy_url":{"type":["null","string"]},"terms_url":{"type":["null","string"]},"phone":{"type":["null","object"],"additionalProperties":true},"website":{"type":["null","object"],"additionalProperties":true},"email":{"type":["null","object"],"additionalProperties":true}}},"brand":{"type":["null","object"],"properties":{"object":{"type":"string","enum":["rcs_brand"]},"id":{"type":"string"},"display_name":{"type":"string"},"legal_name":{"type":"string"},"legal_entity_type":{"type":"string"},"organization_type":{"type":"string"},"website_url":{"type":"string"},"tax_id_last4":{"type":["null","string"]},"stock_symbol":{"type":["null","string"]},"address":{"type":"object","properties":{"line1":{"type":["null","string"]},"line2":{"type":["null","string"]},"city":{"type":["null","string"]},"state":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"title":{"type":["null","string"]},"email":{"type":["null","string"]},"phone":{"type":["null","string"]}}},"status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}},"launch_request":{"type":["null","object"],"additionalProperties":true},"carrier_approvals":{"type":"array","items":{"type":"object","additionalProperties":true}},"test_devices":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_test_device"]},"id":{"type":"string"},"phone_number":{"type":"string"},"invite_status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"sms_fallback_from":{"type":["null","string"]},"provider_agent_id":{"type":["null","string"]},"review_note":{"type":["null","string"]},"decline_reason":{"type":["null","string"]},"fees":{"type":"object","properties":{"setup_cents":{"type":"integer"},"us_approval_cents":{"type":"integer"},"monthly_cents":{"type":"integer"}}},"requested_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"live_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/rcs/agents/{id}/test-devices":{"get":{"operationId":"listRcsTestDevices","summary":"List RCS test phones","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-rcs-test-devices","x-feature":"telephony","x-zernio":["GET /v1/rcs/agents/{agentId}/test-devices"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_test_device"]},"id":{"type":"string"},"phone_number":{"type":"string"},"invite_status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"addRcsTestDevice","summary":"Invite an RCS test phone","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phone_number":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"}},"required":["phone_number"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"add-rcs-test-device","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/rcs/agents/{agentId}/test-devices"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_test_device"]},"id":{"type":"string"},"phone_number":{"type":"string"},"invite_status":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/rcs/agents/{id}/test-devices/{deviceId}":{"delete":{"operationId":"removeRcsTestDevice","summary":"Remove an RCS test phone","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"deviceId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"remove-rcs-test-device","x-feature":"telephony","x-zernio":["DELETE /v1/rcs/agents/{agentId}/test-devices/{testDeviceId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_test_device"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/rcs/assets":{"post":{"operationId":"uploadRcsAsset","summary":"Upload an RCS logo or banner","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["logo","banner"]},"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"},"mime_type":{"type":"string","maxLength":100}},"required":["kind","filename","content_base64"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"upload-rcs-asset","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/rcs/assets"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_asset"]},"kind":{"type":"string"},"url":{"type":"string"},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"mime_type":{"type":"string"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/rcs/messages":{"post":{"operationId":"sendRcsMessage","summary":"Send an RCS message","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"agent_id":{"type":"string","maxLength":80,"minLength":1},"to":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"},"text":{"type":"string","maxLength":3072},"content":{"type":"object","additionalProperties":true,"required":["type"],"properties":{"type":{"type":"string","enum":["text","media","card","carousel"]}}},"fallback_text":{"type":"string","maxLength":1600},"ttl_seconds":{"type":"integer","minimum":60,"maximum":2592000}},"required":["agent_id","to"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"telephony","x-mcp-tool":"send-rcs-message","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/rcs/messages"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_message"]},"id":{"type":"string"},"agent_id":{"type":["null","string"]},"direction":{"type":"string"},"to":{"type":["null","string"]},"from":{"type":["null","string"]},"status":{"type":"string"},"conversation_id":{"type":["null","string"]},"message_id":{"type":["null","string"]},"provider_message_id":{"type":["null","string"]},"fallback_sms_id":{"type":["null","string"]},"content":{"type":"object","additionalProperties":true},"text":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","additionalProperties":true}},"cost_usd":{"type":["null","number"]},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"read_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/rcs/capabilities":{"get":{"operationId":"checkRcsCapabilities","summary":"Check RCS capability","tags":["Telephony"],"parameters":[{"schema":{"type":"string","maxLength":80,"minLength":1},"in":"query","name":"agent_id","required":true},{"schema":{"type":"string","maxLength":2000,"minLength":3},"in":"query","name":"numbers","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"check-rcs-capabilities","x-feature":"telephony","x-zernio":["GET /v1/rcs/capabilities"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["rcs_capability"]},"phone_number":{"type":"string"},"rcs_capable":{"type":"boolean"},"features":{"type":"array","items":{"type":"string"}}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/imessage/senders":{"get":{"operationId":"listImessageSenders","summary":"List iMessage senders","tags":["Telephony"],"description":"Registered and ordered senders (origin=order lists sender orders).","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["order","registered"]},"in":"query","name":"origin","required":false},{"schema":{"type":"boolean"},"in":"query","name":"include_canceled","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-imessage-senders","x-feature":"telephony","x-zernio":["GET /v1/imessage/senders","GET /v1/imessage/senders/order"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_sender"]},"id":{"type":"string"},"origin":{"type":"string"},"kind":{"type":"string"},"region":{"type":["null","string"]},"handle":{"type":["null","string"]},"display_name":{"type":["null","string"]},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"photo_url":{"type":["null","string"]}}},"status":{"type":"string"},"provider":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"opt_in_link":{"type":["null","string"]},"imessage_link":{"type":["null","string"]},"sender_verified":{"type":"boolean"},"is_active":{"type":"boolean"},"price_cents":{"type":"integer"},"failure_reason":{"type":["null","string"]},"health":{"type":"object","properties":{"imessage":{"type":"string"}}},"warmup":{"type":"object","properties":{"day":{"type":"integer"},"daily_new_conversations_cap":{"type":"integer"},"new_conversations_today":{"type":"integer"},"unique_contacts_today":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"canceled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"registerImessageSender","summary":"Register an iMessage sender","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"profile_id":{"type":"string","maxLength":80,"minLength":1},"sender":{"type":"string","maxLength":255,"minLength":3},"display_name":{"type":"string","maxLength":80},"provider":{"type":"string","enum":["loopmessage"]},"api_credentials":{"type":"object","additionalProperties":false,"required":["authorization_key"],"properties":{"authorization_key":{"type":"string","maxLength":255,"minLength":1},"secret_key":{"type":"string","maxLength":255}}}},"required":["profile_id","sender"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"register-imessage-sender","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/imessage/senders"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_sender"]},"id":{"type":"string"},"origin":{"type":"string"},"kind":{"type":"string"},"region":{"type":["null","string"]},"handle":{"type":["null","string"]},"display_name":{"type":["null","string"]},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"photo_url":{"type":["null","string"]}}},"status":{"type":"string"},"provider":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"opt_in_link":{"type":["null","string"]},"imessage_link":{"type":["null","string"]},"sender_verified":{"type":"boolean"},"is_active":{"type":"boolean"},"price_cents":{"type":"integer"},"failure_reason":{"type":["null","string"]},"health":{"type":"object","properties":{"imessage":{"type":"string"}}},"warmup":{"type":"object","properties":{"day":{"type":"integer"},"daily_new_conversations_cap":{"type":"integer"},"new_conversations_today":{"type":"integer"},"unique_contacts_today":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"canceled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/imessage/senders/orders":{"post":{"operationId":"orderImessageSender","summary":"Order a new iMessage sender","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"profile_id":{"type":"string","maxLength":80,"minLength":1},"kind":{"type":"string","enum":["phone","email"]},"region":{"type":"string","enum":["US","GB"]},"available_number_id":{"type":"string","maxLength":80},"zip_code":{"type":"string","maxLength":10},"email_name":{"type":"string","pattern":"^[a-z0-9._-]{2,40}$"},"email_domain":{"type":"string","maxLength":120},"display_name":{"type":"string","maxLength":80},"purchase_intent_id":{"type":"string","maxLength":100},"contact":{"type":"object","additionalProperties":false,"required":["first_name"],"properties":{"first_name":{"type":"string","maxLength":80,"minLength":1},"last_name":{"type":"string","maxLength":80},"photo_url":{"type":"string","format":"uri","maxLength":2048}}}},"required":["profile_id","kind"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"order-imessage-sender","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/imessage/senders/order"],"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_sender"]},"id":{"type":"string"},"origin":{"type":"string"},"kind":{"type":"string"},"region":{"type":["null","string"]},"handle":{"type":["null","string"]},"display_name":{"type":["null","string"]},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"photo_url":{"type":["null","string"]}}},"status":{"type":"string"},"provider":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"opt_in_link":{"type":["null","string"]},"imessage_link":{"type":["null","string"]},"sender_verified":{"type":"boolean"},"is_active":{"type":"boolean"},"price_cents":{"type":"integer"},"failure_reason":{"type":["null","string"]},"health":{"type":"object","properties":{"imessage":{"type":"string"}}},"warmup":{"type":"object","properties":{"day":{"type":"integer"},"daily_new_conversations_cap":{"type":"integer"},"new_conversations_today":{"type":"integer"},"unique_contacts_today":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"canceled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/imessage/available-numbers":{"get":{"operationId":"listImessageAvailableNumbers","summary":"List instantly available iMessage numbers","tags":["Telephony"],"parameters":[{"schema":{"type":"string","enum":["US","GB"]},"in":"query","name":"region","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-imessage-available-numbers","x-feature":"telephony","x-zernio":["GET /v1/imessage/senders/available-numbers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_available_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"region":{"type":["null","string"]},"location":{"type":["null","string"]}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/imessage/available-numbers/{numberId}/reserve":{"post":{"operationId":"reserveImessageAvailableNumber","summary":"Reserve an available iMessage number","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"numberId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"reserve-imessage-available-number","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/imessage/senders/available-numbers/{numberId}/reserve"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_number_reservation"]},"number_id":{"type":"string"},"expires_at":{"type":["null","string"],"format":"date-time"},"expires_in_seconds":{"type":"integer"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/imessage/senders/{id}":{"get":{"operationId":"getImessageSender","summary":"Get iMessage sender status","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-imessage-sender","x-feature":"telephony","x-zernio":["GET /v1/imessage/senders/{senderId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_sender"]},"id":{"type":"string"},"origin":{"type":"string"},"kind":{"type":"string"},"region":{"type":["null","string"]},"handle":{"type":["null","string"]},"display_name":{"type":["null","string"]},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"photo_url":{"type":["null","string"]}}},"status":{"type":"string"},"provider":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"opt_in_link":{"type":["null","string"]},"imessage_link":{"type":["null","string"]},"sender_verified":{"type":"boolean"},"is_active":{"type":"boolean"},"price_cents":{"type":"integer"},"failure_reason":{"type":["null","string"]},"health":{"type":"object","properties":{"imessage":{"type":"string"}}},"warmup":{"type":"object","properties":{"day":{"type":"integer"},"daily_new_conversations_cap":{"type":"integer"},"new_conversations_today":{"type":"integer"},"unique_contacts_today":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"canceled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateImessageSender","summary":"Update an iMessage sender","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"display_name":{"type":"string","maxLength":80},"contact":{"type":"object","additionalProperties":false,"required":["first_name"],"properties":{"first_name":{"type":"string","maxLength":80,"minLength":1},"last_name":{"type":"string","maxLength":80},"photo_url":{"type":"string","format":"uri","maxLength":2048}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"telephony","x-mcp-tool":"update-imessage-sender","x-feature":"telephony","x-zernio":["PATCH /v1/imessage/senders/{senderId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_sender"]},"id":{"type":"string"},"origin":{"type":"string"},"kind":{"type":"string"},"region":{"type":["null","string"]},"handle":{"type":["null","string"]},"display_name":{"type":["null","string"]},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"photo_url":{"type":["null","string"]}}},"status":{"type":"string"},"provider":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"opt_in_link":{"type":["null","string"]},"imessage_link":{"type":["null","string"]},"sender_verified":{"type":"boolean"},"is_active":{"type":"boolean"},"price_cents":{"type":"integer"},"failure_reason":{"type":["null","string"]},"health":{"type":"object","properties":{"imessage":{"type":"string"}}},"warmup":{"type":"object","properties":{"day":{"type":"integer"},"daily_new_conversations_cap":{"type":"integer"},"new_conversations_today":{"type":"integer"},"unique_contacts_today":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"canceled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"cancelImessageSender","summary":"Cancel an iMessage sender","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"destructive","x-toolset":"telephony","x-mcp-tool":"cancel-imessage-sender","x-feature":"telephony","x-zernio":["DELETE /v1/imessage/senders/{senderId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_sender"]},"id":{"type":"string"},"origin":{"type":"string"},"kind":{"type":"string"},"region":{"type":["null","string"]},"handle":{"type":["null","string"]},"display_name":{"type":["null","string"]},"contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"photo_url":{"type":["null","string"]}}},"status":{"type":"string"},"provider":{"type":"string"},"profile_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"opt_in_link":{"type":["null","string"]},"imessage_link":{"type":["null","string"]},"sender_verified":{"type":"boolean"},"is_active":{"type":"boolean"},"price_cents":{"type":"integer"},"failure_reason":{"type":["null","string"]},"health":{"type":"object","properties":{"imessage":{"type":"string"}}},"warmup":{"type":"object","properties":{"day":{"type":"integer"},"daily_new_conversations_cap":{"type":"integer"},"new_conversations_today":{"type":"integer"},"unique_contacts_today":{"type":"integer"}}},"activated_at":{"type":["null","string"],"format":"date-time"},"canceled_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/imessage/senders/{id}/opt-in-links":{"post":{"operationId":"createImessageOptInLink","summary":"Create a tracked iMessage opt-in link","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"string","maxLength":300,"minLength":1},"parameters":{"type":"object","additionalProperties":{"type":["string","number","boolean"]},"maxProperties":10},"opt_in_code":{"type":"string","pattern":"^[A-Za-z0-9]{3,8}$"}},"required":["body"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-imessage-opt-in-link","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/imessage/senders/{senderId}/opt-in-links"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_opt_in_link"]},"id":{"type":"string"},"sender_id":{"type":["null","string"]},"url":{"type":["null","string"]},"imessage":{"type":["null","string"]},"sms":{"type":["null","string"]},"body":{"type":"string"},"parameters":{"type":"object","additionalProperties":true},"opt_in_code":{"type":["null","string"]},"clicks":{"type":"integer"},"opt_ins":{"type":"integer"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/imessage/messages":{"post":{"operationId":"sendImessage","summary":"Send an iMessage","tags":["Telephony"],"description":"Cold-outreach guardrails: no links / emails / phones / prices / files in a first message, ≤2 follow-ups 24 h apart, one new conversation per 15 min, warm-up caps.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"sender_id":{"type":"string","maxLength":80},"account_id":{"type":"string","maxLength":80},"to":{"type":"string","maxLength":255,"minLength":3},"text":{"type":"string","maxLength":10000},"media_urls":{"type":"array","maxItems":10,"items":{"type":"string","format":"uri","maxLength":2048}},"subject":{"type":"string","maxLength":120},"effect":{"type":"string","maxLength":32},"reply_to_id":{"type":"string","maxLength":120},"fallback":{"type":"string","enum":["sms","none"]}},"required":["to"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"telephony","x-mcp-tool":"send-imessage","x-idempotent":true,"x-feature":"telephony","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_message"]},"id":{"type":"string"},"sender_id":{"type":["null","string"]},"account_id":{"type":["null","string"]},"to":{"type":"string"},"conversation_id":{"type":["null","string"]},"message_id":{"type":["null","string"]},"status":{"type":"string"},"text":{"type":["null","string"]},"media_urls":{"type":"array","items":{"type":"string"}},"subject":{"type":["null","string"]},"effect":{"type":["null","string"]},"provider_message_id":{"type":["null","string"]},"errors":{"type":"array","items":{"type":"object","additionalProperties":true}},"sent_at":{"type":["null","string"],"format":"date-time"},"delivered_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/imessage/audience":{"get":{"operationId":"listImessageAudience","summary":"List iMessage audience","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string","enum":["subscribed","unsubscribed"]},"in":"query","name":"status","required":false},{"schema":{"type":"string","maxLength":120},"in":"query","name":"search","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-imessage-audience","x-feature":"telephony","x-zernio":["GET /v1/imessage/audience"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_audience_member"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"contact":{"type":"string"},"contact_id":{"type":["null","string"]},"name":{"type":["null","string"]},"subscribed":{"type":"boolean"},"last_message":{"type":["null","string"]},"last_message_at":{"type":["null","string"],"format":"date-time"},"first_seen_at":{"type":["null","string"],"format":"date-time"},"opt_in":{"type":["null","object"],"properties":{"at":{"type":["null","string"],"format":"date-time"},"link_id":{"type":["null","string"]},"parameters":{"type":"object","additionalProperties":true}}},"opted_out_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/imessage/audience/subscription":{"post":{"operationId":"setImessageSubscription","summary":"Subscribe or opt out an iMessage contact","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string","maxLength":80,"minLength":1},"conversation_id":{"type":"string","maxLength":80,"minLength":1},"subscribed":{"type":"boolean"}},"required":["account_id","conversation_id","subscribed"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"set-imessage-subscription","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/imessage/audience/subscription"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_audience_member"]},"id":{"type":"string"},"account_id":{"type":["null","string"]},"conversation_id":{"type":["null","string"]},"contact":{"type":"string"},"contact_id":{"type":["null","string"]},"name":{"type":["null","string"]},"subscribed":{"type":"boolean"},"last_message":{"type":["null","string"]},"last_message_at":{"type":["null","string"],"format":"date-time"},"first_seen_at":{"type":["null","string"],"format":"date-time"},"opt_in":{"type":["null","object"],"properties":{"at":{"type":["null","string"],"format":"date-time"},"link_id":{"type":["null","string"]},"parameters":{"type":"object","additionalProperties":true}}},"opted_out_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/imessage/sandbox/contacts":{"get":{"operationId":"getImessageSandbox","summary":"List iMessage sandbox contacts","tags":["Telephony"],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-imessage-sandbox","x-zernio":["GET /v1/imessage/sandbox/contacts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_sandbox"]},"account_id":{"type":["null","string"]},"handle":{"type":["null","string"]},"contact_limit":{"type":"integer"},"contacts":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_sandbox_contact"]},"id":{"type":"string"},"handle":{"type":"string"},"status":{"type":"string"},"join_text":{"type":"string"},"join_link":{"type":["null","string"]},"activated_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"addImessageSandboxContact","summary":"Add an iMessage sandbox contact","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"handle":{"type":"string","maxLength":255,"minLength":3}},"required":["handle"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"add-imessage-sandbox-contact","x-idempotent":true,"x-zernio":["POST /v1/imessage/sandbox/contacts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_sandbox_contact"]},"id":{"type":"string"},"handle":{"type":"string"},"status":{"type":"string"},"join_text":{"type":"string"},"join_link":{"type":["null","string"]},"activated_at":{"type":["null","string"],"format":"date-time"},"last_inbound_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/imessage/sandbox/contacts/{id}":{"delete":{"operationId":"removeImessageSandboxContact","summary":"Remove an iMessage sandbox contact","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"remove-imessage-sandbox-contact","x-zernio":["DELETE /v1/imessage/sandbox/contacts/{contactId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_sandbox_contact"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/imessage/groups":{"post":{"operationId":"createImessageGroup","summary":"Start an iMessage group chat","tags":["Telephony"],"description":"Not offered by the current iMessage provider over its API (422 not_supported); groups a contact creates appear in the inbox.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string","maxLength":80,"minLength":1},"contacts":{"type":"array","minItems":2,"maxItems":20,"items":{"type":"string","maxLength":255,"minLength":3}},"text":{"type":"string","maxLength":10000,"minLength":1},"name":{"type":"string","maxLength":80},"channel":{"type":"string","enum":["imessage","sms","rcs"]}},"required":["account_id","contacts","text"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"telephony","x-mcp-tool":"create-imessage-group","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/imessage/groups"],"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_group"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"status":{"type":"string"},"name":{"type":["null","string"]},"photo_url":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"string"}},"channel":{"type":"string"},"provider_group_id":{"type":["null","string"]},"request_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/imessage/groups/{conversationId}":{"get":{"operationId":"getImessageGroup","summary":"Get an iMessage group","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"conversationId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-imessage-group","x-feature":"telephony","x-zernio":["GET /v1/imessage/groups/{conversationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_group"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"status":{"type":"string"},"name":{"type":["null","string"]},"photo_url":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"string"}},"channel":{"type":"string"},"provider_group_id":{"type":["null","string"]},"request_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateImessageGroup","summary":"Rename an iMessage group or change its photo","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":80},"photo_url":{"type":"string","format":"uri","maxLength":2048}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"conversationId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"telephony","x-mcp-tool":"update-imessage-group","x-feature":"telephony","x-zernio":["PATCH /v1/imessage/groups/{conversationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_group"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"status":{"type":"string"},"name":{"type":["null","string"]},"photo_url":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"string"}},"channel":{"type":"string"},"provider_group_id":{"type":["null","string"]},"request_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/imessage/groups/{conversationId}/participants":{"post":{"operationId":"addImessageGroupParticipant","summary":"Add a participant to an iMessage group","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"contact":{"type":"string","maxLength":255,"minLength":3}},"required":["contact"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"conversationId","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"add-imessage-group-participant","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/imessage/groups/{conversationId}/participants"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_group"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"status":{"type":"string"},"name":{"type":["null","string"]},"photo_url":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"string"}},"channel":{"type":"string"},"provider_group_id":{"type":["null","string"]},"request_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"removeImessageGroupParticipant","summary":"Remove a participant from an iMessage group","tags":["Telephony"],"parameters":[{"schema":{"type":"string","maxLength":255,"minLength":3},"in":"query","name":"contact","required":true},{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"conversationId","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"remove-imessage-group-participant","x-feature":"telephony","x-zernio":["DELETE /v1/imessage/groups/{conversationId}/participants"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["imessage_group"]},"id":{"type":"string"},"conversation_id":{"type":"string"},"account_id":{"type":["null","string"]},"status":{"type":"string"},"name":{"type":["null","string"]},"photo_url":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"string"}},"channel":{"type":"string"},"provider_group_id":{"type":["null","string"]},"request_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/branded-calling/enterprises":{"post":{"operationId":"createBrandedEnterprise","summary":"Register a business for Branded Calling","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"legal_name":{"type":"string","maxLength":255,"minLength":1},"doing_business_as":{"type":"string","maxLength":255,"minLength":1},"organization_type":{"type":"string","enum":["commercial","government","non_profit"]},"organization_legal_type":{"type":"string","enum":["corporation","llc","partnership","nonprofit","other"]},"country_code":{"type":"string","enum":["US","CA"]},"jurisdiction_of_incorporation":{"type":"string","maxLength":64,"minLength":1},"website":{"type":"string","format":"uri","maxLength":2048},"fein":{"type":"string","maxLength":32,"minLength":1},"industry":{"type":"string","maxLength":120,"minLength":1},"number_of_employees":{"type":"string","enum":["1-10","11-50","51-200","201-500","501-2000","2001-10000","10001+"]},"organization_contact":{"type":"object","additionalProperties":false,"required":["first_name","last_name","email","phone_number"],"properties":{"first_name":{"type":"string","maxLength":120,"minLength":1},"last_name":{"type":"string","maxLength":120,"minLength":1},"email":{"type":"string","format":"email","maxLength":254},"job_title":{"type":"string","maxLength":120},"phone_number":{"type":"string","maxLength":32,"minLength":1}}},"billing_contact":{"type":"object","additionalProperties":false,"required":["first_name","last_name","email","phone_number"],"properties":{"first_name":{"type":"string","maxLength":120,"minLength":1},"last_name":{"type":"string","maxLength":120,"minLength":1},"email":{"type":"string","format":"email","maxLength":254},"job_title":{"type":"string","maxLength":120},"phone_number":{"type":"string","maxLength":32,"minLength":1}}},"physical_address":{"type":"object","additionalProperties":false,"required":["street_address","city","administrative_area","postal_code","country"],"properties":{"street_address":{"type":"string","maxLength":255,"minLength":1},"extended_address":{"type":"string","maxLength":255},"city":{"type":"string","maxLength":120,"minLength":1},"administrative_area":{"type":"string","maxLength":64,"minLength":1},"postal_code":{"type":"string","maxLength":32,"minLength":1},"country":{"type":"string","maxLength":2,"minLength":2}}},"billing_address":{"type":"object","additionalProperties":false,"required":["street_address","city","administrative_area","postal_code","country"],"properties":{"street_address":{"type":"string","maxLength":255,"minLength":1},"extended_address":{"type":"string","maxLength":255},"city":{"type":"string","maxLength":120,"minLength":1},"administrative_area":{"type":"string","maxLength":64,"minLength":1},"postal_code":{"type":"string","maxLength":32,"minLength":1},"country":{"type":"string","maxLength":2,"minLength":2}}}},"required":["legal_name","doing_business_as","organization_type","organization_legal_type","country_code","jurisdiction_of_incorporation","website","fein","industry","number_of_employees","organization_contact","billing_contact","physical_address","billing_address"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-branded-enterprise","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/branded-calling/enterprises"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_enterprise"]},"id":{"type":"string"},"legal_name":{"type":"string"},"doing_business_as":{"type":"string"},"organization_type":{"type":"string"},"organization_legal_type":{"type":"string"},"country_code":{"type":"string"},"jurisdiction_of_incorporation":{"type":["null","string"]},"website":{"type":["null","string"]},"fein_last4":{"type":["null","string"]},"industry":{"type":["null","string"]},"number_of_employees":{"type":["null","string"]},"organization_contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"email":{"type":["null","string"]},"job_title":{"type":["null","string"]},"phone_number":{"type":["null","string"]}}},"billing_contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"email":{"type":["null","string"]},"job_title":{"type":["null","string"]},"phone_number":{"type":["null","string"]}}},"physical_address":{"type":"object","properties":{"street_address":{"type":["null","string"]},"extended_address":{"type":["null","string"]},"city":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"billing_address":{"type":"object","properties":{"street_address":{"type":["null","string"]},"extended_address":{"type":["null","string"]},"city":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"registered":{"type":"boolean"},"provider_enterprise_id":{"type":["null","string"]},"identities_count":{"type":"integer"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listBrandedEnterprises","summary":"List registered businesses","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-branded-enterprises","x-feature":"telephony","x-zernio":["GET /v1/branded-calling/enterprises"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["branded_enterprise"]},"id":{"type":"string"},"legal_name":{"type":"string"},"doing_business_as":{"type":"string"},"organization_type":{"type":"string"},"organization_legal_type":{"type":"string"},"country_code":{"type":"string"},"jurisdiction_of_incorporation":{"type":["null","string"]},"website":{"type":["null","string"]},"fein_last4":{"type":["null","string"]},"industry":{"type":["null","string"]},"number_of_employees":{"type":["null","string"]},"organization_contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"email":{"type":["null","string"]},"job_title":{"type":["null","string"]},"phone_number":{"type":["null","string"]}}},"billing_contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"email":{"type":["null","string"]},"job_title":{"type":["null","string"]},"phone_number":{"type":["null","string"]}}},"physical_address":{"type":"object","properties":{"street_address":{"type":["null","string"]},"extended_address":{"type":["null","string"]},"city":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"billing_address":{"type":"object","properties":{"street_address":{"type":["null","string"]},"extended_address":{"type":["null","string"]},"city":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"registered":{"type":"boolean"},"provider_enterprise_id":{"type":["null","string"]},"identities_count":{"type":"integer"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/branded-calling/enterprises/{id}":{"get":{"operationId":"getBrandedEnterprise","summary":"Get a registered business","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-branded-enterprise","x-feature":"telephony","x-zernio":["GET /v1/branded-calling/enterprises/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_enterprise"]},"id":{"type":"string"},"legal_name":{"type":"string"},"doing_business_as":{"type":"string"},"organization_type":{"type":"string"},"organization_legal_type":{"type":"string"},"country_code":{"type":"string"},"jurisdiction_of_incorporation":{"type":["null","string"]},"website":{"type":["null","string"]},"fein_last4":{"type":["null","string"]},"industry":{"type":["null","string"]},"number_of_employees":{"type":["null","string"]},"organization_contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"email":{"type":["null","string"]},"job_title":{"type":["null","string"]},"phone_number":{"type":["null","string"]}}},"billing_contact":{"type":"object","properties":{"first_name":{"type":["null","string"]},"last_name":{"type":["null","string"]},"email":{"type":["null","string"]},"job_title":{"type":["null","string"]},"phone_number":{"type":["null","string"]}}},"physical_address":{"type":"object","properties":{"street_address":{"type":["null","string"]},"extended_address":{"type":["null","string"]},"city":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"billing_address":{"type":"object","properties":{"street_address":{"type":["null","string"]},"extended_address":{"type":["null","string"]},"city":{"type":["null","string"]},"administrative_area":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"registered":{"type":"boolean"},"provider_enterprise_id":{"type":["null","string"]},"identities_count":{"type":"integer"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteBrandedEnterprise","summary":"Delete a registered business","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"delete-branded-enterprise","x-feature":"telephony","x-zernio":["DELETE /v1/branded-calling/enterprises/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_enterprise"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/branded-calling/call-reasons":{"get":{"operationId":"listBrandedCallReasons","summary":"List pre-approved call reasons","tags":["Telephony"],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-branded-call-reasons","x-feature":"telephony","x-zernio":["GET /v1/branded-calling/call-reasons"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["call_reason"]},"reason":{"type":"string"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/branded-calling/identities/preflight":{"post":{"operationId":"preflightBrandedIdentity","summary":"Dry-run a caller identity before creating it","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"enterprise_id":{"type":"string","maxLength":80,"minLength":1},"display_name":{"type":"string","maxLength":35,"minLength":1},"call_reasons":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","maxLength":64,"minLength":1}},"logo_url":{"type":"string","maxLength":128,"pattern":"^https://"},"authorizer":{"type":"object","additionalProperties":false,"required":["name","email"],"properties":{"name":{"type":"string","maxLength":255,"minLength":1},"email":{"type":"string","format":"email","maxLength":254}}},"references":{"type":"object","additionalProperties":false,"required":["business","financial"],"properties":{"business":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"object","additionalProperties":false,"required":["full_name","phone_number","email","timezone"],"properties":{"full_name":{"type":"string","maxLength":255,"minLength":1},"job_title":{"type":"string","maxLength":120},"organization":{"type":"string","maxLength":255},"relationship_to_registrant":{"type":"string","maxLength":255},"phone_number":{"type":"string","maxLength":32,"minLength":1},"email":{"type":"string","format":"email","maxLength":254},"timezone":{"type":"string","maxLength":64,"minLength":1}}}},"financial":{"type":"object","additionalProperties":false,"required":["full_name","phone_number","email","timezone"],"properties":{"full_name":{"type":"string","maxLength":255,"minLength":1},"job_title":{"type":"string","maxLength":120},"organization":{"type":"string","maxLength":255},"relationship_to_registrant":{"type":"string","maxLength":255},"phone_number":{"type":"string","maxLength":32,"minLength":1},"email":{"type":"string","format":"email","maxLength":254},"timezone":{"type":"string","maxLength":64,"minLength":1}}}}}},"required":["enterprise_id","display_name","call_reasons","authorizer","references"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"preflight-branded-identity","x-feature":"telephony","x-zernio":["POST /v1/branded-calling/identities/preflight"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_identity_preflight"]},"ok":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"severity":{"type":"string"},"field":{"type":["null","string"]},"message":{"type":"string"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/branded-calling/identities":{"post":{"operationId":"createBrandedIdentity","summary":"Create a caller identity","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"enterprise_id":{"type":"string","maxLength":80,"minLength":1},"display_name":{"type":"string","maxLength":35,"minLength":1},"call_reasons":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","maxLength":64,"minLength":1}},"logo_url":{"type":"string","maxLength":128,"pattern":"^https://"},"authorizer":{"type":"object","additionalProperties":false,"required":["name","email"],"properties":{"name":{"type":"string","maxLength":255,"minLength":1},"email":{"type":"string","format":"email","maxLength":254}}},"references":{"type":"object","additionalProperties":false,"required":["business","financial"],"properties":{"business":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"object","additionalProperties":false,"required":["full_name","phone_number","email","timezone"],"properties":{"full_name":{"type":"string","maxLength":255,"minLength":1},"job_title":{"type":"string","maxLength":120},"organization":{"type":"string","maxLength":255},"relationship_to_registrant":{"type":"string","maxLength":255},"phone_number":{"type":"string","maxLength":32,"minLength":1},"email":{"type":"string","format":"email","maxLength":254},"timezone":{"type":"string","maxLength":64,"minLength":1}}}},"financial":{"type":"object","additionalProperties":false,"required":["full_name","phone_number","email","timezone"],"properties":{"full_name":{"type":"string","maxLength":255,"minLength":1},"job_title":{"type":"string","maxLength":120},"organization":{"type":"string","maxLength":255},"relationship_to_registrant":{"type":"string","maxLength":255},"phone_number":{"type":"string","maxLength":32,"minLength":1},"email":{"type":"string","format":"email","maxLength":254},"timezone":{"type":"string","maxLength":64,"minLength":1}}}}}},"required":["enterprise_id","display_name","call_reasons","authorizer","references"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"create-branded-identity","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/branded-calling/identities"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_identity"]},"id":{"type":"string"},"enterprise_id":{"type":["null","string"]},"display_name":{"type":"string"},"call_reasons":{"type":"array","items":{"type":"string"}},"call_reasons_pre_approved":{"type":"boolean"},"logo_url":{"type":["null","string"]},"authorizer":{"type":"object","properties":{"name":{"type":["null","string"]},"email":{"type":["null","string"]}}},"references":{"type":"object","properties":{"business":{"type":"array","items":{"type":"object","properties":{"full_name":{"type":["null","string"]},"job_title":{"type":["null","string"]},"organization":{"type":["null","string"]},"relationship_to_registrant":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"email":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}},"financial":{"type":["null","object"],"properties":{"full_name":{"type":["null","string"]},"job_title":{"type":["null","string"]},"organization":{"type":["null","string"]},"relationship_to_registrant":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"email":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}}},"status":{"type":"string"},"rejection_reasons":{"type":"array","items":{"type":"object","additionalProperties":true}},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"monthly_cents":{"type":"integer"},"email_verified_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"verified_at":{"type":["null","string"],"format":"date-time"},"expiring_at":{"type":["null","string"],"format":"date-time"},"numbers":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["branded_number"]},"phone_number_id":{"type":["null","string"]},"phone_number":{"type":"string"},"status":{"type":"string"},"rejection_reason":{"type":["null","object"],"additionalProperties":true},"verified_at":{"type":["null","string"],"format":"date-time"},"added_at":{"type":["null","string"],"format":"date-time"}}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listBrandedIdentities","summary":"List caller identities","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"enterprise_id","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-branded-identities","x-feature":"telephony","x-zernio":["GET /v1/branded-calling/identities"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["branded_identity"]},"id":{"type":"string"},"enterprise_id":{"type":["null","string"]},"display_name":{"type":"string"},"call_reasons":{"type":"array","items":{"type":"string"}},"call_reasons_pre_approved":{"type":"boolean"},"logo_url":{"type":["null","string"]},"authorizer":{"type":"object","properties":{"name":{"type":["null","string"]},"email":{"type":["null","string"]}}},"references":{"type":"object","properties":{"business":{"type":"array","items":{"type":"object","properties":{"full_name":{"type":["null","string"]},"job_title":{"type":["null","string"]},"organization":{"type":["null","string"]},"relationship_to_registrant":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"email":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}},"financial":{"type":["null","object"],"properties":{"full_name":{"type":["null","string"]},"job_title":{"type":["null","string"]},"organization":{"type":["null","string"]},"relationship_to_registrant":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"email":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}}},"status":{"type":"string"},"rejection_reasons":{"type":"array","items":{"type":"object","additionalProperties":true}},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"monthly_cents":{"type":"integer"},"email_verified_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"verified_at":{"type":["null","string"],"format":"date-time"},"expiring_at":{"type":["null","string"],"format":"date-time"},"numbers":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["branded_number"]},"phone_number_id":{"type":["null","string"]},"phone_number":{"type":"string"},"status":{"type":"string"},"rejection_reason":{"type":["null","object"],"additionalProperties":true},"verified_at":{"type":["null","string"],"format":"date-time"},"added_at":{"type":["null","string"],"format":"date-time"}}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/branded-calling/identities/{id}":{"get":{"operationId":"getBrandedIdentity","summary":"Get a caller identity","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-branded-identity","x-feature":"telephony","x-zernio":["GET /v1/branded-calling/identities/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_identity"]},"id":{"type":"string"},"enterprise_id":{"type":["null","string"]},"display_name":{"type":"string"},"call_reasons":{"type":"array","items":{"type":"string"}},"call_reasons_pre_approved":{"type":"boolean"},"logo_url":{"type":["null","string"]},"authorizer":{"type":"object","properties":{"name":{"type":["null","string"]},"email":{"type":["null","string"]}}},"references":{"type":"object","properties":{"business":{"type":"array","items":{"type":"object","properties":{"full_name":{"type":["null","string"]},"job_title":{"type":["null","string"]},"organization":{"type":["null","string"]},"relationship_to_registrant":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"email":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}},"financial":{"type":["null","object"],"properties":{"full_name":{"type":["null","string"]},"job_title":{"type":["null","string"]},"organization":{"type":["null","string"]},"relationship_to_registrant":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"email":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}}},"status":{"type":"string"},"rejection_reasons":{"type":"array","items":{"type":"object","additionalProperties":true}},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"monthly_cents":{"type":"integer"},"email_verified_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"verified_at":{"type":["null","string"],"format":"date-time"},"expiring_at":{"type":["null","string"],"format":"date-time"},"numbers":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["branded_number"]},"phone_number_id":{"type":["null","string"]},"phone_number":{"type":"string"},"status":{"type":"string"},"rejection_reason":{"type":["null","object"],"additionalProperties":true},"verified_at":{"type":["null","string"],"format":"date-time"},"added_at":{"type":["null","string"],"format":"date-time"}}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateBrandedIdentity","summary":"Edit or resubmit a caller identity","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"display_name":{"type":"string","maxLength":35,"minLength":1},"call_reasons":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","maxLength":64,"minLength":1}},"logo_url":{"type":["string","null"],"maxLength":128},"authorizer":{"type":"object","additionalProperties":false,"required":["name","email"],"properties":{"name":{"type":"string","maxLength":255,"minLength":1},"email":{"type":"string","format":"email","maxLength":254}}},"references":{"type":"object","additionalProperties":false,"required":["business","financial"],"properties":{"business":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"object","additionalProperties":false,"required":["full_name","phone_number","email","timezone"],"properties":{"full_name":{"type":"string","maxLength":255,"minLength":1},"job_title":{"type":"string","maxLength":120},"organization":{"type":"string","maxLength":255},"relationship_to_registrant":{"type":"string","maxLength":255},"phone_number":{"type":"string","maxLength":32,"minLength":1},"email":{"type":"string","format":"email","maxLength":254},"timezone":{"type":"string","maxLength":64,"minLength":1}}}},"financial":{"type":"object","additionalProperties":false,"required":["full_name","phone_number","email","timezone"],"properties":{"full_name":{"type":"string","maxLength":255,"minLength":1},"job_title":{"type":"string","maxLength":120},"organization":{"type":"string","maxLength":255},"relationship_to_registrant":{"type":"string","maxLength":255},"phone_number":{"type":"string","maxLength":32,"minLength":1},"email":{"type":"string","format":"email","maxLength":254},"timezone":{"type":"string","maxLength":64,"minLength":1}}}}},"review_answers":{"type":"object","additionalProperties":{"type":"string","maxLength":5000}},"review_note":{"type":"string","maxLength":5000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"update","x-toolset":"telephony","x-mcp-tool":"update-branded-identity","x-feature":"telephony","x-zernio":["PATCH /v1/branded-calling/identities/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_identity"]},"id":{"type":"string"},"enterprise_id":{"type":["null","string"]},"display_name":{"type":"string"},"call_reasons":{"type":"array","items":{"type":"string"}},"call_reasons_pre_approved":{"type":"boolean"},"logo_url":{"type":["null","string"]},"authorizer":{"type":"object","properties":{"name":{"type":["null","string"]},"email":{"type":["null","string"]}}},"references":{"type":"object","properties":{"business":{"type":"array","items":{"type":"object","properties":{"full_name":{"type":["null","string"]},"job_title":{"type":["null","string"]},"organization":{"type":["null","string"]},"relationship_to_registrant":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"email":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}},"financial":{"type":["null","object"],"properties":{"full_name":{"type":["null","string"]},"job_title":{"type":["null","string"]},"organization":{"type":["null","string"]},"relationship_to_registrant":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"email":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}}},"status":{"type":"string"},"rejection_reasons":{"type":"array","items":{"type":"object","additionalProperties":true}},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"monthly_cents":{"type":"integer"},"email_verified_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"verified_at":{"type":["null","string"],"format":"date-time"},"expiring_at":{"type":["null","string"],"format":"date-time"},"numbers":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["branded_number"]},"phone_number_id":{"type":["null","string"]},"phone_number":{"type":"string"},"status":{"type":"string"},"rejection_reason":{"type":["null","object"],"additionalProperties":true},"verified_at":{"type":["null","string"],"format":"date-time"},"added_at":{"type":["null","string"],"format":"date-time"}}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteBrandedIdentity","summary":"Delete a caller identity","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"delete-branded-identity","x-feature":"telephony","x-zernio":["DELETE /v1/branded-calling/identities/{id}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_identity"]},"id":{"type":"string"},"deleted":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/branded-calling/identities/{id}/verify-email":{"post":{"operationId":"resendBrandedIdentityEmail","summary":"Resend the authorizer's code","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"resend-branded-identity-email","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/branded-calling/identities/{id}/verify-email"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_identity_email"]},"identity_id":{"type":"string"},"sent":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/branded-calling/identities/{id}/verify-email/confirm":{"post":{"operationId":"confirmBrandedIdentityEmail","summary":"Confirm the authorizer's code","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":12,"minLength":4}},"required":["code"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"confirm-branded-identity-email","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/branded-calling/identities/{id}/verify-email/confirm"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_identity"]},"id":{"type":"string"},"enterprise_id":{"type":["null","string"]},"display_name":{"type":"string"},"call_reasons":{"type":"array","items":{"type":"string"}},"call_reasons_pre_approved":{"type":"boolean"},"logo_url":{"type":["null","string"]},"authorizer":{"type":"object","properties":{"name":{"type":["null","string"]},"email":{"type":["null","string"]}}},"references":{"type":"object","properties":{"business":{"type":"array","items":{"type":"object","properties":{"full_name":{"type":["null","string"]},"job_title":{"type":["null","string"]},"organization":{"type":["null","string"]},"relationship_to_registrant":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"email":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}},"financial":{"type":["null","object"],"properties":{"full_name":{"type":["null","string"]},"job_title":{"type":["null","string"]},"organization":{"type":["null","string"]},"relationship_to_registrant":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"email":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}}},"status":{"type":"string"},"rejection_reasons":{"type":"array","items":{"type":"object","additionalProperties":true}},"review_note":{"type":["null","string"]},"review_request":{"type":["null","object"],"additionalProperties":true},"monthly_cents":{"type":"integer"},"email_verified_at":{"type":["null","string"],"format":"date-time"},"submitted_at":{"type":["null","string"],"format":"date-time"},"verified_at":{"type":["null","string"],"format":"date-time"},"expiring_at":{"type":["null","string"],"format":"date-time"},"numbers":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["branded_number"]},"phone_number_id":{"type":["null","string"]},"phone_number":{"type":"string"},"status":{"type":"string"},"rejection_reason":{"type":["null","object"],"additionalProperties":true},"verified_at":{"type":["null","string"],"format":"date-time"},"added_at":{"type":["null","string"],"format":"date-time"}}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/branded-calling/identities/{id}/numbers":{"get":{"operationId":"listBrandedIdentityNumbers","summary":"List the numbers on a caller identity","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-branded-identity-numbers","x-feature":"telephony","x-zernio":["GET /v1/branded-calling/identities/{id}/numbers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["branded_number"]},"phone_number_id":{"type":["null","string"]},"phone_number":{"type":"string"},"status":{"type":"string"},"rejection_reason":{"type":["null","object"],"additionalProperties":true},"verified_at":{"type":["null","string"],"format":"date-time"},"added_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"attachBrandedIdentityNumbers","summary":"Attach numbers to a verified identity","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phone_number_ids":{"type":"array","minItems":1,"maxItems":15,"items":{"type":"string","maxLength":80,"minLength":1}},"signature":{"type":"object","additionalProperties":false,"required":["image_base64"],"properties":{"image_base64":{"type":"string","minLength":8,"maxLength":1500000},"signer_name":{"type":"string","maxLength":120}}}},"required":["phone_number_ids","signature"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"attach-branded-identity-numbers","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/branded-calling/identities/{id}/numbers"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["branded_number"]},"phone_number_id":{"type":["null","string"]},"phone_number":{"type":"string"},"status":{"type":"string"},"rejection_reason":{"type":["null","object"],"additionalProperties":true},"verified_at":{"type":["null","string"],"format":"date-time"},"added_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"detachBrandedIdentityNumbers","summary":"Detach numbers from an identity","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phone_numbers":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","maxLength":80,"minLength":1}}},"required":["phone_numbers"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"delete","x-toolset":"telephony","x-mcp-tool":"detach-branded-identity-numbers","x-feature":"telephony","x-zernio":["DELETE /v1/branded-calling/identities/{id}/numbers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["branded_numbers_removed"]},"identity_id":{"type":"string"},"removed":{"type":"array","items":{"type":"string"}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/branded-calling/share":{"post":{"operationId":"shareBrandedIdentity","summary":"Create a caller identity share link","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"enterprise_id":{"type":"string","maxLength":80},"identity_id":{"type":"string","maxLength":80},"language":{"type":"string","enum":["en","es","pt-BR"]},"branding":{"type":"object","additionalProperties":false,"properties":{"company_name":{"type":"string","maxLength":120},"logo_url":{"type":"string","format":"uri","maxLength":2048},"brand_color":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"}}},"redirect_url":{"type":"string","format":"uri","maxLength":2048}}}}}},"security":[{"ApiKey":[]},{"OAuth2":["admin"]}],"x-access":"admin","x-kind":"create","x-toolset":"telephony","x-mcp-tool":"share-branded-identity","x-idempotent":true,"x-feature":"telephony","x-zernio":["POST /v1/branded-calling/share"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["telephony_share_link"]},"id":{"type":"string"},"kind":{"type":"string"},"url":{"type":["null","string"]},"token":{"type":["null","string"]},"expires_at":{"type":["null","string"],"format":"date-time"},"used_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]}},"/v1/verify/verifications":{"post":{"operationId":"createVerification","summary":"Send a verification code","tags":["Telephony"],"description":"Managed OTP by SMS; a pending verification for the same number is re-sent (200, resend: true).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"channel":{"type":"string","enum":["sms"]},"to":{"type":"string","minLength":3,"maxLength":32,"description":"E.164 phone number (+15550100100)"},"from":{"type":"string","maxLength":80},"brand_name":{"type":"string","maxLength":30},"code_length":{"type":"integer","minimum":4,"maximum":10},"ttl_minutes":{"type":"integer","minimum":1,"maximum":30},"locale":{"type":"string","maxLength":10}},"required":["channel","to"]}}}},"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"send","x-toolset":"telephony","x-mcp-tool":"create-verification","x-idempotent":true,"x-rate-limit":{"max":30,"timeWindow":"1 minute"},"x-zernio":["POST /v1/verify/verifications"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["verification"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","approved","expired","max_attempts_reached","canceled","delivery_failed"]},"channel":{"type":"string"},"to":{"type":"string"},"from":{"type":["null","string"]},"brand_name":{"type":["null","string"]},"code_length":{"type":"integer"},"expires_at":{"type":["null","string"],"format":"date-time"},"attempts":{"type":"integer"},"max_attempts":{"type":"integer"},"send_count":{"type":"integer"},"last_sent_at":{"type":["null","string"],"format":"date-time"},"delivery_status":{"type":["null","string"]},"delivery_error_code":{"type":["null","integer"]},"resend":{"type":"boolean"},"approved_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["verification"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","approved","expired","max_attempts_reached","canceled","delivery_failed"]},"channel":{"type":"string"},"to":{"type":"string"},"from":{"type":["null","string"]},"brand_name":{"type":["null","string"]},"code_length":{"type":"integer"},"expires_at":{"type":["null","string"],"format":"date-time"},"attempts":{"type":"integer"},"max_attempts":{"type":"integer"},"send_count":{"type":"integer"},"last_sent_at":{"type":["null","string"],"format":"date-time"},"delivery_status":{"type":["null","string"]},"delivery_error_code":{"type":["null","integer"]},"resend":{"type":"boolean"},"approved_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}]},"get":{"operationId":"listVerifications","summary":"List verifications","tags":["Telephony"],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Page number"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Items per page (max 100)"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["all","or"]},"in":"query","name":"match","required":false,"description":"Combine filters with AND (default) or OR"},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"to","required":false},{"schema":{"type":"string"},"in":"query","name":"channel","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"list-verifications","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["verification"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","approved","expired","max_attempts_reached","canceled","delivery_failed"]},"channel":{"type":"string"},"to":{"type":"string"},"from":{"type":["null","string"]},"brand_name":{"type":["null","string"]},"code_length":{"type":"integer"},"expires_at":{"type":["null","string"],"format":"date-time"},"attempts":{"type":"integer"},"max_attempts":{"type":"integer"},"send_count":{"type":"integer"},"last_sent_at":{"type":["null","string"],"format":"date-time"},"delivery_status":{"type":["null","string"]},"delivery_error_code":{"type":["null","integer"]},"resend":{"type":"boolean"},"approved_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/verify/verifications/{id}":{"get":{"operationId":"getVerification","summary":"Get a verification","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-verification","x-zernio":["GET /v1/verify/verifications/{verificationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["verification"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","approved","expired","max_attempts_reached","canceled","delivery_failed"]},"channel":{"type":"string"},"to":{"type":"string"},"from":{"type":["null","string"]},"brand_name":{"type":["null","string"]},"code_length":{"type":"integer"},"expires_at":{"type":["null","string"],"format":"date-time"},"attempts":{"type":"integer"},"max_attempts":{"type":"integer"},"send_count":{"type":"integer"},"last_sent_at":{"type":["null","string"],"format":"date-time"},"delivery_status":{"type":["null","string"]},"delivery_error_code":{"type":["null","integer"]},"resend":{"type":"boolean"},"approved_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/verify/verifications/{id}/check":{"post":{"operationId":"checkVerification","summary":"Check a verification code","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":10,"minLength":4}},"required":["code"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"check-verification","x-rate-limit":{"max":60,"timeWindow":"1 minute"},"x-zernio":["POST /v1/verify/verifications/{verificationId}/check"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["verification"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","approved","expired","max_attempts_reached","canceled","delivery_failed"]},"channel":{"type":"string"},"to":{"type":"string"},"from":{"type":["null","string"]},"brand_name":{"type":["null","string"]},"code_length":{"type":"integer"},"expires_at":{"type":["null","string"],"format":"date-time"},"attempts":{"type":"integer"},"max_attempts":{"type":"integer"},"send_count":{"type":"integer"},"last_sent_at":{"type":["null","string"],"format":"date-time"},"delivery_status":{"type":["null","string"]},"delivery_error_code":{"type":["null","integer"]},"resend":{"type":"boolean"},"approved_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"valid":{"type":"boolean"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/verify/verifications/{id}/cancel":{"post":{"operationId":"cancelVerification","summary":"Cancel a pending verification","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"id","required":true},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"telephony","x-mcp-tool":"cancel-verification","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["verification"]},"id":{"type":"string"},"status":{"type":"string","enum":["pending","approved","expired","max_attempts_reached","canceled","delivery_failed"]},"channel":{"type":"string"},"to":{"type":"string"},"from":{"type":["null","string"]},"brand_name":{"type":["null","string"]},"code_length":{"type":"integer"},"expires_at":{"type":["null","string"],"format":"date-time"},"attempts":{"type":"integer"},"max_attempts":{"type":"integer"},"send_count":{"type":"integer"},"last_sent_at":{"type":["null","string"],"format":"date-time"},"delivery_status":{"type":["null","string"]},"delivery_error_code":{"type":["null","integer"]},"resend":{"type":"boolean"},"approved_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/usage/calls":{"get":{"operationId":"getCallUsage","summary":"Calling usage and cost","tags":["Telephony"],"parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string","enum":["pstn"]},"in":"query","name":"channel","required":false},{"schema":{"type":"string","maxLength":32},"in":"query","name":"number","required":false},{"schema":{"type":"string","enum":["day","number","channel"]},"in":"query","name":"group_by","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-call-usage","x-zernio":["GET /v1/usage/calls"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["call_usage"]},"since":{"type":["null","string"],"format":"date-time"},"until":{"type":["null","string"],"format":"date-time"},"group_by":{"type":["null","string"]},"currency":{"type":"string"},"totals":{"type":"object","properties":{"calls":{"type":"integer"},"answered":{"type":"integer"},"minutes":{"type":"number"},"billable_usd":{"type":"number"},"branded_calls":{"type":"integer"},"branded_call_usd":{"type":"number"}}},"groups":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"calls":{"type":"integer"},"answered":{"type":"integer"},"minutes":{"type":"number"},"billable_usd":{"type":"number"},"branded_calls":{"type":"integer"},"branded_call_usd":{"type":"number"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/usage/sms":{"get":{"operationId":"getSmsUsage","summary":"SMS usage and cost","tags":["Telephony"],"parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string","maxLength":32},"in":"query","name":"number","required":false},{"schema":{"type":"string","enum":["day","number"]},"in":"query","name":"group_by","required":false}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":"get-sms-usage","x-zernio":["GET /v1/usage/sms"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["sms_usage"]},"since":{"type":["null","string"],"format":"date-time"},"until":{"type":["null","string"],"format":"date-time"},"group_by":{"type":["null","string"]},"currency":{"type":"string"},"totals":{"type":"object","properties":{"sent":{"type":"integer"},"received":{"type":"integer"},"total":{"type":"integer"},"segments":{"type":"integer"},"mms":{"type":"integer"},"failed":{"type":"integer"},"cost_usd":{"type":"number"}}},"groups":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"sent":{"type":"integer"},"received":{"type":"integer"},"total":{"type":"integer"},"segments":{"type":"integer"},"mms":{"type":"integer"},"failed":{"type":"integer"},"cost_usd":{"type":"number"}}}}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/phone-numbers/kyc/links/{token}":{"get":{"operationId":"getPhoneNumberKycLinkPage","summary":"Hosted KYC page data (public)","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"token","required":true}],"security":[],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":null,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number_kyc_link_page"]},"country":{"type":"string"},"number_type":{"type":"string"},"language":{"type":"string"},"branding":{"type":"object","additionalProperties":true},"fields":{"type":"array","items":{"type":"object","properties":{"requirement_id":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string"},"description":{"type":["null","string"]},"example":{"type":["null","string"]},"local_to":{"type":["null","string"]},"acceptance_criteria":{"type":["null","object"],"additionalProperties":true}}}},"expires_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"submitPhoneNumberKycLink","summary":"Submit a hosted KYC link (public)","tags":["Telephony"],"description":"Single use; the numbers are ordered under the workspace that created the link once approved.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"quantity":{"type":"integer","minimum":1,"maximum":5},"area_code":{"type":"string","maxLength":10},"end_user_first_name":{"type":"string","maxLength":120},"end_user_last_name":{"type":"string","maxLength":120},"values":{"type":"object","additionalProperties":{"type":["string","number","boolean"]},"maxProperties":50},"documents":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["requirement_id"],"properties":{"requirement_id":{"type":"string","maxLength":120,"minLength":1},"document_id":{"type":"string","maxLength":120},"issued_at":{"type":"string","format":"date"},"filename":{"type":"string","minLength":1,"maxLength":255},"content_base64":{"type":"string","minLength":4,"maxLength":7500000,"description":"base64 file content (≤5 MB decoded)"},"mime_type":{"type":"string","maxLength":100}}}},"address":{"type":"object","additionalProperties":false,"properties":{"requirement_id":{"type":"string","maxLength":120},"country_code":{"type":"string","minLength":2,"maxLength":2,"description":"ISO 3166-1 alpha-2 country"},"business_name":{"type":"string","maxLength":255},"first_name":{"type":"string","maxLength":120},"last_name":{"type":"string","maxLength":120},"street_address":{"type":"string","maxLength":255},"extended_address":{"type":"string","maxLength":255},"locality":{"type":"string","maxLength":120},"administrative_area":{"type":"string","maxLength":120},"postal_code":{"type":"string","maxLength":32}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"token","required":true}],"security":[],"x-access":"write","x-kind":"create","x-toolset":"telephony","x-mcp-tool":null,"x-rate-limit":{"max":10,"timeWindow":"1 hour"},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["kyc_submission"]},"id":{"type":"string"},"status":{"type":"string"},"submission_id":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"pre_order":{"type":"boolean"},"phone_numbers":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["phone_number"]},"id":{"type":"string"},"phone_number":{"type":["null","string"]},"label":{"type":["null","string"]},"country":{"type":"string"},"number_type":{"type":"string"},"status":{"type":"string"},"profile_id":{"type":["null","string"]},"sms_account_id":{"type":["null","string"]},"provider":{"type":"string"},"features":{"type":"object","properties":{"sms":{"type":"boolean"},"voice":{"type":"boolean"}}},"capabilities":{"type":"object","properties":{"sms":{"type":"boolean"},"mms":{"type":"boolean"},"voice":{"type":"boolean"},"domestic_only":{"type":"boolean"}}},"monthly_cents":{"type":"integer"},"end_user_first_name":{"type":["null","string"]},"end_user_last_name":{"type":["null","string"]},"regulatory":{"type":"object","properties":{"decline_reason":{"type":["null","string"]},"review_comment":{"type":["null","string"]},"verification_url":{"type":["null","string"]},"requirement_group_id":{"type":["null","string"]},"requirements":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"sms":{"type":"object","properties":{"enabled":{"type":"boolean"},"registration_id":{"type":["null","string"]},"registration_status":{"type":["null","string"]},"send_approved":{"type":"boolean"},"brand_name":{"type":["null","string"]}}},"voice":{"type":"object","properties":{"enabled":{"type":"boolean"},"forward_to":{"type":["null","string"]},"recording_enabled":{"type":"boolean"},"transcription_enabled":{"type":"boolean"},"voicemail_enabled":{"type":"boolean"}}},"sip_trunk_id":{"type":["null","string"]},"port_in_id":{"type":["null","string"]},"provisioned_at":{"type":["null","string"],"format":"date-time"},"activated_at":{"type":["null","string"],"format":"date-time"},"suspended_at":{"type":["null","string"],"format":"date-time"},"released_at":{"type":["null","string"],"format":"date-time"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}}}},"created_at":{"type":["null","string"],"format":"date-time"},"redirect_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/telephony/share/{token}":{"get":{"operationId":"getTelephonySharePage","summary":"Hosted telephony form (public)","tags":["Telephony"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"token","required":true}],"security":[],"x-access":"read","x-kind":"read","x-toolset":"telephony","x-mcp-tool":null,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["telephony_share_page"]},"kind":{"type":"string"},"language":{"type":"string"},"branding":{"type":"object","additionalProperties":true},"prefill":{"type":"object","additionalProperties":true},"expires_at":{"type":["null","string"],"format":"date-time"}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"submitTelephonySharePage","summary":"Submit a hosted telephony form (public)","tags":["Telephony"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"path","name":"token","required":true}],"security":[],"x-access":"read","x-kind":"create","x-toolset":"telephony","x-mcp-tool":null,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/focus/platforms":{"get":{"operationId":"listFocusPlatforms","summary":"List networks with Focus mode","tags":["Focus"],"description":"Networks that publish a focus module, with their navigation groups, resource / action counts and MCP toolset.","security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus","x-mcp-tool":"list-focus-platforms","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string","enum":["focus_platform"]},"platform":{"type":"string"},"label":{"type":"string"},"groups":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"icon":{"type":["null","string"]}}}},"resource_count":{"type":"integer"},"action_count":{"type":"integer"},"operation_count":{"type":"integer"},"toolset":{"type":"string"}}}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","page","limit","has_more"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/focus":{"get":{"operationId":"getFocusManifest","summary":"Get the Focus manifest of an account","tags":["Focus"],"description":"Resources of the account's network with their JSON schemas, operations and actions. Availability is computed from the account's granted scopes; `missing_scopes` and `reconnect_url` (connect with `scope_set=focus`) tell how to unlock the rest.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus","x-mcp-tool":"get-focus-manifest","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_manifest"]},"platform":{"type":"string"},"label":{"type":"string"},"account":{"type":"object","properties":{"object":{"type":"string","enum":["account"]},"id":{"type":"string"},"platform":{"type":"string"},"account_type":{"type":"string"},"username":{"type":["null","string"]},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"status":{"type":"string","enum":["active","needs_reconnect"]},"profile_id":{"type":["null","string"]},"scopes":{"type":"array","items":{"type":"string"}}}},"groups":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"icon":{"type":["null","string"]}}}},"resources":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"description":{"type":["null","string"]},"icon":{"type":["null","string"]},"group":{"type":"string"},"view":{"type":"string"},"singleton":{"type":"boolean"},"id_field":{"type":"string"},"title_field":{"type":["null","string"]},"columns":{"type":["null","array"],"items":{"type":"string"}},"fields":{"type":"object","additionalProperties":true},"operations":{"type":"object","properties":{"list":{"type":"object","properties":{"available":{"type":"boolean"},"query":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"body":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"summary":{"type":["null","string"]}}},"get":{"type":"object","properties":{"available":{"type":"boolean"},"query":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"body":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"summary":{"type":["null","string"]}}},"create":{"type":"object","properties":{"available":{"type":"boolean"},"query":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"body":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"summary":{"type":["null","string"]}}},"update":{"type":"object","properties":{"available":{"type":"boolean"},"query":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"body":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"summary":{"type":["null","string"]}}},"delete":{"type":"object","properties":{"available":{"type":"boolean"},"query":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"body":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"summary":{"type":["null","string"]}}}}},"actions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"target":{"type":"string","enum":["item","collection"]},"destructive":{"type":"boolean"},"body":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"summary":{"type":["null","string"]},"available":{"type":"boolean"}}}},"available":{"type":"boolean"},"missing_scopes":{"type":"array","items":{"type":"string"}},"docs":{"type":["null","string"]},"typed_path":{"type":["null","string"]}}}},"missing_scopes":{"type":"array","items":{"type":"string"}},"needs_reconnect":{"type":"boolean"},"reconnect_url":{"type":["null","string"]}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/focus/{resource}":{"get":{"operationId":"listFocusItems","summary":"List focus items (or get a singleton resource)","tags":["Focus"],"description":"Lists items of a resource with cursor pagination (`cursor` = previous `next_cursor`). Other query parameters are validated against the resource's `operations.list.query` schema and passed to the network. For singleton resources (`singleton: true` in the manifest) returns the object.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from `next_cursor`"},{"schema":{"type":"integer","minimum":1,"maximum":500},"in":"query","name":"limit","required":false,"description":"Page size (the network may cap it lower)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"path","name":"resource","required":true,"description":"Focus resource key from the manifest (e.g. `videos`)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus","x-mcp-tool":"list-focus-items","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"limit":{"type":["integer","null"]},"total":{"type":["integer","null"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"next_page_url":{"type":["string","null"]},"previous_page_url":{"type":["string","null"]}},"required":["object","data","has_more","next_cursor"]},{"type":"object","additionalProperties":true}]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"createFocusItem","summary":"Create a focus item","tags":["Focus"],"description":"Body validated against the resource's `operations.create.body` schema.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Fields from the resource schema (manifest `operations.<op>.body` / action `body`)"}}},"description":"Fields from the resource schema (manifest `operations.<op>.body` / action `body`)"},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"path","name":"resource","required":true,"description":"Focus resource key from the manifest (e.g. `videos`)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus","x-mcp-tool":"create-focus-item","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateFocusSingleton","summary":"Update a singleton focus resource","tags":["Focus"],"description":"For resources with `singleton: true` (channel settings, chat info, …). Body validated against `operations.update.body`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Fields from the resource schema (manifest `operations.<op>.body` / action `body`)"}}},"description":"Fields from the resource schema (manifest `operations.<op>.body` / action `body`)"},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"path","name":"resource","required":true,"description":"Focus resource key from the manifest (e.g. `videos`)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus","x-mcp-tool":"update-focus-singleton","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteFocusSingleton","summary":"Delete or reset a singleton focus resource","tags":["Focus"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"path","name":"resource","required":true,"description":"Focus resource key from the manifest (e.g. `videos`)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus","x-mcp-tool":"delete-focus-singleton","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/focus/{resource}/{itemId}":{"get":{"operationId":"getFocusItem","summary":"Get a focus item","tags":["Focus"],"description":"Query parameters are passed to the network (validated against `operations.get.query` when present).","parameters":[{"schema":"object","in":"query","name":"type"},{"schema":true,"in":"query","name":"additionalProperties"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"path","name":"resource","required":true,"description":"Focus resource key from the manifest (e.g. `videos`)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus","x-mcp-tool":"get-focus-item","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"updateFocusItem","summary":"Update a focus item","tags":["Focus"],"description":"Body validated against `operations.update.body`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Fields from the resource schema (manifest `operations.<op>.body` / action `body`)"}}},"description":"Fields from the resource schema (manifest `operations.<op>.body` / action `body`)"},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"path","name":"resource","required":true,"description":"Focus resource key from the manifest (e.g. `videos`)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus","x-mcp-tool":"update-focus-item","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"deleteFocusItem","summary":"Delete a focus item","tags":["Focus"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"path","name":"resource","required":true,"description":"Focus resource key from the manifest (e.g. `videos`)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus","x-mcp-tool":"delete-focus-item","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/focus/{resource}/{itemId}/{action}":{"post":{"operationId":"runFocusAction","summary":"Run a focus action","tags":["Focus"],"description":"Item actions (`target: \"item\"`) take the item id; collection actions (`target: \"collection\"`) and actions of singleton resources use `-` as `itemId` (`…/focus/{resource}/-/{action}`). Body validated against the action's `body` schema.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Fields from the resource schema (manifest `operations.<op>.body` / action `body`)"}}},"description":"Fields from the resource schema (manifest `operations.<op>.body` / action `body`)"},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"path","name":"resource","required":true,"description":"Focus resource key from the manifest (e.g. `videos`)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"path","name":"action","required":true,"description":"Action name from the manifest (e.g. `transition`)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus","x-mcp-tool":"run-focus-action","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/profile":{"get":{"operationId":"blueskyProfileGet","summary":"Bluesky: Get Profile","tags":["Focus · Bluesky"],"description":"Current profile record and counters. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: `/v1/accounts/{accountId}/focus/profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"],"maxLength":640,"description":"≤ 64 graphemes"},"description":{"type":["null","string"],"description":"≤ 256 graphemes"},"pronouns":{"type":["null","string"],"description":"≤ 20 graphemes"},"website":{"type":["null","string"],"format":"uri"},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":"integer"},"following_count":{"type":"integer"},"posts_count":{"type":"integer"},"pinned_post":{"type":["null","string"],"description":"AT-URI"},"self_labels":{"type":"array","items":{"type":"string","enum":["porn","sexual","nudity","graphic-media","bot","!no-unauthenticated"]}},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":"string","format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"blueskyProfileUpdate","summary":"Bluesky: Update Profile","tags":["Focus · Bluesky"],"description":"Edit the profile (read-modify-write; unknown fields are preserved). Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: `/v1/accounts/{accountId}/focus/profile`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"type":["string","null"]},"description":{"type":["string","null"]},"pronouns":{"type":["string","null"]},"website":{"type":["string","null"],"format":"uri"},"avatar":{"type":"string","description":"png/jpeg ≤ 1 MB (media id or URL)"},"banner":{"type":"string","description":"png/jpeg ≤ 1 MB, 3:1"},"remove_avatar":{"type":"boolean"},"remove_banner":{"type":"boolean"},"pinned_post":{"type":["string","null"],"description":"AT-URI or bsky.app URL; null unpins"},"self_labels":{"type":"array","items":{"type":"string","enum":["porn","sexual","nudity","graphic-media","bot","!no-unauthenticated"]}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-profile-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"],"maxLength":640,"description":"≤ 64 graphemes"},"description":{"type":["null","string"],"description":"≤ 256 graphemes"},"pronouns":{"type":["null","string"],"description":"≤ 20 graphemes"},"website":{"type":["null","string"],"format":"uri"},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":"integer"},"following_count":{"type":"integer"},"posts_count":{"type":"integer"},"pinned_post":{"type":["null","string"],"description":"AT-URI"},"self_labels":{"type":"array","items":{"type":"string","enum":["porn","sexual","nudity","graphic-media","bot","!no-unauthenticated"]}},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":"string","format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/profile/pin-post":{"post":{"operationId":"blueskyProfilePinPost","summary":"Bluesky: Pin post (Profile)","tags":["Focus · Bluesky"],"description":"Pin post. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: `/v1/accounts/{accountId}/focus/profile`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string"}},"required":["uri"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-profile-pin-post","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/profile/unpin-post":{"post":{"operationId":"blueskyProfileUnpinPost","summary":"Bluesky: Unpin post (Profile)","tags":["Focus · Bluesky"],"description":"Unpin post. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: `/v1/accounts/{accountId}/focus/profile`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-profile-unpin-post","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/profile/set-bot-label":{"post":{"operationId":"blueskyProfileSetBotLabel","summary":"Bluesky: Mark as automated (bot) (Profile)","tags":["Focus · Bluesky"],"description":"Bluesky asks automated accounts to carry the bot self-label. Display name, bio, pronouns, website, avatar, banner, pinned post and account self-labels (bot, adult content, hide from logged-out viewers). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/profiles Generic route: `/v1/accounts/{accountId}/focus/profile`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-profile-set-bot-label","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/account-status":{"get":{"operationId":"blueskyAccountStatusGet","summary":"Bluesky: Get Account & handle","tags":["Focus · Bluesky"],"description":"DID, PDS, auth mode, account status, email verification (required for video) and custom-domain handle. Requires one of: atproto. Network docs: https://endpoints.bsky.app/ Generic route: `/v1/accounts/{accountId}/focus/account-status`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-account-status-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"did":{"type":"string"},"handle":{"type":"string"},"active":{"type":"boolean"},"status":{"type":["null","string"]},"email":{"type":["null","string"]},"email_confirmed":{"type":["null","boolean"]},"pds_url":{"type":"string","format":"uri"},"auth_mode":{"type":"string","enum":["oauth","app_password"]},"granted_scopes":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/account-status/update-handle":{"post":{"operationId":"blueskyAccountStatusUpdateHandle","summary":"Bluesky: Change handle (Account & handle)","tags":["Focus · Bluesky"],"description":"com.atproto.identity.updateHandle (10 per 5 min, 50 per day). DID, PDS, auth mode, account status, email verification (required for video) and custom-domain handle. Requires scopes: identity:handle. Requires one of: atproto. Network docs: https://endpoints.bsky.app/ Generic route: `/v1/accounts/{accountId}/focus/account-status`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Domain with _atproto TXT or /.well-known/atproto-did already set up"}},"required":["handle"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-account-status-update-handle","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/discoverability":{"get":{"operationId":"blueskyDiscoverabilityGet","summary":"Bluesky: Get Discoverability","tags":["Focus · Bluesky"],"description":"Hide the account’s posts from algorithmic recommendations (app.bsky.actor.contentVisibilityDeclaration). Requires one of: repo:app.bsky.actor.contentVisibilityDeclaration | transition:generic. Network docs: https://bsky.network/docs/about-bluesky-content/visibility-preferences Generic route: `/v1/accounts/{accountId}/focus/discoverability`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-discoverability-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"hide_from_algorithmic_recommendations":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"blueskyDiscoverabilityUpdate","summary":"Bluesky: Update Discoverability","tags":["Focus · Bluesky"],"description":"Hide the account’s posts from algorithmic recommendations (app.bsky.actor.contentVisibilityDeclaration). Requires one of: repo:app.bsky.actor.contentVisibilityDeclaration | transition:generic. Network docs: https://bsky.network/docs/about-bluesky-content/visibility-preferences Generic route: `/v1/accounts/{accountId}/focus/discoverability`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hide_from_algorithmic_recommendations":{"type":"boolean"}},"required":["hide_from_algorithmic_recommendations"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-discoverability-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"hide_from_algorithmic_recommendations":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/activity-subscription-policy":{"get":{"operationId":"blueskyActivitySubscriptionPolicyGet","summary":"Bluesky: Get Who can subscribe","tags":["Focus · Bluesky"],"description":"Who may get notified when the account posts (app.bsky.notification.declaration). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: `/v1/accounts/{accountId}/focus/activity-subscription-policy`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-activity-subscription-policy-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"allow_subscriptions":{"type":"string","enum":["followers","mutuals","none"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"blueskyActivitySubscriptionPolicyUpdate","summary":"Bluesky: Update Who can subscribe","tags":["Focus · Bluesky"],"description":"Who may get notified when the account posts (app.bsky.notification.declaration). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: `/v1/accounts/{accountId}/focus/activity-subscription-policy`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"allow_subscriptions":{"type":"string","enum":["followers","mutuals","none"]}},"required":["allow_subscriptions"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-activity-subscription-policy-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"allow_subscriptions":{"type":"string","enum":["followers","mutuals","none"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posting-defaults":{"get":{"operationId":"blueskyPostingDefaultsGet","summary":"Bluesky: Get Posting defaults","tags":["Focus · Bluesky"],"description":"Socialit defaults for new posts: languages, reply/quote controls, content warnings, hidden tags, link cards and facet detection. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/posting-defaults`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posting-defaults-get","x-zernio":["GET /v1/accounts/{accountId}/bluesky-settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"defaultLangs":{"type":["null","array"],"minItems":1,"maxItems":3,"items":{"type":"string","description":"BCP-47 language tag, e.g. \"en\" or \"pt-BR\""},"description":"Languages written to every new post (`langs`). null = unset (Bluesky guesses)."},"defaultThreadgate":{"type":["null","array"],"maxItems":5,"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"},"description":"Default reply controls. null = everyone can reply; [] = nobody; otherwise any of mentioned, followers, following, list:<at-uri>."},"defaultPostgate":{"type":["null","object"],"properties":{"disableQuotes":{"type":"boolean"}},"description":"Default quote controls. null = quotes allowed."},"defaultLabels":{"type":"array","maxItems":10,"items":{"type":"string","enum":["porn","sexual","nudity","graphic-media"]},"description":"Self-labels (content warnings) applied to every new post."},"defaultTags":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":640},"description":"Extra hidden hashtags (`tags`) added to every new post."},"autoFacets":{"type":"boolean","description":"Detect links, @mentions and #hashtags (default true)."},"autoLinkCards":{"type":"boolean","description":"Build a link card from the first link when the post has no media (default true)."}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"blueskyPostingDefaultsUpdate","summary":"Bluesky: Update Posting defaults","tags":["Focus · Bluesky"],"description":"Socialit defaults for new posts: languages, reply/quote controls, content warnings, hidden tags, link cards and facet detection. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/posting-defaults`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"defaultLangs":{"type":["array","null"],"minItems":1,"maxItems":3,"items":{"type":"string","description":"BCP-47 language tag, e.g. \"en\" or \"pt-BR\""},"description":"Languages written to every new post (`langs`). null = unset (Bluesky guesses)."},"defaultThreadgate":{"type":["array","null"],"maxItems":5,"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"},"description":"Default reply controls. null = everyone can reply; [] = nobody; otherwise any of mentioned, followers, following, list:<at-uri>."},"defaultPostgate":{"type":["object","null"],"properties":{"disableQuotes":{"type":"boolean"}},"description":"Default quote controls. null = quotes allowed."},"defaultLabels":{"type":"array","maxItems":10,"items":{"type":"string","enum":["porn","sexual","nudity","graphic-media"]},"description":"Self-labels (content warnings) applied to every new post."},"defaultTags":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":640},"description":"Extra hidden hashtags (`tags`) added to every new post."},"autoFacets":{"type":"boolean","description":"Detect links, @mentions and #hashtags (default true)."},"autoLinkCards":{"type":"boolean","description":"Build a link card from the first link when the post has no media (default true)."}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posting-defaults-update","x-zernio":["PATCH /v1/accounts/{accountId}/bluesky-settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"defaultLangs":{"type":["null","array"],"minItems":1,"maxItems":3,"items":{"type":"string","description":"BCP-47 language tag, e.g. \"en\" or \"pt-BR\""},"description":"Languages written to every new post (`langs`). null = unset (Bluesky guesses)."},"defaultThreadgate":{"type":["null","array"],"maxItems":5,"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"},"description":"Default reply controls. null = everyone can reply; [] = nobody; otherwise any of mentioned, followers, following, list:<at-uri>."},"defaultPostgate":{"type":["null","object"],"properties":{"disableQuotes":{"type":"boolean"}},"description":"Default quote controls. null = quotes allowed."},"defaultLabels":{"type":"array","maxItems":10,"items":{"type":"string","enum":["porn","sexual","nudity","graphic-media"]},"description":"Self-labels (content warnings) applied to every new post."},"defaultTags":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":640},"description":"Extra hidden hashtags (`tags`) added to every new post."},"autoFacets":{"type":"boolean","description":"Detect links, @mentions and #hashtags (default true)."},"autoLinkCards":{"type":"boolean","description":"Build a link card from the first link when the post has no media (default true)."}}}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts":{"get":{"operationId":"blueskyPostsList","summary":"Bluesky: List Posts","tags":["Focus · Bluesky"],"description":"Author feed (app.bsky.feed.getAuthorFeed). The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["posts_with_replies","posts_no_replies","posts_with_media","posts_and_author_threads","posts_with_video"],"default":"posts_and_author_threads"},"in":"query","name":"filter","required":false},{"schema":{"type":"string"},"in":"query","name":"actor","required":false,"description":"defaults to the account"},{"schema":{"type":"boolean","default":true},"in":"query","name":"include_pins","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-list","x-zernio":["GET /v1/accounts/{accountId}/posts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}}},"required":["id","uri","cid","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyPostsCreate","summary":"Bluesky: Create a Posts item","tags":["Focus · Bluesky"],"description":"Publish a post or thread now. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"≤ 300 graphemes / 3000 bytes; links, @mentions and #tags become facets"},"media":{"type":"array","items":{"type":"object","properties":{"media":{"type":"string","description":"Socialit media id or public URL"},"alt_text":{"type":"string","maxLength":2000},"captions":{"type":"array","items":{"type":"object","properties":{"media":{"type":"string"},"lang":{"type":"string"}}}}}},"maxItems":4},"thread":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"media":{"type":"string","description":"Socialit media id or public URL"},"alt_text":{"type":"string","maxLength":2000},"captions":{"type":"array","items":{"type":"object","properties":{"media":{"type":"string"},"lang":{"type":"string"}}}}}},"maxItems":4}}},"description":"Additional posts of a thread (after the root)"},"langs":{"type":"array","items":{"type":"string"},"maxItems":3},"labels":{"type":"array","items":{"type":"string","enum":["porn","sexual","nudity","graphic-media"]}},"tags":{"type":"array","items":{"type":"string"},"maxItems":8},"threadgate":{"type":["array","null"],"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"},"maxItems":5,"description":"[] = nobody; null = everyone"},"disable_quotes":{"type":"boolean"},"quote":{"type":"string","description":"AT-URI / URL of a post, list, feed or starter pack"},"reply_to":{"type":"string","description":"AT-URI / URL of the post to reply to"},"link_card":{"type":["object","null"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"}}},"first_comment":{"type":"string"},"video_presentation":{"type":"string","enum":["default","gif"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-create","x-idempotent":true,"x-zernio":["POST /v1/posts/{postId}/unpublish","POST /v1/inbox/posts/{postId}/like"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}}},"required":["id","uri","cid","text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}":{"get":{"operationId":"blueskyPostsGet","summary":"Bluesky: Get a Posts item","tags":["Focus · Bluesky"],"description":"The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}}},"required":["id","uri","cid","text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"blueskyPostsDelete","summary":"Bluesky: Delete a Posts item","tags":["Focus · Bluesky"],"description":"Delete the post with its threadgate/postgate. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-delete","x-zernio":["DELETE /v1/inbox/posts/{postId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/like":{"post":{"operationId":"blueskyPostsLike","summary":"Bluesky: Like (Posts)","tags":["Focus · Bluesky"],"description":"Like. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/unlike":{"post":{"operationId":"blueskyPostsUnlike","summary":"Bluesky: Unlike (Posts)","tags":["Focus · Bluesky"],"description":"Unlike. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/repost":{"post":{"operationId":"blueskyPostsRepost","summary":"Bluesky: Repost (Posts)","tags":["Focus · Bluesky"],"description":"Repost. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-repost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/unrepost":{"post":{"operationId":"blueskyPostsUnrepost","summary":"Bluesky: Undo repost (Posts)","tags":["Focus · Bluesky"],"description":"Undo repost. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-unrepost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/bookmark":{"post":{"operationId":"blueskyPostsBookmark","summary":"Bluesky: Bookmark (Posts)","tags":["Focus · Bluesky"],"description":"Bookmark. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/unbookmark":{"post":{"operationId":"blueskyPostsUnbookmark","summary":"Bluesky: Remove bookmark (Posts)","tags":["Focus · Bluesky"],"description":"Remove bookmark. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-unbookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/pin":{"post":{"operationId":"blueskyPostsPin","summary":"Bluesky: Pin to profile (Posts)","tags":["Focus · Bluesky"],"description":"Pin to profile. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-pin","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/mute-thread":{"post":{"operationId":"blueskyPostsMuteThread","summary":"Bluesky: Mute thread (Posts)","tags":["Focus · Bluesky"],"description":"Mute thread. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-mute-thread","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/unmute-thread":{"post":{"operationId":"blueskyPostsUnmuteThread","summary":"Bluesky: Unmute thread (Posts)","tags":["Focus · Bluesky"],"description":"Unmute thread. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-unmute-thread","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/set-reply-controls":{"post":{"operationId":"blueskyPostsSetReplyControls","summary":"Bluesky: Reply controls (Posts)","tags":["Focus · Bluesky"],"description":"Threadgate on a root post: null = everyone, [] = nobody (hidden replies are kept). The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"allow":{"type":["array","null"],"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"},"maxItems":5}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-set-reply-controls","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/set-quote-controls":{"post":{"operationId":"blueskyPostsSetQuoteControls","summary":"Bluesky: Quote controls (Posts)","tags":["Focus · Bluesky"],"description":"Quote controls. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"disable_quotes":{"type":"boolean"}},"required":["disable_quotes"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-set-quote-controls","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/detach-quote":{"post":{"operationId":"blueskyPostsDetachQuote","summary":"Bluesky: Detach quote (Posts)","tags":["Focus · Bluesky"],"description":"Remove this post from a specific quote post (postgate detachedEmbeddingUris, ≤ 50). The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_uri":{"type":"string"}},"required":["quote_uri"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-detach-quote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/reattach-quote":{"post":{"operationId":"blueskyPostsReattachQuote","summary":"Bluesky: Reattach quote (Posts)","tags":["Focus · Bluesky"],"description":"Reattach quote. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_uri":{"type":"string"}},"required":["quote_uri"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-reattach-quote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/posts/{itemId}/report":{"post":{"operationId":"blueskyPostsReport","summary":"Bluesky: Report (Posts)","tags":["Focus · Bluesky"],"description":"Report. The account’s posts and threads with reply/quote controls, pinning, likes, reposts and bookmarks. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Network docs: https://bsky.network/docs/bluesky-api/creating-a-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason_type":{"type":"string","enum":["spam","violation","misleading","sexual","rude","other"]},"reason":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-posts-report","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/replies":{"get":{"operationId":"blueskyRepliesList","summary":"Bluesky: List Replies","tags":["Focus · Bluesky"],"description":"Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/replies`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"post","required":true,"description":"AT-URI or URL of the thread root/post"},{"schema":{"type":"integer","minimum":1,"maximum":10,"default":6},"in":"query","name":"depth","required":false},{"schema":{"type":"integer","default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-replies-list","x-zernio":["GET /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"text":{"type":"string"},"author":{"type":"string","description":"handle"},"author_id":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"repost_count":{"type":"integer"},"quote_count":{"type":"integer"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"depth":{"type":"integer"},"liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"hidden":{"type":"boolean"},"is_own":{"type":"boolean"},"url":{"type":"string","format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyRepliesCreate","summary":"Bluesky: Create a Replies item","tags":["Focus · Bluesky"],"description":"Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"parent":{"type":"string","description":"AT-URI of the post/reply to answer"},"text":{"type":"string"}},"required":["parent","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-replies-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}","POST /v1/inbox/comments/{postId}/{commentId}/hide","POST /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"text":{"type":"string"},"author":{"type":"string","description":"handle"},"author_id":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"repost_count":{"type":"integer"},"quote_count":{"type":"integer"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"depth":{"type":"integer"},"liked":{"type":"boolean"},"like_uri":{"type":["null","string"]},"hidden":{"type":"boolean"},"is_own":{"type":"boolean"},"url":{"type":"string","format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/replies/{itemId}":{"delete":{"operationId":"blueskyRepliesDelete","summary":"Bluesky: Delete a Replies item","tags":["Focus · Bluesky"],"description":"Delete one of the account’s own replies. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/replies`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-replies-delete","x-zernio":["DELETE /v1/inbox/comments/{postId}","DELETE /v1/inbox/comments/{postId}/{commentId}/hide","DELETE /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/replies/{itemId}/hide":{"post":{"operationId":"blueskyRepliesHide","summary":"Bluesky: Hide reply (Replies)","tags":["Focus · Bluesky"],"description":"Hide reply. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-replies-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/replies/{itemId}/unhide":{"post":{"operationId":"blueskyRepliesUnhide","summary":"Bluesky: Unhide reply (Replies)","tags":["Focus · Bluesky"],"description":"Unhide reply. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-replies-unhide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/replies/{itemId}/like":{"post":{"operationId":"blueskyRepliesLike","summary":"Bluesky: Like (Replies)","tags":["Focus · Bluesky"],"description":"Like. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-replies-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/replies/{itemId}/unlike":{"post":{"operationId":"blueskyRepliesUnlike","summary":"Bluesky: Unlike (Replies)","tags":["Focus · Bluesky"],"description":"Unlike. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-replies-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/replies/{itemId}/block-author":{"post":{"operationId":"blueskyRepliesBlockAuthor","summary":"Bluesky: Block author (Replies)","tags":["Focus · Bluesky"],"description":"Block author. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Destructive. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-replies-block-author","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/replies/{itemId}/mute-author":{"post":{"operationId":"blueskyRepliesMuteAuthor","summary":"Bluesky: Mute author (Replies)","tags":["Focus · Bluesky"],"description":"Mute author. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-replies-mute-author","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/replies/{itemId}/report":{"post":{"operationId":"blueskyRepliesReport","summary":"Bluesky: Report (Replies)","tags":["Focus · Bluesky"],"description":"Report. Thread replies under a post: reply, like, hide (threadgate hiddenReplies), delete own, block or report authors. Requires one of: repo:app.bsky.feed.post?action=create&action=delete + repo:app.bsky.feed.threadgate + repo:app.bsky.feed.postgate + blob:image/* | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview + blob:image/* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason_type":{"type":"string","enum":["spam","violation","misleading","sexual","rude","other"]},"reason":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-replies-report","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/drafts":{"get":{"operationId":"blueskyDraftsList","summary":"Bluesky: List Bluesky drafts","tags":["Focus · Bluesky"],"description":"Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/drafts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-drafts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"posts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"≤ 1000 graphemes"}}}},"langs":{"type":"array","items":{"type":"string"}},"threadgate":{"type":["null","array"],"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"}},"disable_quotes":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyDraftsCreate","summary":"Bluesky: Create a Bluesky drafts item","tags":["Focus · Bluesky"],"description":"Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/drafts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"posts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"}}}},"langs":{"type":"array","items":{"type":"string"}},"threadgate":{"type":["array","null"],"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"}},"disable_quotes":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-drafts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"posts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"≤ 1000 graphemes"}}}},"langs":{"type":"array","items":{"type":"string"}},"threadgate":{"type":["null","array"],"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"}},"disable_quotes":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/drafts/{itemId}":{"patch":{"operationId":"blueskyDraftsUpdate","summary":"Bluesky: Update a Bluesky drafts item","tags":["Focus · Bluesky"],"description":"Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/drafts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"posts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"}}}},"langs":{"type":"array","items":{"type":"string"}},"threadgate":{"type":["array","null"],"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"}},"disable_quotes":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-drafts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"posts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"≤ 1000 graphemes"}}}},"langs":{"type":"array","items":{"type":"string"}},"threadgate":{"type":["null","array"],"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"}},"disable_quotes":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"blueskyDraftsDelete","summary":"Bluesky: Delete a Bluesky drafts item","tags":["Focus · Bluesky"],"description":"Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/drafts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-drafts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/drafts/{itemId}/publish":{"post":{"operationId":"blueskyDraftsPublish","summary":"Bluesky: Publish draft (Bluesky drafts)","tags":["Focus · Bluesky"],"description":"Publish the draft content (send the draft body as shown) and delete the draft. Server-side drafts synced with the Bluesky app (app.bsky.draft.*, 2026 lexicon; text-only here). Requires one of: rpc?lxm=app.bsky.draft.createDraft&lxm=app.bsky.draft.deleteDraft&lxm=app.bsky.draft.getDrafts&lxm=app.bsky.draft.updateDraft&aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/drafts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"posts":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"}}}},"langs":{"type":"array","items":{"type":"string"}},"threadgate":{"type":["array","null"],"items":{"type":"string","pattern":"^(mentioned|followers|following|list:at://.+)$"}},"disable_quotes":{"type":"boolean"},"keep_draft":{"type":"boolean"}},"required":["posts"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-drafts-publish","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/timeline":{"get":{"operationId":"blueskyTimelineList","summary":"Bluesky: List Following timeline","tags":["Focus · Bluesky"],"description":"The account’s home timeline (app.bsky.feed.getTimeline). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: `/v1/accounts/{accountId}/focus/timeline`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-timeline-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}}},"required":["id","uri","cid","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/timeline/{itemId}/like":{"post":{"operationId":"blueskyTimelineLike","summary":"Bluesky: Like (Following timeline)","tags":["Focus · Bluesky"],"description":"Like. The account’s home timeline (app.bsky.feed.getTimeline). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: `/v1/accounts/{accountId}/focus/timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-timeline-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/timeline/{itemId}/repost":{"post":{"operationId":"blueskyTimelineRepost","summary":"Bluesky: Repost (Following timeline)","tags":["Focus · Bluesky"],"description":"Repost. The account’s home timeline (app.bsky.feed.getTimeline). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: `/v1/accounts/{accountId}/focus/timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-timeline-repost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/timeline/{itemId}/bookmark":{"post":{"operationId":"blueskyTimelineBookmark","summary":"Bluesky: Bookmark (Following timeline)","tags":["Focus · Bluesky"],"description":"Bookmark. The account’s home timeline (app.bsky.feed.getTimeline). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: `/v1/accounts/{accountId}/focus/timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-timeline-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/notifications":{"get":{"operationId":"blueskyNotificationsList","summary":"Bluesky: List Notifications","tags":["Focus · Bluesky"],"description":"Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/notifications`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["like","repost","follow","mention","reply","quote","starterpack-joined","verified","unverified","like-via-repost","repost-via-repost","subscribed-post","contact-match"]}},"in":"query","name":"reasons","required":false},{"schema":{"type":"boolean"},"in":"query","name":"priority","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-notifications-list","x-zernio":["GET /v1/inbox/mentions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI of the notifying record"},"type":{"type":"string","enum":["like","repost","follow","mention","reply","quote","starterpack-joined","verified","unverified","like-via-repost","repost-via-repost","subscribed-post","contact-match"]},"reason_subject":{"type":["null","string"],"description":"the account’s record that was liked/reposted/quoted"},"text":{"type":["null","string"]},"author":{"type":"string"},"author_id":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"is_read":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/notifications/mark-seen":{"post":{"operationId":"blueskyNotificationsMarkSeen","summary":"Bluesky: Mark all as seen (Notifications)","tags":["Focus · Bluesky"],"description":"Mark all as seen. Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/notifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seen_at":{"type":"string","format":"date-time"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-notifications-mark-seen","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/notifications/unread-count":{"post":{"operationId":"blueskyNotificationsUnreadCount","summary":"Bluesky: Unread count (Notifications)","tags":["Focus · Bluesky"],"description":"Unread count. Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/notifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-notifications-unread-count","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/notifications/{itemId}/reply":{"post":{"operationId":"blueskyNotificationsReply","summary":"Bluesky: Reply (Notifications)","tags":["Focus · Bluesky"],"description":"Reply to a mention/reply/quote notification. Mentions, replies, quotes, likes, reposts, follows and starter-pack joins. Marking as seen also clears the badge in the Bluesky app. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/notifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-notifications-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/conversations":{"get":{"operationId":"blueskyConversationsList","summary":"Bluesky: List Messages","tags":["Focus · Bluesky"],"description":"Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["request","accepted"]},"in":"query","name":"status","required":false},{"schema":{"type":"boolean"},"in":"query","name":"unread_only","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-conversations-list","x-zernio":["GET /v1/inbox/conversations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"avatar_url":{"type":["null","string"],"format":"uri"},"is_self":{"type":"boolean"}}}},"last_message":{"type":["null","string"]},"updated_at":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"status":{"type":"string","enum":["request","accepted"]},"muted":{"type":"boolean"},"kind":{"type":"string"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyConversationsCreate","summary":"Bluesky: Create a Messages item","tags":["Focus · Bluesky"],"description":"Start (or reopen) a 1:1 conversation. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"participant":{"type":"string","description":"handle or DID"},"text":{"type":"string"}},"required":["participant"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-conversations-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations","POST /v1/inbox/conversations/{conversationId}/accept","POST /v1/inbox/conversations/{conversationId}/read"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"avatar_url":{"type":["null","string"],"format":"uri"},"is_self":{"type":"boolean"}}}},"last_message":{"type":["null","string"]},"updated_at":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"status":{"type":"string","enum":["request","accepted"]},"muted":{"type":"boolean"},"kind":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/conversations/{itemId}":{"get":{"operationId":"blueskyConversationsGet","summary":"Bluesky: Get a Messages item","tags":["Focus · Bluesky"],"description":"Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-conversations-get","x-zernio":["GET /v1/inbox/conversations/{conversationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"avatar_url":{"type":["null","string"],"format":"uri"},"is_self":{"type":"boolean"}}}},"last_message":{"type":["null","string"]},"updated_at":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"status":{"type":"string","enum":["request","accepted"]},"muted":{"type":"boolean"},"kind":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"blueskyConversationsDelete","summary":"Bluesky: Delete a Messages item","tags":["Focus · Bluesky"],"description":"Leave the conversation. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-conversations-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/conversations/{itemId}/accept":{"post":{"operationId":"blueskyConversationsAccept","summary":"Bluesky: Accept request (Messages)","tags":["Focus · Bluesky"],"description":"Accept request. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-conversations-accept","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/conversations/{itemId}/mark-read":{"post":{"operationId":"blueskyConversationsMarkRead","summary":"Bluesky: Mark read (Messages)","tags":["Focus · Bluesky"],"description":"Mark read. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-conversations-mark-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/conversations/{itemId}/mute":{"post":{"operationId":"blueskyConversationsMute","summary":"Bluesky: Mute (Messages)","tags":["Focus · Bluesky"],"description":"Mute. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-conversations-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/conversations/{itemId}/unmute":{"post":{"operationId":"blueskyConversationsUnmute","summary":"Bluesky: Unmute (Messages)","tags":["Focus · Bluesky"],"description":"Unmute. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-conversations-unmute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/conversations/mark-all-read":{"post":{"operationId":"blueskyConversationsMarkAllRead","summary":"Bluesky: Mark all read (Messages)","tags":["Focus · Bluesky"],"description":"Mark all read. Direct messages and message requests (chat.bsky.convo.*). Text only; post links can be embedded. Mute/leave/reactions need the full chat permission set. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["request","accepted"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-conversations-mark-all-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/messages":{"get":{"operationId":"blueskyMessagesList","summary":"Bluesky: List Conversation","tags":["Focus · Bluesky"],"description":"Messages of one conversation with reactions; delete is “for me” only. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/messages`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"conversation","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-messages-list","x-zernio":["GET /v1/inbox/conversations/{conversationId}/messages"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"<conversation_id>:<message_id>"},"message_id":{"type":"string"},"conversation_id":{"type":"string"},"text":{"type":["null","string"],"maxLength":10000},"direction":{"type":"string","enum":["in","out"]},"from_id":{"type":"string"},"sent_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"reactions":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"from_id":{"type":"string"}}}},"embed_uri":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyMessagesCreate","summary":"Bluesky: Create a Conversation item","tags":["Focus · Bluesky"],"description":"Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"conversation":{"type":"string","description":"conversation id, or a handle/DID to DM"},"text":{"type":"string","description":"≤ 1000 graphemes"},"embed_uri":{"type":"string","description":"post to embed"}},"required":["conversation","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-messages-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/messages","POST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"<conversation_id>:<message_id>"},"message_id":{"type":"string"},"conversation_id":{"type":"string"},"text":{"type":["null","string"],"maxLength":10000},"direction":{"type":"string","enum":["in","out"]},"from_id":{"type":"string"},"sent_at":{"type":"string","format":"date-time"},"deleted":{"type":"boolean"},"reactions":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"from_id":{"type":"string"}}}},"embed_uri":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/messages/{itemId}":{"delete":{"operationId":"blueskyMessagesDelete","summary":"Bluesky: Delete a Conversation item","tags":["Focus · Bluesky"],"description":"Delete for the account only. Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/messages`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-messages-delete","x-zernio":["DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}","DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/messages/{itemId}/react":{"post":{"operationId":"blueskyMessagesReact","summary":"Bluesky: React (Conversation)","tags":["Focus · Bluesky"],"description":"React. Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{"type":"string","description":"one emoji"}},"required":["value"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-messages-react","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/messages/{itemId}/unreact":{"post":{"operationId":"blueskyMessagesUnreact","summary":"Bluesky: Remove reaction (Conversation)","tags":["Focus · Bluesky"],"description":"Remove reaction. Messages of one conversation with reactions; delete is “for me” only. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-messages-unreact","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/notification-preferences":{"get":{"operationId":"blueskyNotificationPreferencesGet","summary":"Bluesky: Get Notification settings","tags":["Focus · Bluesky"],"description":"Which notifications the account receives (app.bsky.notification.getPreferences / putPreferencesV2). Requires one of: include:app.bsky.authManageNotifications?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/notification-preferences`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-notification-preferences-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"chat":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"follow":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"like":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"likeViaRepost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"mention":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"quote":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"reply":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"repost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"repostViaRepost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"starterpackJoined":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"subscribedPost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"unverified":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"verified":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"blueskyNotificationPreferencesUpdate","summary":"Bluesky: Update Notification settings","tags":["Focus · Bluesky"],"description":"Which notifications the account receives (app.bsky.notification.getPreferences / putPreferencesV2). Requires one of: include:app.bsky.authManageNotifications?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/notification-preferences`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chat":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"follow":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"like":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"likeViaRepost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"mention":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"quote":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"reply":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"repost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"repostViaRepost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"starterpackJoined":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"subscribedPost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"unverified":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"verified":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-notification-preferences-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"chat":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"follow":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"like":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"likeViaRepost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"mention":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"quote":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"reply":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"repost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"repostViaRepost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"starterpackJoined":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"subscribedPost":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"unverified":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}},"verified":{"type":"object","properties":{"include":{"type":"string","enum":["all","follows","accepted"]},"list":{"type":"boolean"},"push":{"type":"boolean"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/activity-subscriptions":{"get":{"operationId":"blueskyActivitySubscriptionsList","summary":"Bluesky: List Post alerts","tags":["Focus · Bluesky"],"description":"“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/activity-subscriptions`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-activity-subscriptions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"},"notify_posts":{"type":"boolean"},"notify_replies":{"type":"boolean"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyActivitySubscriptionsCreate","summary":"Bluesky: Create a Post alerts item","tags":["Focus · Bluesky"],"description":"“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/activity-subscriptions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"},"notify_posts":{"type":"boolean","default":true},"notify_replies":{"type":"boolean","default":false}},"required":["actor"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-activity-subscriptions-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"},"notify_posts":{"type":"boolean"},"notify_replies":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/activity-subscriptions/{itemId}":{"patch":{"operationId":"blueskyActivitySubscriptionsUpdate","summary":"Bluesky: Update a Post alerts item","tags":["Focus · Bluesky"],"description":"“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/activity-subscriptions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notify_posts":{"type":"boolean"},"notify_replies":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-activity-subscriptions-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"},"notify_posts":{"type":"boolean"},"notify_replies":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"blueskyActivitySubscriptionsDelete","summary":"Bluesky: Delete a Post alerts item","tags":["Focus · Bluesky"],"description":"“Notify me when X posts” subscriptions (app.bsky.notification.*ActivitySubscription). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/activity-subscriptions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-activity-subscriptions-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/chat-settings":{"get":{"operationId":"blueskyChatSettingsGet","summary":"Bluesky: Get Who can message","tags":["Focus · Bluesky"],"description":"chat.bsky.actor.declaration: brands usually allow messages from everyone. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/chat-settings`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-chat-settings-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"allow_incoming":{"type":"string","enum":["all","following","none"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"blueskyChatSettingsUpdate","summary":"Bluesky: Update Who can message","tags":["Focus · Bluesky"],"description":"chat.bsky.actor.declaration: brands usually allow messages from everyone. Requires one of: include:chat.bsky.authFullChatClient?aud=did:web:api.bsky.chat%23bsky_chat | transition:generic + transition:chat.bsky. Generic route: `/v1/accounts/{accountId}/focus/chat-settings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"allow_incoming":{"type":"string","enum":["all","following","none"]}},"required":["allow_incoming"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-chat-settings-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"allow_incoming":{"type":"string","enum":["all","following","none"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/likes":{"get":{"operationId":"blueskyLikesList","summary":"Bluesky: List Likes","tags":["Focus · Bluesky"],"description":"Posts the account liked (app.bsky.feed.getActorLikes, own account only). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: repo:app.bsky.feed.like | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/likes`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-likes-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}}},"required":["id","uri","cid","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyLikesCreate","summary":"Bluesky: Create a Likes item","tags":["Focus · Bluesky"],"description":"Posts the account liked (app.bsky.feed.getActorLikes, own account only). Requires one of: repo:app.bsky.feed.like | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/likes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string","description":"post AT-URI or bsky.app URL"}},"required":["uri"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-likes-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}}},"required":["id","uri","cid","text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/likes/{itemId}":{"delete":{"operationId":"blueskyLikesDelete","summary":"Bluesky: Delete a Likes item","tags":["Focus · Bluesky"],"description":"Unlike (id = post or like URI). Posts the account liked (app.bsky.feed.getActorLikes, own account only). Requires one of: repo:app.bsky.feed.like | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/likes`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-likes-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/reposts":{"get":{"operationId":"blueskyRepostsList","summary":"Bluesky: List Reposts","tags":["Focus · Bluesky"],"description":"The account’s reposts (app.bsky.feed.repost records). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/reposts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-reposts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}},"repost_uri":{"type":"string"},"reposted_at":{"type":"string","format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyRepostsCreate","summary":"Bluesky: Create a Reposts item","tags":["Focus · Bluesky"],"description":"The account’s reposts (app.bsky.feed.repost records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/reposts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string","description":"post AT-URI or bsky.app URL"}},"required":["uri"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-reposts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}},"repost_uri":{"type":"string"},"reposted_at":{"type":"string","format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/reposts/{itemId}":{"delete":{"operationId":"blueskyRepostsDelete","summary":"Bluesky: Delete a Reposts item","tags":["Focus · Bluesky"],"description":"Undo (id = repost or post URI). The account’s reposts (app.bsky.feed.repost records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/reposts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-reposts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/bookmarks":{"get":{"operationId":"blueskyBookmarksList","summary":"Bluesky: List Bookmarks","tags":["Focus · Bluesky"],"description":"Private bookmarks (app.bsky.bookmark.*). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/bookmarks`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-bookmarks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}},"bookmarked_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyBookmarksCreate","summary":"Bluesky: Create a Bookmarks item","tags":["Focus · Bluesky"],"description":"Private bookmarks (app.bsky.bookmark.*). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/bookmarks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string","description":"post AT-URI or bsky.app URL"}},"required":["uri"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-bookmarks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}},"bookmarked_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/bookmarks/{itemId}":{"delete":{"operationId":"blueskyBookmarksDelete","summary":"Bluesky: Delete a Bookmarks item","tags":["Focus · Bluesky"],"description":"Private bookmarks (app.bsky.bookmark.*). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/bookmarks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-bookmarks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/post-engagement":{"get":{"operationId":"blueskyPostEngagementList","summary":"Bluesky: List Who engaged","tags":["Focus · Bluesky"],"description":"Accounts that liked, reposted or quoted a post (getLikes / getRepostedBy / getQuotes). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/post-engagement`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"uri","required":true},{"schema":{"type":"string","enum":["likes","reposts","quotes"],"default":"likes"},"in":"query","name":"type","required":false},{"schema":{"type":"integer","default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-post-engagement-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"},"engaged_at":{"type":["null","string"],"format":"date-time"},"quote_uri":{"type":["null","string"]},"quote_text":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/followers":{"get":{"operationId":"blueskyFollowersList","summary":"Bluesky: List Followers","tags":["Focus · Bluesky"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/followers`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"actor","required":false,"description":"defaults to the account"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-followers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"}},"required":["id","handle"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/followers/{itemId}/follow":{"post":{"operationId":"blueskyFollowersFollow","summary":"Bluesky: Follow (Followers)","tags":["Focus · Bluesky"],"description":"Follow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-followers-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/followers/{itemId}/unfollow":{"post":{"operationId":"blueskyFollowersUnfollow","summary":"Bluesky: Unfollow (Followers)","tags":["Focus · Bluesky"],"description":"Unfollow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-followers-unfollow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/followers/{itemId}/mute":{"post":{"operationId":"blueskyFollowersMute","summary":"Bluesky: Mute (Followers)","tags":["Focus · Bluesky"],"description":"Mute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-followers-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/followers/{itemId}/unmute":{"post":{"operationId":"blueskyFollowersUnmute","summary":"Bluesky: Unmute (Followers)","tags":["Focus · Bluesky"],"description":"Unmute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-followers-unmute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/followers/{itemId}/block":{"post":{"operationId":"blueskyFollowersBlock","summary":"Bluesky: Block (Followers)","tags":["Focus · Bluesky"],"description":"Block. Destructive. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-followers-block","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/followers/{itemId}/unblock":{"post":{"operationId":"blueskyFollowersUnblock","summary":"Bluesky: Unblock (Followers)","tags":["Focus · Bluesky"],"description":"Unblock. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-followers-unblock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/followers/{itemId}/report":{"post":{"operationId":"blueskyFollowersReport","summary":"Bluesky: Report account (Followers)","tags":["Focus · Bluesky"],"description":"Report account. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason_type":{"type":"string","enum":["spam","violation","misleading","sexual","rude","other"]},"reason":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-followers-report","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/following":{"get":{"operationId":"blueskyFollowingList","summary":"Bluesky: List Following","tags":["Focus · Bluesky"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/following`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"actor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-following-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"}},"required":["id","handle"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyFollowingCreate","summary":"Bluesky: Create a Following item","tags":["Focus · Bluesky"],"description":"Follow an account. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string","description":"handle or DID"}},"required":["actor"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-following-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"}},"required":["id","handle"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/following/{itemId}":{"delete":{"operationId":"blueskyFollowingDelete","summary":"Bluesky: Delete a Following item","tags":["Focus · Bluesky"],"description":"Unfollow. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/following`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-following-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/following/{itemId}/mute":{"post":{"operationId":"blueskyFollowingMute","summary":"Bluesky: Mute (Following)","tags":["Focus · Bluesky"],"description":"Mute. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-following-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/following/{itemId}/block":{"post":{"operationId":"blueskyFollowingBlock","summary":"Bluesky: Block (Following)","tags":["Focus · Bluesky"],"description":"Block. Destructive. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-following-block","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/blocks":{"get":{"operationId":"blueskyBlocksList","summary":"Bluesky: List Blocked accounts","tags":["Focus · Bluesky"],"description":"Blocks are public records (app.bsky.graph.block). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: repo:app.bsky.graph.block | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/blocks`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-blocks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"}},"required":["id","handle"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyBlocksCreate","summary":"Bluesky: Create a Blocked accounts item","tags":["Focus · Bluesky"],"description":"Blocks are public records (app.bsky.graph.block). Requires one of: repo:app.bsky.graph.block | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string","description":"handle or DID"}},"required":["actor"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-blocks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"}},"required":["id","handle"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/blocks/{itemId}":{"delete":{"operationId":"blueskyBlocksDelete","summary":"Bluesky: Delete a Blocked accounts item","tags":["Focus · Bluesky"],"description":"Blocks are public records (app.bsky.graph.block). Requires one of: repo:app.bsky.graph.block | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-blocks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/mutes":{"get":{"operationId":"blueskyMutesList","summary":"Bluesky: List Muted accounts","tags":["Focus · Bluesky"],"description":"Mutes are private (app.bsky.graph.muteActor). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/mutes`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-mutes-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"}},"required":["id","handle"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyMutesCreate","summary":"Bluesky: Create a Muted accounts item","tags":["Focus · Bluesky"],"description":"Mutes are private (app.bsky.graph.muteActor). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/mutes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string","description":"handle or DID"}},"required":["actor"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-mutes-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"}},"required":["id","handle"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/mutes/{itemId}":{"delete":{"operationId":"blueskyMutesDelete","summary":"Bluesky: Delete a Muted accounts item","tags":["Focus · Bluesky"],"description":"Mutes are private (app.bsky.graph.muteActor). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/mutes`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-mutes-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/suggested-follows":{"get":{"operationId":"blueskySuggestedFollowsList","summary":"Bluesky: List Suggested accounts","tags":["Focus · Bluesky"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/suggested-follows`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"similar_to","required":false,"description":"handle/DID: accounts similar to this one"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-suggested-follows-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"}},"required":["id","handle"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/suggested-follows/{itemId}/follow":{"post":{"operationId":"blueskySuggestedFollowsFollow","summary":"Bluesky: Follow (Suggested accounts)","tags":["Focus · Bluesky"],"description":"Follow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/suggested-follows`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-suggested-follows-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/suggested-follows/{itemId}/mute":{"post":{"operationId":"blueskySuggestedFollowsMute","summary":"Bluesky: Mute (Suggested accounts)","tags":["Focus · Bluesky"],"description":"Mute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/suggested-follows`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-suggested-follows-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/lists":{"get":{"operationId":"blueskyListsList","summary":"Bluesky: List Lists","tags":["Focus · Bluesky"],"description":"Curation lists (feeds of people) and moderation lists (mute/block in bulk). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/lists`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["curate","mod","reference"]},"in":"query","name":"purpose","required":false},{"schema":{"type":"string"},"in":"query","name":"actor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-lists-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"name":{"type":"string","maxLength":64},"purpose":{"type":"string","enum":["curate","mod","reference"]},"description":{"type":["null","string"],"description":"≤ 300 graphemes"},"avatar_url":{"type":["null","string"],"format":"uri"},"member_count":{"type":["null","integer"]},"creator_handle":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocked":{"type":["null","string"],"description":"listblock record URI when subscribed as a block list"},"labels":{"type":"array","items":{"type":"string"}},"indexed_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyListsCreate","summary":"Bluesky: Create a Lists item","tags":["Focus · Bluesky"],"description":"Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"purpose":{"type":"string","enum":["curate","mod"]},"description":{"type":"string"},"avatar":{"type":"string"}},"required":["name","purpose"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-lists-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"name":{"type":"string","maxLength":64},"purpose":{"type":"string","enum":["curate","mod","reference"]},"description":{"type":["null","string"],"description":"≤ 300 graphemes"},"avatar_url":{"type":["null","string"],"format":"uri"},"member_count":{"type":["null","integer"]},"creator_handle":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocked":{"type":["null","string"],"description":"listblock record URI when subscribed as a block list"},"labels":{"type":"array","items":{"type":"string"}},"indexed_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/lists/{itemId}":{"get":{"operationId":"blueskyListsGet","summary":"Bluesky: Get a Lists item","tags":["Focus · Bluesky"],"description":"Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/lists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-lists-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"name":{"type":"string","maxLength":64},"purpose":{"type":"string","enum":["curate","mod","reference"]},"description":{"type":["null","string"],"description":"≤ 300 graphemes"},"avatar_url":{"type":["null","string"],"format":"uri"},"member_count":{"type":["null","integer"]},"creator_handle":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocked":{"type":["null","string"],"description":"listblock record URI when subscribed as a block list"},"labels":{"type":"array","items":{"type":"string"}},"indexed_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"blueskyListsUpdate","summary":"Bluesky: Update a Lists item","tags":["Focus · Bluesky"],"description":"Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"avatar":{"type":"string"},"remove_avatar":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-lists-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"name":{"type":"string","maxLength":64},"purpose":{"type":"string","enum":["curate","mod","reference"]},"description":{"type":["null","string"],"description":"≤ 300 graphemes"},"avatar_url":{"type":["null","string"],"format":"uri"},"member_count":{"type":["null","integer"]},"creator_handle":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocked":{"type":["null","string"],"description":"listblock record URI when subscribed as a block list"},"labels":{"type":"array","items":{"type":"string"}},"indexed_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"blueskyListsDelete","summary":"Bluesky: Delete a Lists item","tags":["Focus · Bluesky"],"description":"Delete the list and its member records. Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/lists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-lists-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/lists/{itemId}/mute-list":{"post":{"operationId":"blueskyListsMuteList","summary":"Bluesky: Subscribe as mute list (Lists)","tags":["Focus · Bluesky"],"description":"Subscribe as mute list. Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-lists-mute-list","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/lists/{itemId}/unmute-list":{"post":{"operationId":"blueskyListsUnmuteList","summary":"Bluesky: Unsubscribe (mute) (Lists)","tags":["Focus · Bluesky"],"description":"Unsubscribe (mute). Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-lists-unmute-list","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/lists/{itemId}/block-list":{"post":{"operationId":"blueskyListsBlockList","summary":"Bluesky: Subscribe as block list (Lists)","tags":["Focus · Bluesky"],"description":"Subscribe as block list. Curation lists (feeds of people) and moderation lists (mute/block in bulk). Destructive. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-lists-block-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/lists/{itemId}/unblock-list":{"post":{"operationId":"blueskyListsUnblockList","summary":"Bluesky: Unsubscribe (block) (Lists)","tags":["Focus · Bluesky"],"description":"Unsubscribe (block). Curation lists (feeds of people) and moderation lists (mute/block in bulk). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-lists-unblock-list","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/list-members":{"get":{"operationId":"blueskyListMembersList","summary":"Bluesky: List List members","tags":["Focus · Bluesky"],"description":"Accounts in a list (app.bsky.graph.listitem records). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/list-members`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"list","required":false,"description":"list AT-URI or URL"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-list-members-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"listitem AT-URI"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"},"listitem_uri":{"type":"string"},"list_uri":{"type":"string"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyListMembersCreate","summary":"Bluesky: Create a List members item","tags":["Focus · Bluesky"],"description":"Accounts in a list (app.bsky.graph.listitem records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/list-members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list":{"type":"string"},"actor":{"type":"string","description":"handle or DID"}},"required":["list","actor"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-list-members-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"listitem AT-URI"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"},"listitem_uri":{"type":"string"},"list_uri":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/list-members/{itemId}":{"delete":{"operationId":"blueskyListMembersDelete","summary":"Bluesky: Delete a List members item","tags":["Focus · Bluesky"],"description":"Remove a member (id = listitem AT-URI). Accounts in a list (app.bsky.graph.listitem records). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/list-members`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-list-members-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/starter-packs":{"get":{"operationId":"blueskyStarterPacksList","summary":"Bluesky: List Starter packs","tags":["Focus · Bluesky"],"description":"Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/starter-packs`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"actor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-starter-packs-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uri":{"type":"string"},"cid":{"type":"string"},"name":{"type":"string","description":"≤ 50 graphemes"},"description":{"type":["null","string"]},"list_uri":{"type":"string"},"feeds":{"type":"array","items":{"type":"string"},"maxItems":3},"member_count":{"type":["null","integer"]},"joined_week":{"type":["null","integer"]},"joined_all_time":{"type":["null","integer"]},"creator_handle":{"type":["null","string"]},"members_sample":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyStarterPacksCreate","summary":"Bluesky: Create a Starter packs item","tags":["Focus · Bluesky"],"description":"Creates the reference list, its members and the starter pack in one applyWrites batch. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/starter-packs`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"members":{"type":"array","items":{"type":"string","description":"handle or DID"},"maxItems":150},"feeds":{"type":"array","items":{"type":"string"},"maxItems":3}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-starter-packs-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uri":{"type":"string"},"cid":{"type":"string"},"name":{"type":"string","description":"≤ 50 graphemes"},"description":{"type":["null","string"]},"list_uri":{"type":"string"},"feeds":{"type":"array","items":{"type":"string"},"maxItems":3},"member_count":{"type":["null","integer"]},"joined_week":{"type":["null","integer"]},"joined_all_time":{"type":["null","integer"]},"creator_handle":{"type":["null","string"]},"members_sample":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/starter-packs/{itemId}":{"get":{"operationId":"blueskyStarterPacksGet","summary":"Bluesky: Get a Starter packs item","tags":["Focus · Bluesky"],"description":"Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/starter-packs`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-starter-packs-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uri":{"type":"string"},"cid":{"type":"string"},"name":{"type":"string","description":"≤ 50 graphemes"},"description":{"type":["null","string"]},"list_uri":{"type":"string"},"feeds":{"type":"array","items":{"type":"string"},"maxItems":3},"member_count":{"type":["null","integer"]},"joined_week":{"type":["null","integer"]},"joined_all_time":{"type":["null","integer"]},"creator_handle":{"type":["null","string"]},"members_sample":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"blueskyStarterPacksUpdate","summary":"Bluesky: Update a Starter packs item","tags":["Focus · Bluesky"],"description":"Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/starter-packs`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":["string","null"]},"feeds":{"type":"array","items":{"type":"string"},"maxItems":3}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-starter-packs-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"uri":{"type":"string"},"cid":{"type":"string"},"name":{"type":"string","description":"≤ 50 graphemes"},"description":{"type":["null","string"]},"list_uri":{"type":"string"},"feeds":{"type":"array","items":{"type":"string"},"maxItems":3},"member_count":{"type":["null","integer"]},"joined_week":{"type":["null","integer"]},"joined_all_time":{"type":["null","integer"]},"creator_handle":{"type":["null","string"]},"members_sample":{"type":"array","items":{"type":"string"}},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"blueskyStarterPacksDelete","summary":"Bluesky: Delete a Starter packs item","tags":["Focus · Bluesky"],"description":"Delete the starter pack, its list and members. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/starter-packs`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-starter-packs-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/starter-packs/{itemId}/add-member":{"post":{"operationId":"blueskyStarterPacksAddMember","summary":"Bluesky: Add account (Starter packs)","tags":["Focus · Bluesky"],"description":"Add account. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/starter-packs`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"}},"required":["actor"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-starter-packs-add-member","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/starter-packs/{itemId}/remove-member":{"post":{"operationId":"blueskyStarterPacksRemoveMember","summary":"Bluesky: Remove account (Starter packs)","tags":["Focus · Bluesky"],"description":"Remove account. Shareable bundles of accounts and up to 3 feeds (backed by a reference list). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/starter-packs`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"actor":{"type":"string"}},"required":["actor"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-starter-packs-remove-member","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/list-subscriptions":{"get":{"operationId":"blueskyListSubscriptionsList","summary":"Bluesky: List Subscribed mod lists","tags":["Focus · Bluesky"],"description":"Moderation lists the account subscribes to as mute or block lists (getListMutes / getListBlocks). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/list-subscriptions`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["mute","block"],"default":"mute"},"in":"query","name":"type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-list-subscriptions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"name":{"type":"string","maxLength":64},"purpose":{"type":"string","enum":["curate","mod","reference"]},"description":{"type":["null","string"],"description":"≤ 300 graphemes"},"avatar_url":{"type":["null","string"],"format":"uri"},"member_count":{"type":["null","integer"]},"creator_handle":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocked":{"type":["null","string"],"description":"listblock record URI when subscribed as a block list"},"labels":{"type":"array","items":{"type":"string"}},"indexed_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"},"subscription":{"type":"string","enum":["mute","block"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/list-subscriptions/{itemId}":{"delete":{"operationId":"blueskyListSubscriptionsDelete","summary":"Bluesky: Delete a Subscribed mod lists item","tags":["Focus · Bluesky"],"description":"Unsubscribe (mute and block). Moderation lists the account subscribes to as mute or block lists (getListMutes / getListBlocks). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/list-subscriptions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-list-subscriptions-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/saved-feeds":{"get":{"operationId":"blueskySavedFeedsList","summary":"Bluesky: List Saved & pinned feeds","tags":["Focus · Bluesky"],"description":"The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/saved-feeds`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-saved-feeds-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"saved-feed item id"},"type":{"type":"string","enum":["feed","list","timeline"]},"value":{"type":"string","description":"feed/list AT-URI or \"following\""},"pinned":{"type":"boolean"},"position":{"type":"integer"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"creator_handle":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskySavedFeedsCreate","summary":"Bluesky: Create a Saved & pinned feeds item","tags":["Focus · Bluesky"],"description":"The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/saved-feeds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string","description":"feed generator or list AT-URI / URL"},"pinned":{"type":"boolean"}},"required":["uri"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-saved-feeds-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"saved-feed item id"},"type":{"type":"string","enum":["feed","list","timeline"]},"value":{"type":"string","description":"feed/list AT-URI or \"following\""},"pinned":{"type":"boolean"},"position":{"type":"integer"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"creator_handle":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/saved-feeds/{itemId}":{"patch":{"operationId":"blueskySavedFeedsUpdate","summary":"Bluesky: Update a Saved & pinned feeds item","tags":["Focus · Bluesky"],"description":"The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/saved-feeds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pinned":{"type":"boolean"}},"required":["pinned"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-saved-feeds-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"saved-feed item id"},"type":{"type":"string","enum":["feed","list","timeline"]},"value":{"type":"string","description":"feed/list AT-URI or \"following\""},"pinned":{"type":"boolean"},"position":{"type":"integer"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"creator_handle":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"blueskySavedFeedsDelete","summary":"Bluesky: Delete a Saved & pinned feeds item","tags":["Focus · Bluesky"],"description":"The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/saved-feeds`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-saved-feeds-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/saved-feeds/reorder":{"post":{"operationId":"blueskySavedFeedsReorder","summary":"Bluesky: Reorder (Saved & pinned feeds)","tags":["Focus · Bluesky"],"description":"Reorder. The feeds and lists shown in the account’s Bluesky app (pinned ones appear as tabs). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/saved-feeds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}}},"required":["ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-saved-feeds-reorder","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/feed-generators":{"get":{"operationId":"blueskyFeedGeneratorsList","summary":"Bluesky: List Discover feeds","tags":["Focus · Bluesky"],"description":"Suggested and searchable custom feeds; save, pin or like them. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/feed-generators`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false,"description":"search (app.bsky.unspecced.getPopularFeedGenerators)"},{"schema":{"type":"string"},"in":"query","name":"actor","required":false,"description":"feeds created by this account"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-feed-generators-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"service_did":{"type":["null","string"]},"display_name":{"type":"string"},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"creator_handle":{"type":["null","string"]},"accepts_interactions":{"type":"boolean"},"content_mode":{"type":["null","string"],"enum":["contentModeUnspecified","contentModeVideo",null]},"viewer_like":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/feed-generators/{itemId}":{"get":{"operationId":"blueskyFeedGeneratorsGet","summary":"Bluesky: Get a Discover feeds item","tags":["Focus · Bluesky"],"description":"Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/feed-generators`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-feed-generators-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"service_did":{"type":["null","string"]},"display_name":{"type":"string"},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"creator_handle":{"type":["null","string"]},"accepts_interactions":{"type":"boolean"},"content_mode":{"type":["null","string"],"enum":["contentModeUnspecified","contentModeVideo",null]},"viewer_like":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/feed-generators/{itemId}/save":{"post":{"operationId":"blueskyFeedGeneratorsSave","summary":"Bluesky: Save (Discover feeds)","tags":["Focus · Bluesky"],"description":"Save. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/feed-generators`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-feed-generators-save","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/feed-generators/{itemId}/pin":{"post":{"operationId":"blueskyFeedGeneratorsPin","summary":"Bluesky: Pin (Discover feeds)","tags":["Focus · Bluesky"],"description":"Pin. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/feed-generators`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-feed-generators-pin","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/feed-generators/{itemId}/like":{"post":{"operationId":"blueskyFeedGeneratorsLike","summary":"Bluesky: Like feed (Discover feeds)","tags":["Focus · Bluesky"],"description":"Like feed. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/feed-generators`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-feed-generators-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/feed-generators/{itemId}/unlike":{"post":{"operationId":"blueskyFeedGeneratorsUnlike","summary":"Bluesky: Unlike feed (Discover feeds)","tags":["Focus · Bluesky"],"description":"Unlike feed. Suggested and searchable custom feeds; save, pin or like them. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/feed-generators`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-feed-generators-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/feed-posts":{"get":{"operationId":"blueskyFeedPostsList","summary":"Bluesky: List Feed viewer","tags":["Focus · Bluesky"],"description":"Posts of any custom feed or list feed (app.bsky.feed.getFeed / getListFeed). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Network docs: https://endpoints.bsky.app/ Generic route: `/v1/accounts/{accountId}/focus/feed-posts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"feed","required":false,"description":"feed generator or list AT-URI / URL"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-feed-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}}},"required":["id","uri","cid","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/my-feeds":{"get":{"operationId":"blueskyMyFeedsList","summary":"Bluesky: List My feed generators","tags":["Focus · Bluesky"],"description":"Publish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/my-feeds`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-my-feeds-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"service_did":{"type":["null","string"]},"display_name":{"type":"string"},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"creator_handle":{"type":["null","string"]},"accepts_interactions":{"type":"boolean"},"content_mode":{"type":["null","string"],"enum":["contentModeUnspecified","contentModeVideo",null]},"viewer_like":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyMyFeedsCreate","summary":"Bluesky: Create a My feed generators item","tags":["Focus · Bluesky"],"description":"Publish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/my-feeds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rkey":{"type":"string","pattern":"^[a-zA-Z0-9-]{1,15}$","description":"short feed id used in the URL (create only)"},"service_did":{"type":"string","description":"did:web of the feed generator service"},"display_name":{"type":"string","description":"≤ 24 graphemes"},"description":{"type":"string"},"avatar":{"type":"string"},"accepts_interactions":{"type":"boolean"},"content_mode":{"type":"string","enum":["unspecified","video"]}},"required":["rkey","service_did","display_name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-my-feeds-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"service_did":{"type":["null","string"]},"display_name":{"type":"string"},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"creator_handle":{"type":["null","string"]},"accepts_interactions":{"type":"boolean"},"content_mode":{"type":["null","string"],"enum":["contentModeUnspecified","contentModeVideo",null]},"viewer_like":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/my-feeds/{itemId}":{"patch":{"operationId":"blueskyMyFeedsUpdate","summary":"Bluesky: Update a My feed generators item","tags":["Focus · Bluesky"],"description":"Publish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/my-feeds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rkey":{"type":"string","pattern":"^[a-zA-Z0-9-]{1,15}$","description":"short feed id used in the URL (create only)"},"service_did":{"type":"string","description":"did:web of the feed generator service"},"display_name":{"type":"string","description":"≤ 24 graphemes"},"description":{"type":"string"},"avatar":{"type":"string"},"accepts_interactions":{"type":"boolean"},"content_mode":{"type":"string","enum":["unspecified","video"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-my-feeds-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"service_did":{"type":["null","string"]},"display_name":{"type":"string"},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"creator_handle":{"type":["null","string"]},"accepts_interactions":{"type":"boolean"},"content_mode":{"type":["null","string"],"enum":["contentModeUnspecified","contentModeVideo",null]},"viewer_like":{"type":["null","string"]},"labels":{"type":"array","items":{"type":"string"}},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"blueskyMyFeedsDelete","summary":"Bluesky: Delete a My feed generators item","tags":["Focus · Bluesky"],"description":"Publish/maintain custom feed listings (app.bsky.feed.generator). Requires running a feed-generator service. Requires one of: include:app.bsky.authManageFeedDeclarations | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/my-feeds`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-my-feeds-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/reports":{"post":{"operationId":"blueskyReportsCreate","summary":"Bluesky: Create a Report content item","tags":["Focus · Bluesky"],"description":"Report posts, lists, feeds or accounts to Bluesky moderation (or another labeler). Keep a record of reports — the developer guidelines require it. Requires one of: rpc:com.atproto.moderation.createReport?aud=* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","description":"post/list/feed AT-URI or URL, or an account handle/DID"},"reason_type":{"type":"string","enum":["spam","violation","misleading","sexual","rude","other","appeal"]},"reason":{"type":"string","maxLength":2000},"labeler":{"type":"string","description":"labeler DID (default Bluesky moderation)"}},"required":["subject","reason_type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-reports-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":["null","integer"]},"reason_type":{"type":"string"},"subject":{"type":"object","properties":{"uri":{"type":"string"},"did":{"type":"string"}}},"created_at":{"type":"string","format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/muted-words":{"get":{"operationId":"blueskyMutedWordsList","summary":"Bluesky: List Muted words & tags","tags":["Focus · Bluesky"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/muted-words`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-muted-words-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"value":{"type":"string","description":"word, phrase or tag (without #)"},"targets":{"type":"array","items":{"type":"string","enum":["content","tag"]}},"actor_target":{"type":"string","enum":["all","exclude-following"]},"expires_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyMutedWordsCreate","summary":"Bluesky: Create a Muted words & tags item","tags":["Focus · Bluesky"],"description":"Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/muted-words`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{"type":"string"},"targets":{"type":"array","items":{"type":"string","enum":["content","tag"]}},"actor_target":{"type":"string","enum":["all","exclude-following"]},"expires_at":{"type":["string","null"],"format":"date-time"}},"required":["value"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-muted-words-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"value":{"type":"string","description":"word, phrase or tag (without #)"},"targets":{"type":"array","items":{"type":"string","enum":["content","tag"]}},"actor_target":{"type":"string","enum":["all","exclude-following"]},"expires_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/muted-words/{itemId}":{"patch":{"operationId":"blueskyMutedWordsUpdate","summary":"Bluesky: Update a Muted words & tags item","tags":["Focus · Bluesky"],"description":"Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/muted-words`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{"type":"string"},"targets":{"type":"array","items":{"type":"string","enum":["content","tag"]}},"actor_target":{"type":"string","enum":["all","exclude-following"]},"expires_at":{"type":["string","null"],"format":"date-time"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-muted-words-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"value":{"type":"string","description":"word, phrase or tag (without #)"},"targets":{"type":"array","items":{"type":"string","enum":["content","tag"]}},"actor_target":{"type":"string","enum":["all","exclude-following"]},"expires_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"blueskyMutedWordsDelete","summary":"Bluesky: Delete a Muted words & tags item","tags":["Focus · Bluesky"],"description":"Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/muted-words`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-muted-words-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/content-filters":{"get":{"operationId":"blueskyContentFiltersGet","summary":"Bluesky: Get Content filters","tags":["Focus · Bluesky"],"description":"Adult content and how Bluesky moderation labels are shown (adultContentPref + contentLabelPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/content-filters`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-content-filters-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"adult_content_enabled":{"type":"boolean"},"labels":{"type":"object","properties":{"porn":{"type":"string","enum":["ignore","show","warn","hide"]},"sexual":{"type":"string","enum":["ignore","show","warn","hide"]},"nudity":{"type":"string","enum":["ignore","show","warn","hide"]},"graphic-media":{"type":"string","enum":["ignore","show","warn","hide"]},"gore":{"type":"string","enum":["ignore","show","warn","hide"]}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"blueskyContentFiltersUpdate","summary":"Bluesky: Update Content filters","tags":["Focus · Bluesky"],"description":"Adult content and how Bluesky moderation labels are shown (adultContentPref + contentLabelPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/content-filters`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"adult_content_enabled":{"type":"boolean"},"labels":{"type":"object","properties":{"porn":{"type":"string","enum":["ignore","show","warn","hide"]},"sexual":{"type":"string","enum":["ignore","show","warn","hide"]},"nudity":{"type":"string","enum":["ignore","show","warn","hide"]},"graphic-media":{"type":"string","enum":["ignore","show","warn","hide"]},"gore":{"type":"string","enum":["ignore","show","warn","hide"]}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-content-filters-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"adult_content_enabled":{"type":"boolean"},"labels":{"type":"object","properties":{"porn":{"type":"string","enum":["ignore","show","warn","hide"]},"sexual":{"type":"string","enum":["ignore","show","warn","hide"]},"nudity":{"type":"string","enum":["ignore","show","warn","hide"]},"graphic-media":{"type":"string","enum":["ignore","show","warn","hide"]},"gore":{"type":"string","enum":["ignore","show","warn","hide"]}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/labelers":{"get":{"operationId":"blueskyLabelersList","summary":"Bluesky: List Moderation services","tags":["Focus · Bluesky"],"description":"Subscribed labelers (labelersPref). Bluesky’s own moderation always applies and cannot be removed. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/labelers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-labelers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"did":{"type":"string"},"handle":{"type":["null","string"]},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"label_values":{"type":"array","items":{"type":"string"}},"builtin":{"type":"boolean"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyLabelersCreate","summary":"Bluesky: Create a Moderation services item","tags":["Focus · Bluesky"],"description":"Subscribed labelers (labelersPref). Bluesky’s own moderation always applies and cannot be removed. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/labelers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"did":{"type":"string","description":"labeler account DID"}},"required":["did"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-labelers-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"did":{"type":"string"},"handle":{"type":["null","string"]},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"label_values":{"type":"array","items":{"type":"string"}},"builtin":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/labelers/{itemId}":{"delete":{"operationId":"blueskyLabelersDelete","summary":"Bluesky: Delete a Moderation services item","tags":["Focus · Bluesky"],"description":"Subscribed labelers (labelersPref). Bluesky’s own moderation always applies and cannot be removed. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/labelers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-labelers-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/hidden-posts":{"get":{"operationId":"blueskyHiddenPostsList","summary":"Bluesky: List Hidden posts","tags":["Focus · Bluesky"],"description":"Posts hidden from the account’s feeds (hiddenPostsPref). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/hidden-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-hidden-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}}},"required":["id","uri","cid","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"blueskyHiddenPostsCreate","summary":"Bluesky: Create a Hidden posts item","tags":["Focus · Bluesky"],"description":"Posts hidden from the account’s feeds (hiddenPostsPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/hidden-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string"}},"required":["uri"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-hidden-posts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}}},"required":["id","uri","cid","text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/hidden-posts/{itemId}":{"delete":{"operationId":"blueskyHiddenPostsDelete","summary":"Bluesky: Delete a Hidden posts item","tags":["Focus · Bluesky"],"description":"Posts hidden from the account’s feeds (hiddenPostsPref). Requires one of: include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/hidden-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-hidden-posts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/search-posts":{"get":{"operationId":"blueskySearchPostsList","summary":"Bluesky: List Search posts","tags":["Focus · Bluesky"],"description":"Social listening over Bluesky posts (app.bsky.feed.searchPosts; Lucene-like syntax, e.g. \"from:alice.bsky.social #atproto\"). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/search-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"type":"string","enum":["top","latest"],"default":"latest"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string"},"in":"query","name":"author","required":false},{"schema":{"type":"string"},"in":"query","name":"mentions","required":false},{"schema":{"type":"string"},"in":"query","name":"lang","required":false},{"schema":{"type":"string"},"in":"query","name":"domain","required":false},{"schema":{"type":"string","format":"uri"},"in":"query","name":"url","required":false},{"schema":{"type":"array","items":{"type":"string"}},"in":"query","name":"tag","required":false},{"schema":{"type":"integer","maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-search-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"AT-URI"},"uri":{"type":"string"},"cid":{"type":"string"},"rkey":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string","maxLength":3000},"created_at":{"type":"string","format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"langs":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"labels":{"type":"array","items":{"type":"string"}},"author_id":{"type":"string"},"author_handle":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"is_own":{"type":"boolean"},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"embed":{"type":["null","object"],"properties":{"type":{"type":"string","enum":["images","video","external","record","record_with_media"]},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"thumb":{"type":"string","format":"uri"},"alt":{"type":"string"}}}},"playlist":{"type":["null","string"],"format":"uri"},"thumbnail":{"type":["null","string"],"format":"uri"},"uri":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"record_uri":{"type":["null","string"]}}},"viewer_like":{"type":["null","string"]},"viewer_repost":{"type":["null","string"]},"viewer_bookmarked":{"type":"boolean"},"viewer_thread_muted":{"type":"boolean"},"reply_disabled":{"type":"boolean"},"embedding_disabled":{"type":"boolean"},"pinned":{"type":"boolean"},"reposted_by":{"type":["null","string"]},"threadgate_rules":{"type":["null","array"],"items":{"type":"string"}},"hidden_replies":{"type":"array","items":{"type":"string"}}},"required":["id","uri","cid","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/search-posts/{itemId}/like":{"post":{"operationId":"blueskySearchPostsLike","summary":"Bluesky: Like (Search posts)","tags":["Focus · Bluesky"],"description":"Like. Social listening over Bluesky posts (app.bsky.feed.searchPosts; Lucene-like syntax, e.g. \"from:alice.bsky.social #atproto\"). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/search-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-search-posts-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/search-posts/{itemId}/repost":{"post":{"operationId":"blueskySearchPostsRepost","summary":"Bluesky: Repost (Search posts)","tags":["Focus · Bluesky"],"description":"Repost. Social listening over Bluesky posts (app.bsky.feed.searchPosts; Lucene-like syntax, e.g. \"from:alice.bsky.social #atproto\"). Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/search-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-search-posts-repost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/search-accounts":{"get":{"operationId":"blueskySearchAccountsList","summary":"Bluesky: List Search accounts","tags":["Focus · Bluesky"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/search-accounts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"type":"boolean"},"in":"query","name":"typeahead","required":false},{"schema":{"type":"integer","default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-search-accounts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"DID"},"did":{"type":"string"},"handle":{"type":"string"},"display_name":{"type":["null","string"]},"description":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"following_count":{"type":["null","integer"]},"posts_count":{"type":["null","integer"]},"labels":{"type":"array","items":{"type":"string"}},"is_bot":{"type":"boolean"},"verified":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"indexed_at":{"type":["null","string"],"format":"date-time"},"viewer_following":{"type":["null","string"],"description":"follow record URI when the account follows them"},"viewer_followed_by":{"type":["null","string"]},"viewer_muted":{"type":"boolean"},"viewer_blocking":{"type":["null","string"],"description":"block record URI"},"viewer_blocked_by":{"type":"boolean"},"allow_incoming_chat":{"type":["null","string"],"enum":["all","following","none",null]},"url":{"type":"string","format":"uri"}},"required":["id","handle"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/search-accounts/{itemId}/follow":{"post":{"operationId":"blueskySearchAccountsFollow","summary":"Bluesky: Follow (Search accounts)","tags":["Focus · Bluesky"],"description":"Follow. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/search-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-search-accounts-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/search-accounts/{itemId}/mute":{"post":{"operationId":"blueskySearchAccountsMute","summary":"Bluesky: Mute (Search accounts)","tags":["Focus · Bluesky"],"description":"Mute. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/search-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-search-accounts-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/search-starter-packs":{"get":{"operationId":"blueskySearchStarterPacksList","summary":"Bluesky: List Search starter packs","tags":["Focus · Bluesky"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/search-starter-packs`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"type":"integer","default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-search-starter-packs-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"uri":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"member_count":{"type":["null","integer"]},"joined_all_time":{"type":["null","integer"]},"creator_handle":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/analytics-overview":{"get":{"operationId":"blueskyAnalyticsOverviewGet","summary":"Bluesky: Get Overview","tags":["Focus · Bluesky"],"description":"Pass ?since&until; the API supplies stored snapshots as ctx.snapshots. Followers, following and posts with follower growth from daily snapshots, plus engagement on recent posts. Bluesky has no impressions or views. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/analytics-overview`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-analytics-overview-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"followers":{"type":"integer"},"following":{"type":"integer"},"posts_count":{"type":"integer"},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"metrics":{"type":"object","properties":{"followers":{"type":"integer"},"following":{"type":"integer"},"follower_change":{"type":"integer"}}}}}},"totals":{"type":"object","properties":{"followers":{"type":"integer"},"following":{"type":"integer"},"follower_change":{"type":"integer"}}},"recent_engagement":{"type":"object","properties":{"posts":{"type":"integer"},"likes":{"type":"integer"},"shares":{"type":"integer"},"comments":{"type":"integer"},"quotes":{"type":"integer"},"saves":{"type":"integer"},"engagements":{"type":"integer"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/post-analytics":{"get":{"operationId":"blueskyPostAnalyticsList","summary":"Bluesky: List Post performance","tags":["Focus · Bluesky"],"description":"Likes, reposts, replies, quotes and bookmarks per recent post. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: include:app.bsky.authViewAll?aud=did:web:api.bsky.app%23bsky_appview | include:app.bsky.authFullApp?aud=did:web:api.bsky.app%23bsky_appview | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/post-analytics`.","parameters":[{"schema":{"type":"string","enum":["recent","top"],"default":"recent"},"in":"query","name":"sort","required":false},{"schema":{"type":"integer","maximum":200,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-post-analytics-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"text":{"type":"string"},"like_count":{"type":"integer"},"repost_count":{"type":"integer"},"reply_count":{"type":"integer"},"quote_count":{"type":"integer"},"bookmark_count":{"type":"integer"},"engagements":{"type":"integer"},"url":{"type":"string","format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/bluesky/video-limits":{"get":{"operationId":"blueskyVideoLimitsGet","summary":"Bluesky: Get Video quota","tags":["Focus · Bluesky"],"description":"Remaining daily video uploads and bytes (app.bsky.video.getUploadLimits). Bluesky-hosted accounts need a verified email. Requires one of: rpc:com.atproto.repo.uploadBlob?aud=* + rpc:app.bsky.video.getUploadLimits?aud=* | transition:generic. Generic route: `/v1/accounts/{accountId}/focus/video-limits`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_bluesky","x-mcp-tool":"bluesky-video-limits-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"can_upload":{"type":"boolean"},"remaining_daily_videos":{"type":["null","integer"]},"remaining_daily_bytes":{"type":["null","integer"]},"message":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/server":{"get":{"operationId":"discordServerGet","summary":"Discord: Get Server overview","tags":["Focus · Discord"],"description":"Server profile, counts, boost level and settings. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild Generic route: `/v1/accounts/{accountId}/focus/server`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-server-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":100},"description":{"type":["null","string"],"maxLength":120},"icon_url":{"type":["null","string"],"format":"uri","readOnly":true},"icon":{"type":"string","description":"New icon (image media id / URL / data URI)"},"banner":{"type":"string"},"splash":{"type":"string"},"member_count":{"type":"integer","readOnly":true},"online_count":{"type":"integer","readOnly":true},"premium_tier":{"type":"integer","readOnly":true},"boost_count":{"type":"integer","readOnly":true},"features":{"type":"array","items":{"type":"string"},"readOnly":true},"verification_level":{"type":"integer","enum":[0,1,2,3,4]},"default_message_notifications":{"type":"integer","enum":[0,1],"description":"0 all messages, 1 only mentions"},"explicit_content_filter":{"type":"integer","enum":[0,1,2]},"preferred_locale":{"type":"string"},"system_channel_id":{"type":["null","string"]},"rules_channel_id":{"type":["null","string"]},"public_updates_channel_id":{"type":["null","string"]},"safety_alerts_channel_id":{"type":["null","string"]},"afk_channel_id":{"type":["null","string"]},"afk_timeout":{"type":"integer","enum":[60,300,900,1800,3600]},"premium_progress_bar_enabled":{"type":"boolean"},"vanity_url_code":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordServerUpdate","summary":"Discord: Update Server overview","tags":["Focus · Discord"],"description":"Server profile, counts, boost level and settings. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild Generic route: `/v1/accounts/{accountId}/focus/server`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-server-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":100},"description":{"type":["null","string"],"maxLength":120},"icon_url":{"type":["null","string"],"format":"uri","readOnly":true},"icon":{"type":"string","description":"New icon (image media id / URL / data URI)"},"banner":{"type":"string"},"splash":{"type":"string"},"member_count":{"type":"integer","readOnly":true},"online_count":{"type":"integer","readOnly":true},"premium_tier":{"type":"integer","readOnly":true},"boost_count":{"type":"integer","readOnly":true},"features":{"type":"array","items":{"type":"string"},"readOnly":true},"verification_level":{"type":"integer","enum":[0,1,2,3,4]},"default_message_notifications":{"type":"integer","enum":[0,1],"description":"0 all messages, 1 only mentions"},"explicit_content_filter":{"type":"integer","enum":[0,1,2]},"preferred_locale":{"type":"string"},"system_channel_id":{"type":["null","string"]},"rules_channel_id":{"type":["null","string"]},"public_updates_channel_id":{"type":["null","string"]},"safety_alerts_channel_id":{"type":["null","string"]},"afk_channel_id":{"type":["null","string"]},"afk_timeout":{"type":"integer","enum":[60,300,900,1800,3600]},"premium_progress_bar_enabled":{"type":"boolean"},"vanity_url_code":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/server/refresh-permissions":{"post":{"operationId":"discordServerRefreshPermissions","summary":"Discord: Check bot permissions (Server overview)","tags":["Focus · Discord"],"description":"Effective bot permissions vs. what Socialit core/focus needs. Server profile, counts, boost level and settings. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild Generic route: `/v1/accounts/{accountId}/focus/server`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-server-refresh-permissions","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/server/register-commands":{"post":{"operationId":"discordServerRegisterCommands","summary":"Discord: Install Socialit commands (Server overview)","tags":["Focus · Discord"],"description":"Registers the \"Send to Socialit inbox\" message command and /socialit. Server profile, counts, boost level and settings. Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/resources/guild Generic route: `/v1/accounts/{accountId}/focus/server`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-server-register-commands","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/server/pause-invites":{"post":{"operationId":"discordServerPauseInvites","summary":"Discord: Pause invites / DMs (raid) (Server overview)","tags":["Focus · Discord"],"description":"Incident actions, up to 24 h. Server profile, counts, boost level and settings. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild Generic route: `/v1/accounts/{accountId}/focus/server`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"invites_disabled_until":{"type":["string","null"],"format":"date-time"},"dms_disabled_until":{"type":["string","null"],"format":"date-time"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-server-pause-invites","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/server/leave":{"post":{"operationId":"discordServerLeave","summary":"Discord: Remove Socialit bot (Server overview)","tags":["Focus · Discord"],"description":"The bot leaves the server; every Socialit account bound to it stops working. Server profile, counts, boost level and settings. Destructive. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild Generic route: `/v1/accounts/{accountId}/focus/server`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_discord","x-mcp-tool":"discord-server-leave","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/settings":{"get":{"operationId":"discordSettingsGet","summary":"Discord: Get Posting settings","tags":["Focus · Discord"],"description":"Default webhook identity and the channel this account posts to. Generic route: `/v1/accounts/{accountId}/focus/settings`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-settings-get","x-zernio":["GET /v1/accounts/{accountId}/discord-settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["bot","webhook"],"readOnly":true},"guildId":{"type":"string","readOnly":true},"guildName":{"type":["null","string"],"readOnly":true},"channelId":{"type":"string","description":"Switch the account to another channel of the same server (bot mode)"},"channelName":{"type":["null","string"],"readOnly":true},"channelType":{"type":["null","integer"],"readOnly":true},"webhookUsername":{"type":["null","string"],"maxLength":80,"description":"Default display name (\"\" resets)"},"webhookAvatarUrl":{"type":["null","string"],"format":"uri","description":"Default avatar (\"\" resets)"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordSettingsUpdate","summary":"Discord: Update Posting settings","tags":["Focus · Discord"],"description":"Returns `account` — the patch the API persists on the social account. Default webhook identity and the channel this account posts to. Generic route: `/v1/accounts/{accountId}/focus/settings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-settings-update","x-zernio":["PATCH /v1/accounts/{accountId}/discord-settings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["bot","webhook"],"readOnly":true},"guildId":{"type":"string","readOnly":true},"guildName":{"type":["null","string"],"readOnly":true},"channelId":{"type":"string","description":"Switch the account to another channel of the same server (bot mode)"},"channelName":{"type":["null","string"],"readOnly":true},"channelType":{"type":["null","integer"],"readOnly":true},"webhookUsername":{"type":["null","string"],"maxLength":80,"description":"Default display name (\"\" resets)"},"webhookAvatarUrl":{"type":["null","string"],"format":"uri","description":"Default avatar (\"\" resets)"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/welcome-screen":{"get":{"operationId":"discordWelcomeScreenGet","summary":"Discord: Get Welcome screen","tags":["Focus · Discord"],"description":"Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#welcome-screen-object Generic route: `/v1/accounts/{accountId}/focus/welcome-screen`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-welcome-screen-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"description":{"type":["null","string"],"maxLength":140},"welcome_channels":{"type":"array","items":{"type":"object","properties":{"channel_id":{"type":"string"},"description":{"type":"string","maxLength":50},"emoji_id":{"type":["null","string"]},"emoji_name":{"type":["null","string"]}}},"maxItems":5}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordWelcomeScreenUpdate","summary":"Discord: Update Welcome screen","tags":["Focus · Discord"],"description":"Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#welcome-screen-object Generic route: `/v1/accounts/{accountId}/focus/welcome-screen`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-welcome-screen-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"description":{"type":["null","string"],"maxLength":140},"welcome_channels":{"type":"array","items":{"type":"object","properties":{"channel_id":{"type":"string"},"description":{"type":"string","maxLength":50},"emoji_id":{"type":["null","string"]},"emoji_name":{"type":["null","string"]}}},"maxItems":5}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/onboarding":{"get":{"operationId":"discordOnboardingGet","summary":"Discord: Get Onboarding","tags":["Focus · Discord"],"description":"Onboarding prompts and default channels (≥7 default channels when enabled). Requires scopes: bot, permission:MANAGE_GUILD, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/guild#guild-onboarding-object Generic route: `/v1/accounts/{accountId}/focus/onboarding`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-onboarding-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"mode":{"type":"integer","enum":[0,1],"description":"0 default channels only, 1 + questions count toward constraints"},"default_channel_ids":{"type":"array","items":{"type":"string"}},"prompts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"integer","enum":[0,1],"description":"0 multiple choice, 1 dropdown"},"title":{"type":"string"},"single_select":{"type":"boolean"},"required":{"type":"boolean"},"in_onboarding":{"type":"boolean"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":["null","string"]},"channel_ids":{"type":"array","items":{"type":"string"}},"role_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordOnboardingUpdate","summary":"Discord: Update Onboarding","tags":["Focus · Discord"],"description":"Onboarding prompts and default channels (≥7 default channels when enabled). Requires scopes: bot, permission:MANAGE_GUILD, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/guild#guild-onboarding-object Generic route: `/v1/accounts/{accountId}/focus/onboarding`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-onboarding-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"mode":{"type":"integer","enum":[0,1],"description":"0 default channels only, 1 + questions count toward constraints"},"default_channel_ids":{"type":"array","items":{"type":"string"}},"prompts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"integer","enum":[0,1],"description":"0 multiple choice, 1 dropdown"},"title":{"type":"string"},"single_select":{"type":"boolean"},"required":{"type":"boolean"},"in_onboarding":{"type":"boolean"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":["null","string"]},"channel_ids":{"type":"array","items":{"type":"string"}},"role_ids":{"type":"array","items":{"type":"string"}}}}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/widget":{"get":{"operationId":"discordWidgetGet","summary":"Discord: Get Server widget","tags":["Focus · Discord"],"description":"Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#guild-widget-settings-object Generic route: `/v1/accounts/{accountId}/focus/widget`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-widget-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"channel_id":{"type":["null","string"],"description":"Invite channel"},"widget_json_url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordWidgetUpdate","summary":"Discord: Update Server widget","tags":["Focus · Discord"],"description":"Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#guild-widget-settings-object Generic route: `/v1/accounts/{accountId}/focus/widget`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-widget-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"channel_id":{"type":["null","string"],"description":"Invite channel"},"widget_json_url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/bot-persona":{"get":{"operationId":"discordBotPersonaGet","summary":"Discord: Get Bot persona","tags":["Focus · Discord"],"description":"The Socialit bot's per-server nickname, avatar, banner and bio. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild#modify-current-member Generic route: `/v1/accounts/{accountId}/focus/bot-persona`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-bot-persona-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"nick":{"type":["null","string"],"maxLength":32},"avatar":{"type":["null","string"]},"banner":{"type":["null","string"]},"bio":{"type":["null","string"],"maxLength":190},"roles":{"type":"array","items":{"type":"string"},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordBotPersonaUpdate","summary":"Discord: Update Bot persona","tags":["Focus · Discord"],"description":"The Socialit bot's per-server nickname, avatar, banner and bio. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild#modify-current-member Generic route: `/v1/accounts/{accountId}/focus/bot-persona`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-bot-persona-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"nick":{"type":["null","string"],"maxLength":32},"avatar":{"type":["null","string"]},"banner":{"type":["null","string"]},"bio":{"type":["null","string"],"maxLength":190},"roles":{"type":"array","items":{"type":"string"},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/integrations":{"get":{"operationId":"discordIntegrationsList","summary":"Discord: List Integrations","tags":["Focus · Discord"],"description":"Apps, bots and connected services installed in the server. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#get-guild-integrations Generic route: `/v1/accounts/{accountId}/focus/integrations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-integrations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["twitch","youtube","discord","guild_subscription"]},"enabled":{"type":"boolean"},"application_id":{"type":["null","string"]},"account":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"scopes":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/integrations/{itemId}":{"delete":{"operationId":"discordIntegrationsDelete","summary":"Discord: Delete a Integrations item","tags":["Focus · Discord"],"description":"Apps, bots and connected services installed in the server. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#get-guild-integrations Generic route: `/v1/accounts/{accountId}/focus/integrations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-integrations-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/server-stats":{"get":{"operationId":"discordServerStatsGet","summary":"Discord: Get Server stats","tags":["Focus · Discord"],"description":"Member and online counts (Discord has no Server Insights API; Socialit snapshots these daily) and members per role. Requires scopes: bot. Generic route: `/v1/accounts/{accountId}/focus/server-stats`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-server-stats-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"followers":{"type":"integer","description":"Approximate members"},"online_count":{"type":"integer"},"boost_count":{"type":"integer"},"boost_tier":{"type":"integer"},"roles":{"type":"array","items":{"type":"object","properties":{"role_id":{"type":"string"},"name":{"type":"string"},"members":{"type":"integer"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/channels":{"get":{"operationId":"discordChannelsList","summary":"Discord: List Channels","tags":["Focus · Discord"],"description":"Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:VIEW_CHANNEL. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","parameters":[{"schema":{"type":"array","items":{"type":"integer"}},"in":"query","name":"types","required":false,"description":"Filter by channel type"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-list","x-zernio":["GET /v1/accounts/{accountId}/discord-channels"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"integer","enum":[0,2,4,5,13,15,16],"description":"0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media"},"type_name":{"type":"string","readOnly":true},"parent_id":{"type":["null","string"],"description":"Category id"},"position":{"type":"integer"},"topic":{"type":["null","string"],"maxLength":4096},"nsfw":{"type":"boolean"},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600,"description":"Slow mode (seconds)"},"bitrate":{"type":"integer"},"user_limit":{"type":"integer"},"default_auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"available_tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":20},"moderated":{"type":"boolean"},"emoji_name":{"type":["null","string"]}}},"maxItems":20},"permission_overwrites":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"integer","enum":[0,1]},"allow":{"type":"string"},"deny":{"type":"string"}}}},"postable":{"type":"boolean","readOnly":true}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordChannelsCreate","summary":"Discord: Create a Channels item","tags":["Focus · Discord"],"description":"Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_CHANNELS. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"integer","enum":[0,2,4,5,13,15,16],"description":"0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media"},"type_name":{"type":"string","readOnly":true},"parent_id":{"type":["string","null"],"description":"Category id"},"position":{"type":"integer"},"topic":{"type":["string","null"],"maxLength":4096},"nsfw":{"type":"boolean"},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600,"description":"Slow mode (seconds)"},"bitrate":{"type":"integer"},"user_limit":{"type":"integer"},"default_auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"available_tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":20},"moderated":{"type":"boolean"},"emoji_name":{"type":["string","null"]}}},"maxItems":20},"permission_overwrites":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"integer","enum":[0,1]},"allow":{"type":"string"},"deny":{"type":"string"}}}},"postable":{"type":"boolean","readOnly":true}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"integer","enum":[0,2,4,5,13,15,16],"description":"0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media"},"type_name":{"type":"string","readOnly":true},"parent_id":{"type":["null","string"],"description":"Category id"},"position":{"type":"integer"},"topic":{"type":["null","string"],"maxLength":4096},"nsfw":{"type":"boolean"},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600,"description":"Slow mode (seconds)"},"bitrate":{"type":"integer"},"user_limit":{"type":"integer"},"default_auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"available_tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":20},"moderated":{"type":"boolean"},"emoji_name":{"type":["null","string"]}}},"maxItems":20},"permission_overwrites":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"integer","enum":[0,1]},"allow":{"type":"string"},"deny":{"type":"string"}}}},"postable":{"type":"boolean","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/channels/{itemId}":{"get":{"operationId":"discordChannelsGet","summary":"Discord: Get a Channels item","tags":["Focus · Discord"],"description":"Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"integer","enum":[0,2,4,5,13,15,16],"description":"0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media"},"type_name":{"type":"string","readOnly":true},"parent_id":{"type":["null","string"],"description":"Category id"},"position":{"type":"integer"},"topic":{"type":["null","string"],"maxLength":4096},"nsfw":{"type":"boolean"},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600,"description":"Slow mode (seconds)"},"bitrate":{"type":"integer"},"user_limit":{"type":"integer"},"default_auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"available_tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":20},"moderated":{"type":"boolean"},"emoji_name":{"type":["null","string"]}}},"maxItems":20},"permission_overwrites":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"integer","enum":[0,1]},"allow":{"type":"string"},"deny":{"type":"string"}}}},"postable":{"type":"boolean","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordChannelsUpdate","summary":"Discord: Update a Channels item","tags":["Focus · Discord"],"description":"Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_CHANNELS. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":100},"type":{"type":"integer","enum":[0,2,4,5,13,15,16],"description":"0 text, 2 voice, 4 category, 5 announcement, 13 stage, 15 forum, 16 media"},"type_name":{"type":"string","readOnly":true},"parent_id":{"type":["null","string"],"description":"Category id"},"position":{"type":"integer"},"topic":{"type":["null","string"],"maxLength":4096},"nsfw":{"type":"boolean"},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600,"description":"Slow mode (seconds)"},"bitrate":{"type":"integer"},"user_limit":{"type":"integer"},"default_auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"available_tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":20},"moderated":{"type":"boolean"},"emoji_name":{"type":["null","string"]}}},"maxItems":20},"permission_overwrites":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"integer","enum":[0,1]},"allow":{"type":"string"},"deny":{"type":"string"}}}},"postable":{"type":"boolean","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordChannelsDelete","summary":"Discord: Delete a Channels item","tags":["Focus · Discord"],"description":"Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_CHANNELS. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/channels/{itemId}/view-permissions":{"post":{"operationId":"discordChannelsViewPermissions","summary":"Discord: View permissions (Channels)","tags":["Focus · Discord"],"description":"Permission overwrites and the Socialit bot's effective permissions in this channel. Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-view-permissions","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/channels/{itemId}/set-permission":{"post":{"operationId":"discordChannelsSetPermission","summary":"Discord: Set permission overwrite (Channels)","tags":["Focus · Discord"],"description":"Set permission overwrite. Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"overwrite_id":{"type":"string","description":"Role or member id"},"type":{"type":"string","enum":["role","member"]},"allow":{"type":"array","items":{"type":"string"},"description":"Permission flag names"},"deny":{"type":"array","items":{"type":"string"}},"reason":{"type":"string","maxLength":512,"description":"Shown in the server audit log"}},"required":["overwrite_id","type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-set-permission","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/channels/{itemId}/delete-permission":{"post":{"operationId":"discordChannelsDeletePermission","summary":"Discord: Remove permission overwrite (Channels)","tags":["Focus · Discord"],"description":"Remove permission overwrite. Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Destructive. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"overwrite_id":{"type":"string"},"reason":{"type":"string","maxLength":512,"description":"Shown in the server audit log"}},"required":["overwrite_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-delete-permission","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/channels/reorder":{"post":{"operationId":"discordChannelsReorder","summary":"Discord: Reorder channels (Channels)","tags":["Focus · Discord"],"description":"One parent_id change per request (Discord rule). Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_CHANNELS. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"positions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"position":{"type":"integer"},"parent_id":{"type":["string","null"]},"lock_permissions":{"type":"boolean"}}},"minItems":1}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-reorder","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/channels/{itemId}/follow":{"post":{"operationId":"discordChannelsFollow","summary":"Discord: Follow announcements into a channel (Channels)","tags":["Focus · Discord"],"description":"Cross-server syndication of an announcement channel. Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"webhook_channel_id":{"type":"string","description":"Target channel (in a server Socialit manages)"}},"required":["webhook_channel_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/channels/{itemId}/create-invite":{"post":{"operationId":"discordChannelsCreateInvite","summary":"Discord: Create invite (Channels)","tags":["Focus · Discord"],"description":"Create invite. Text, announcement, forum, media, voice and stage channels and categories. Channels the bot cannot view are hidden by Discord. Requires scopes: bot, permission:VIEW_CHANNEL, permission:CREATE_INSTANT_INVITE. Network docs: https://docs.discord.com/developers/resources/channel Generic route: `/v1/accounts/{accountId}/focus/channels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"max_age":{"type":"integer","minimum":0,"maximum":604800,"default":86400},"max_uses":{"type":"integer","minimum":0,"maximum":100},"temporary":{"type":"boolean"},"unique":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-channels-create-invite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/threads":{"get":{"operationId":"discordThreadsList","summary":"Discord: List Threads","tags":["Focus · Discord"],"description":"Active and archived threads; create from a message or standalone, archive, lock, manage members. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads Generic route: `/v1/accounts/{accountId}/focus/threads`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"channel_id","required":false,"description":"Parent channel filter"},{"schema":{"type":"boolean"},"in":"query","name":"archived","required":false,"description":"List archived threads of channel_id"},{"schema":{"type":"boolean"},"in":"query","name":"private","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"before","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-threads-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":100},"parent_id":{"type":"string","description":"Parent channel"},"type":{"type":"integer","enum":[10,11,12],"description":"10 announcement, 11 public, 12 private"},"message_id":{"type":["null","string"],"description":"Start from this message (create)"},"archived":{"type":"boolean"},"locked":{"type":"boolean"},"invitable":{"type":"boolean"},"auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600},"applied_tags":{"type":"array","items":{"type":"string"},"maxItems":5},"message_count":{"type":"integer","readOnly":true},"member_count":{"type":"integer","readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordThreadsCreate","summary":"Discord: Create a Threads item","tags":["Focus · Discord"],"description":"Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:CREATE_PUBLIC_THREADS. Network docs: https://docs.discord.com/developers/topics/threads Generic route: `/v1/accounts/{accountId}/focus/threads`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":100},"parent_id":{"type":"string","description":"Parent channel"},"type":{"type":"integer","enum":[10,11,12],"description":"10 announcement, 11 public, 12 private"},"message_id":{"type":["string","null"],"description":"Start from this message (create)"},"archived":{"type":"boolean"},"locked":{"type":"boolean"},"invitable":{"type":"boolean"},"auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600},"applied_tags":{"type":"array","items":{"type":"string"},"maxItems":5},"message_count":{"type":"integer","readOnly":true},"member_count":{"type":"integer","readOnly":true},"owner_id":{"type":["string","null"],"readOnly":true},"created_at":{"type":["string","null"],"format":"date-time","readOnly":true}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-threads-create","x-idempotent":true,"x-zernio":["POST /v1/discord/channels/{channelId}/threads"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":100},"parent_id":{"type":"string","description":"Parent channel"},"type":{"type":"integer","enum":[10,11,12],"description":"10 announcement, 11 public, 12 private"},"message_id":{"type":["null","string"],"description":"Start from this message (create)"},"archived":{"type":"boolean"},"locked":{"type":"boolean"},"invitable":{"type":"boolean"},"auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600},"applied_tags":{"type":"array","items":{"type":"string"},"maxItems":5},"message_count":{"type":"integer","readOnly":true},"member_count":{"type":"integer","readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/threads/{itemId}":{"get":{"operationId":"discordThreadsGet","summary":"Discord: Get a Threads item","tags":["Focus · Discord"],"description":"Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads Generic route: `/v1/accounts/{accountId}/focus/threads`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-threads-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":100},"parent_id":{"type":"string","description":"Parent channel"},"type":{"type":"integer","enum":[10,11,12],"description":"10 announcement, 11 public, 12 private"},"message_id":{"type":["null","string"],"description":"Start from this message (create)"},"archived":{"type":"boolean"},"locked":{"type":"boolean"},"invitable":{"type":"boolean"},"auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600},"applied_tags":{"type":"array","items":{"type":"string"},"maxItems":5},"message_count":{"type":"integer","readOnly":true},"member_count":{"type":"integer","readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordThreadsUpdate","summary":"Discord: Update a Threads item","tags":["Focus · Discord"],"description":"Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_THREADS. Network docs: https://docs.discord.com/developers/topics/threads Generic route: `/v1/accounts/{accountId}/focus/threads`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-threads-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":100},"parent_id":{"type":"string","description":"Parent channel"},"type":{"type":"integer","enum":[10,11,12],"description":"10 announcement, 11 public, 12 private"},"message_id":{"type":["null","string"],"description":"Start from this message (create)"},"archived":{"type":"boolean"},"locked":{"type":"boolean"},"invitable":{"type":"boolean"},"auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]},"rate_limit_per_user":{"type":"integer","minimum":0,"maximum":21600},"applied_tags":{"type":"array","items":{"type":"string"},"maxItems":5},"message_count":{"type":"integer","readOnly":true},"member_count":{"type":"integer","readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordThreadsDelete","summary":"Discord: Delete a Threads item","tags":["Focus · Discord"],"description":"Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_THREADS. Network docs: https://docs.discord.com/developers/topics/threads Generic route: `/v1/accounts/{accountId}/focus/threads`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-threads-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/threads/{itemId}/join":{"post":{"operationId":"discordThreadsJoin","summary":"Discord: Join thread (Threads)","tags":["Focus · Discord"],"description":"Join thread. Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads Generic route: `/v1/accounts/{accountId}/focus/threads`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-threads-join","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/threads/{itemId}/leave":{"post":{"operationId":"discordThreadsLeave","summary":"Discord: Leave thread (Threads)","tags":["Focus · Discord"],"description":"Leave thread. Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads Generic route: `/v1/accounts/{accountId}/focus/threads`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-threads-leave","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/threads/{itemId}/add-member":{"post":{"operationId":"discordThreadsAddMember","summary":"Discord: Add member (Threads)","tags":["Focus · Discord"],"description":"Add member. Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads Generic route: `/v1/accounts/{accountId}/focus/threads`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-threads-add-member","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/threads/{itemId}/remove-member":{"post":{"operationId":"discordThreadsRemoveMember","summary":"Discord: Remove member (Threads)","tags":["Focus · Discord"],"description":"Remove member. Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_THREADS. Network docs: https://docs.discord.com/developers/topics/threads Generic route: `/v1/accounts/{accountId}/focus/threads`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-threads-remove-member","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/threads/{itemId}/members":{"post":{"operationId":"discordThreadsMembers","summary":"Discord: List members (Threads)","tags":["Focus · Discord"],"description":"Needs the privileged GUILD_MEMBERS intent. Active and archived threads; create from a message or standalone, archive, lock, manage members. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, intent:GUILD_MEMBERS. Network docs: https://docs.discord.com/developers/topics/threads Generic route: `/v1/accounts/{accountId}/focus/threads`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-threads-members","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/forum-posts":{"get":{"operationId":"discordForumPostsList","summary":"Discord: List Forum posts","tags":["Focus · Discord"],"description":"Posts in forum and media channels: create with tags, archive, lock, pin. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: `/v1/accounts/{accountId}/focus/forum-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"forum_id","required":false},{"schema":{"type":"boolean"},"in":"query","name":"archived","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"before","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-forum-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"Thread id (= starter message id)"},"forum_id":{"type":"string","description":"Forum or media channel (default: the account channel)"},"title":{"type":"string","minLength":1,"maxLength":100},"content":{"type":"string","maxLength":2000,"description":"Starter message (create)"},"media":{"type":"array","items":{"type":"string"},"maxItems":10},"applied_tags":{"type":"array","items":{"type":"string"},"maxItems":5},"archived":{"type":"boolean"},"locked":{"type":"boolean"},"pinned":{"type":"boolean"},"message_count":{"type":"integer","readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"external_id":{"type":"string","readOnly":true,"description":"Socialit post id (thread:message)"}},"required":["title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordForumPostsCreate","summary":"Discord: Create a Forum posts item","tags":["Focus · Discord"],"description":"Posts in forum and media channels: create with tags, archive, lock, pin. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:SEND_MESSAGES. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: `/v1/accounts/{accountId}/focus/forum-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"Thread id (= starter message id)"},"forum_id":{"type":"string","description":"Forum or media channel (default: the account channel)"},"title":{"type":"string","minLength":1,"maxLength":100},"content":{"type":"string","maxLength":2000,"description":"Starter message (create)"},"media":{"type":"array","items":{"type":"string"},"maxItems":10},"applied_tags":{"type":"array","items":{"type":"string"},"maxItems":5},"archived":{"type":"boolean"},"locked":{"type":"boolean"},"pinned":{"type":"boolean"},"message_count":{"type":"integer","readOnly":true},"created_at":{"type":["string","null"],"format":"date-time","readOnly":true},"external_id":{"type":"string","readOnly":true,"description":"Socialit post id (thread:message)"}},"required":["title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-forum-posts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"Thread id (= starter message id)"},"forum_id":{"type":"string","description":"Forum or media channel (default: the account channel)"},"title":{"type":"string","minLength":1,"maxLength":100},"content":{"type":"string","maxLength":2000,"description":"Starter message (create)"},"media":{"type":"array","items":{"type":"string"},"maxItems":10},"applied_tags":{"type":"array","items":{"type":"string"},"maxItems":5},"archived":{"type":"boolean"},"locked":{"type":"boolean"},"pinned":{"type":"boolean"},"message_count":{"type":"integer","readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"external_id":{"type":"string","readOnly":true,"description":"Socialit post id (thread:message)"}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/forum-posts/{itemId}":{"get":{"operationId":"discordForumPostsGet","summary":"Discord: Get a Forum posts item","tags":["Focus · Discord"],"description":"Posts in forum and media channels: create with tags, archive, lock, pin. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: `/v1/accounts/{accountId}/focus/forum-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-forum-posts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"Thread id (= starter message id)"},"forum_id":{"type":"string","description":"Forum or media channel (default: the account channel)"},"title":{"type":"string","minLength":1,"maxLength":100},"content":{"type":"string","maxLength":2000,"description":"Starter message (create)"},"media":{"type":"array","items":{"type":"string"},"maxItems":10},"applied_tags":{"type":"array","items":{"type":"string"},"maxItems":5},"archived":{"type":"boolean"},"locked":{"type":"boolean"},"pinned":{"type":"boolean"},"message_count":{"type":"integer","readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"external_id":{"type":"string","readOnly":true,"description":"Socialit post id (thread:message)"}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordForumPostsUpdate","summary":"Discord: Update a Forum posts item","tags":["Focus · Discord"],"description":"Posts in forum and media channels: create with tags, archive, lock, pin. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_THREADS. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: `/v1/accounts/{accountId}/focus/forum-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-forum-posts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"Thread id (= starter message id)"},"forum_id":{"type":"string","description":"Forum or media channel (default: the account channel)"},"title":{"type":"string","minLength":1,"maxLength":100},"content":{"type":"string","maxLength":2000,"description":"Starter message (create)"},"media":{"type":"array","items":{"type":"string"},"maxItems":10},"applied_tags":{"type":"array","items":{"type":"string"},"maxItems":5},"archived":{"type":"boolean"},"locked":{"type":"boolean"},"pinned":{"type":"boolean"},"message_count":{"type":"integer","readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"external_id":{"type":"string","readOnly":true,"description":"Socialit post id (thread:message)"}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordForumPostsDelete","summary":"Discord: Delete a Forum posts item","tags":["Focus · Discord"],"description":"Posts in forum and media channels: create with tags, archive, lock, pin. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_THREADS. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: `/v1/accounts/{accountId}/focus/forum-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-forum-posts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/forum-posts/set-tags":{"post":{"operationId":"discordForumPostsSetTags","summary":"Discord: Edit forum tags (Forum posts)","tags":["Focus · Discord"],"description":"Edit forum tags. Posts in forum and media channels: create with tags, archive, lock, pin. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_CHANNELS. Network docs: https://docs.discord.com/developers/topics/threads#forums Generic route: `/v1/accounts/{accountId}/focus/forum-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"forum_id":{"type":"string"},"available_tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":"string","maxLength":20},"moderated":{"type":"boolean"},"emoji_name":{"type":["string","null"]},"emoji_id":{"type":["string","null"]}}},"maxItems":20}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-forum-posts-set-tags","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/webhooks":{"get":{"operationId":"discordWebhooksList","summary":"Discord: List Webhooks","tags":["Focus · Discord"],"description":"Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: `/v1/accounts/{accountId}/focus/webhooks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"channel_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-webhooks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":80},"channel_id":{"type":"string"},"avatar":{"type":["null","string"],"description":"Avatar image (write)"},"type":{"type":"integer","readOnly":true,"description":"1 incoming, 2 channel follower, 3 application"},"application_id":{"type":["null","string"],"readOnly":true},"owned_by_socialit":{"type":"boolean","readOnly":true},"creator":{"type":["null","string"],"readOnly":true}},"required":["name","channel_id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordWebhooksCreate","summary":"Discord: Create a Webhooks item","tags":["Focus · Discord"],"description":"Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: `/v1/accounts/{accountId}/focus/webhooks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":80},"channel_id":{"type":"string"},"avatar":{"type":["string","null"],"description":"Avatar image (write)"},"type":{"type":"integer","readOnly":true,"description":"1 incoming, 2 channel follower, 3 application"},"application_id":{"type":["string","null"],"readOnly":true},"owned_by_socialit":{"type":"boolean","readOnly":true},"creator":{"type":["string","null"],"readOnly":true}},"required":["name","channel_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-webhooks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":80},"channel_id":{"type":"string"},"avatar":{"type":["null","string"],"description":"Avatar image (write)"},"type":{"type":"integer","readOnly":true,"description":"1 incoming, 2 channel follower, 3 application"},"application_id":{"type":["null","string"],"readOnly":true},"owned_by_socialit":{"type":"boolean","readOnly":true},"creator":{"type":["null","string"],"readOnly":true}},"required":["name","channel_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/webhooks/{itemId}":{"get":{"operationId":"discordWebhooksGet","summary":"Discord: Get a Webhooks item","tags":["Focus · Discord"],"description":"Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: `/v1/accounts/{accountId}/focus/webhooks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-webhooks-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":80},"channel_id":{"type":"string"},"avatar":{"type":["null","string"],"description":"Avatar image (write)"},"type":{"type":"integer","readOnly":true,"description":"1 incoming, 2 channel follower, 3 application"},"application_id":{"type":["null","string"],"readOnly":true},"owned_by_socialit":{"type":"boolean","readOnly":true},"creator":{"type":["null","string"],"readOnly":true}},"required":["name","channel_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordWebhooksUpdate","summary":"Discord: Update a Webhooks item","tags":["Focus · Discord"],"description":"Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: `/v1/accounts/{accountId}/focus/webhooks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-webhooks-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":80},"channel_id":{"type":"string"},"avatar":{"type":["null","string"],"description":"Avatar image (write)"},"type":{"type":"integer","readOnly":true,"description":"1 incoming, 2 channel follower, 3 application"},"application_id":{"type":["null","string"],"readOnly":true},"owned_by_socialit":{"type":"boolean","readOnly":true},"creator":{"type":["null","string"],"readOnly":true}},"required":["name","channel_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordWebhooksDelete","summary":"Discord: Delete a Webhooks item","tags":["Focus · Discord"],"description":"Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: `/v1/accounts/{accountId}/focus/webhooks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-webhooks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/webhooks/{itemId}/send":{"post":{"operationId":"discordWebhooksSend","summary":"Discord: Send test message (Webhooks)","tags":["Focus · Discord"],"description":"Send test message. Channel webhooks (≤15 per channel, ≤1000 per server). Tokens are never shown. Requires scopes: bot, permission:MANAGE_WEBHOOKS. Network docs: https://docs.discord.com/developers/resources/webhook Generic route: `/v1/accounts/{accountId}/focus/webhooks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":2000},"username":{"type":"string","maxLength":80},"avatar_url":{"type":"string","format":"uri"}},"required":["content"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-webhooks-send","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/stage-instances":{"get":{"operationId":"discordStageInstancesList","summary":"Discord: List Stage instances","tags":["Focus · Discord"],"description":"Live Stage sessions (topic, start notification, linked event). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:MANAGE_CHANNELS, permission:MUTE_MEMBERS, permission:MOVE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/stage-instance Generic route: `/v1/accounts/{accountId}/focus/stage-instances`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-stage-instances-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"topic":{"type":"string","minLength":1,"maxLength":120},"privacy_level":{"type":"integer","enum":[2],"readOnly":true},"send_start_notification":{"type":"boolean","description":"Notify @everyone (MENTION_EVERYONE)"},"guild_scheduled_event_id":{"type":["null","string"]}},"required":["channel_id","topic"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordStageInstancesCreate","summary":"Discord: Create a Stage instances item","tags":["Focus · Discord"],"description":"Live Stage sessions (topic, start notification, linked event). Requires scopes: bot, permission:MANAGE_CHANNELS, permission:MUTE_MEMBERS, permission:MOVE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/stage-instance Generic route: `/v1/accounts/{accountId}/focus/stage-instances`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"topic":{"type":"string","minLength":1,"maxLength":120},"privacy_level":{"type":"integer","enum":[2],"readOnly":true},"send_start_notification":{"type":"boolean","description":"Notify @everyone (MENTION_EVERYONE)"},"guild_scheduled_event_id":{"type":["string","null"]}},"required":["channel_id","topic"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-stage-instances-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"topic":{"type":"string","minLength":1,"maxLength":120},"privacy_level":{"type":"integer","enum":[2],"readOnly":true},"send_start_notification":{"type":"boolean","description":"Notify @everyone (MENTION_EVERYONE)"},"guild_scheduled_event_id":{"type":["null","string"]}},"required":["channel_id","topic"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/stage-instances/{itemId}":{"get":{"operationId":"discordStageInstancesGet","summary":"Discord: Get a Stage instances item","tags":["Focus · Discord"],"description":"Live Stage sessions (topic, start notification, linked event). Requires scopes: bot, permission:MANAGE_CHANNELS, permission:MUTE_MEMBERS, permission:MOVE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/stage-instance Generic route: `/v1/accounts/{accountId}/focus/stage-instances`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-stage-instances-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"topic":{"type":"string","minLength":1,"maxLength":120},"privacy_level":{"type":"integer","enum":[2],"readOnly":true},"send_start_notification":{"type":"boolean","description":"Notify @everyone (MENTION_EVERYONE)"},"guild_scheduled_event_id":{"type":["null","string"]}},"required":["channel_id","topic"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordStageInstancesUpdate","summary":"Discord: Update a Stage instances item","tags":["Focus · Discord"],"description":"Live Stage sessions (topic, start notification, linked event). Requires scopes: bot, permission:MANAGE_CHANNELS, permission:MUTE_MEMBERS, permission:MOVE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/stage-instance Generic route: `/v1/accounts/{accountId}/focus/stage-instances`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-stage-instances-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"topic":{"type":"string","minLength":1,"maxLength":120},"privacy_level":{"type":"integer","enum":[2],"readOnly":true},"send_start_notification":{"type":"boolean","description":"Notify @everyone (MENTION_EVERYONE)"},"guild_scheduled_event_id":{"type":["null","string"]}},"required":["channel_id","topic"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordStageInstancesDelete","summary":"Discord: Delete a Stage instances item","tags":["Focus · Discord"],"description":"Live Stage sessions (topic, start notification, linked event). Requires scopes: bot, permission:MANAGE_CHANNELS, permission:MUTE_MEMBERS, permission:MOVE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/stage-instance Generic route: `/v1/accounts/{accountId}/focus/stage-instances`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-stage-instances-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages":{"get":{"operationId":"discordMessagesList","summary":"Discord: List Messages","tags":["Focus · Discord"],"description":"Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"channel_id","required":false,"description":"Channel or thread (default: the account channel)"},{"schema":{"type":"string"},"in":"query","name":"before","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"string"},"in":"query","name":"around","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"channelId:messageId"},"message_id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"text":{"type":["null","string"],"maxLength":2000},"author":{"type":["null","string"],"readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"edited_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"count":{"type":"integer"},"me":{"type":"boolean"}}},"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"filename":{"type":"string"},"content_type":{"type":["null","string"]}}},"readOnly":true},"embeds":{"type":"array","items":{"type":"object","properties":{}},"readOnly":true},"content_restricted":{"type":"boolean","readOnly":true,"description":"Content withheld by Discord (MESSAGE_CONTENT intent missing)"},"url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordMessagesCreate","summary":"Discord: Create a Messages item","tags":["Focus · Discord"],"description":"Send now (same engine as publishing). Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:SEND_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel_id":{"type":"string","description":"Default: the account channel"},"text":{"type":"string","maxLength":2000},"media":{"type":"array","items":{"type":"string"},"maxItems":10},"reply_to_id":{"type":"string","description":"channel:message to reply to"},"options":{"type":"object","properties":{"channelId":{"type":"string","description":"Target channel snowflake (default: the account channel). Must be in the connected server."},"threadId":{"type":"string","description":"Post into an existing thread / forum post instead of the channel."},"embeds":{"type":"array","maxItems":10,"items":{"type":"object","properties":{"title":{"type":"string","maxLength":256},"description":{"type":"string","maxLength":4096},"url":{"type":"string","format":"uri"},"color":{"oneOf":[{"type":"integer"},{"type":"string","pattern":"^#?[0-9a-fA-F]{6}$"}],"description":"Decimal or #RRGGBB"},"timestamp":{"type":"string","format":"date-time"},"image":{"type":"object","properties":{"url":{"type":"string"}}},"thumbnail":{"type":"object","properties":{"url":{"type":"string"}}},"footer":{"type":"object","properties":{"text":{"type":"string","maxLength":2048},"icon_url":{"type":"string"}}},"author":{"type":"object","properties":{"name":{"type":"string","maxLength":256},"url":{"type":"string"},"icon_url":{"type":"string"}}},"fields":{"type":"array","maxItems":25,"items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string","maxLength":256},"value":{"type":"string","maxLength":1024},"inline":{"type":"boolean"}}}}}},"description":"Rich embeds; ≤6,000 chars combined."},"poll":{"type":"object","description":"Native poll (cannot be edited; no attachments). Discord shape or { question: string, options: string[], durationHours, multiselect }.","properties":{"question":{"oneOf":[{"type":"string","maxLength":300},{"type":"object","properties":{"text":{"type":"string","maxLength":300}}}]},"answers":{"type":"array","minItems":1,"maxItems":10},"options":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","maxLength":55}},"duration":{"type":"integer","minimum":1,"maximum":768,"default":24},"durationHours":{"type":"integer","minimum":1,"maximum":768},"allow_multiselect":{"type":"boolean","default":false},"multiselect":{"type":"boolean"}}},"crosspost":{"type":"boolean","default":false,"description":"Publish to followers when the channel is an announcement channel (10/hour/channel)."},"forumThreadName":{"type":"string","maxLength":100,"description":"Forum/media post title (required for forum channels; defaults to the first line)."},"forumAppliedTags":{"type":"array","maxItems":5,"items":{"type":"string"},"description":"Forum tag ids."},"autoArchiveDuration":{"type":"integer","enum":[60,1440,4320,10080],"description":"Forum post auto-archive (minutes)."},"rateLimitPerUser":{"type":"integer","minimum":0,"maximum":21600,"description":"Forum post slow mode (seconds)."},"threadFromMessage":{"type":"object","description":"Open a public thread under the published message.","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"autoArchiveDuration":{"type":"integer","enum":[60,1440,4320,10080]},"rateLimitPerUser":{"type":"integer","minimum":0,"maximum":21600}}},"tts":{"type":"boolean","default":false},"silent":{"type":"boolean","default":false,"description":"SUPPRESS_NOTIFICATIONS flag."},"suppressEmbeds":{"type":"boolean","default":false,"description":"Hide link previews."},"mentions":{"type":"string","enum":["none","users","roles","everyone"],"default":"none","description":"Which mentions in the content ping (default none; \"everyone\" needs MENTION_EVERYONE)."},"allowedMentions":{"type":"object","description":"Raw Discord allowed_mentions (overrides `mentions`)."},"buttons":{"type":"array","maxItems":25,"items":{"type":"object","required":["label","url"],"properties":{"label":{"type":"string","maxLength":80},"url":{"type":"string","format":"uri"},"emoji":{"type":"string"}}},"description":"Link buttons (rendered as action rows of up to 5)."},"components":{"type":"array","description":"Raw message components (action rows or Components V2 layout)."},"componentsV2":{"type":"boolean","description":"Send `components` as a Components V2 layout (IS_COMPONENTS_V2; content/embeds/poll disabled; irreversible)."},"stickerIds":{"type":"array","maxItems":3,"items":{"type":"string"}},"pin":{"type":"boolean","description":"Pin the message after publishing (PIN_MESSAGES)."},"webhookUsername":{"type":"string","minLength":1,"maxLength":80,"description":"Per-post display name (may not contain \"clyde\"/\"discord\")."},"webhookAvatarUrl":{"type":"string","format":"uri","description":"Per-post avatar URL."},"nonce":{"type":"string","maxLength":25,"description":"Idempotency nonce (enforce_nonce)."}},"description":"Same options as platform_options.discord"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-create","x-idempotent":true,"x-zernio":["POST /v1/discord/channels/{channelId}/messages/{messageId}/crosspost"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"channelId:messageId"},"message_id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"text":{"type":["null","string"],"maxLength":2000},"author":{"type":["null","string"],"readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"edited_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"count":{"type":"integer"},"me":{"type":"boolean"}}},"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"filename":{"type":"string"},"content_type":{"type":["null","string"]}}},"readOnly":true},"embeds":{"type":"array","items":{"type":"object","properties":{}},"readOnly":true},"content_restricted":{"type":"boolean","readOnly":true,"description":"Content withheld by Discord (MESSAGE_CONTENT intent missing)"},"url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}":{"get":{"operationId":"discordMessagesGet","summary":"Discord: Get a Messages item","tags":["Focus · Discord"],"description":"Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"channelId:messageId"},"message_id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"text":{"type":["null","string"],"maxLength":2000},"author":{"type":["null","string"],"readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"edited_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"count":{"type":"integer"},"me":{"type":"boolean"}}},"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"filename":{"type":"string"},"content_type":{"type":["null","string"]}}},"readOnly":true},"embeds":{"type":"array","items":{"type":"object","properties":{}},"readOnly":true},"content_restricted":{"type":"boolean","readOnly":true,"description":"Content withheld by Discord (MESSAGE_CONTENT intent missing)"},"url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordMessagesUpdate","summary":"Discord: Update a Messages item","tags":["Focus · Discord"],"description":"Edit Socialit's own messages (others' messages only allow suppressing embeds). Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"channelId:messageId"},"message_id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"text":{"type":["null","string"],"maxLength":2000},"author":{"type":["null","string"],"readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"edited_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"count":{"type":"integer"},"me":{"type":"boolean"}}},"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"filename":{"type":"string"},"content_type":{"type":["null","string"]}}},"readOnly":true},"embeds":{"type":"array","items":{"type":"object","properties":{}},"readOnly":true},"content_restricted":{"type":"boolean","readOnly":true,"description":"Content withheld by Discord (MESSAGE_CONTENT intent missing)"},"url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordMessagesDelete","summary":"Discord: Delete a Messages item","tags":["Focus · Discord"],"description":"Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-delete","x-zernio":["DELETE /v1/discord/channels/{channelId}/messages/{messageId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}/pin":{"post":{"operationId":"discordMessagesPin","summary":"Discord: Pin (Messages)","tags":["Focus · Discord"],"description":"Pin. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:PIN_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-pin","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}/unpin":{"post":{"operationId":"discordMessagesUnpin","summary":"Discord: Unpin (Messages)","tags":["Focus · Discord"],"description":"Unpin. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:PIN_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-unpin","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}/crosspost":{"post":{"operationId":"discordMessagesCrosspost","summary":"Discord: Publish to followers (Messages)","tags":["Focus · Discord"],"description":"Announcement channels only; 10 per hour per channel. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-crosspost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}/react":{"post":{"operationId":"discordMessagesReact","summary":"Discord: React (Messages)","tags":["Focus · Discord"],"description":"React. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:ADD_REACTIONS. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"emoji":{"type":"string","description":"Unicode emoji or name:id"}},"required":["emoji"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-react","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}/unreact":{"post":{"operationId":"discordMessagesUnreact","summary":"Discord: Remove my reaction (Messages)","tags":["Focus · Discord"],"description":"Remove my reaction. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"emoji":{"type":"string"}},"required":["emoji"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-unreact","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}/clear-reactions":{"post":{"operationId":"discordMessagesClearReactions","summary":"Discord: Clear reactions (Messages)","tags":["Focus · Discord"],"description":"Clear reactions. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Destructive. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"emoji":{"type":"string","description":"Only this emoji (optional)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-clear-reactions","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}/reactors":{"post":{"operationId":"discordMessagesReactors","summary":"Discord: Who reacted (Messages)","tags":["Focus · Discord"],"description":"Who reacted. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"emoji":{"type":"string"},"type":{"type":"integer","enum":[0,1],"description":"0 normal, 1 super"},"after":{"type":"string"},"limit":{"type":"integer","maximum":100}},"required":["emoji"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-reactors","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}/create-thread":{"post":{"operationId":"discordMessagesCreateThread","summary":"Discord: Start thread (Messages)","tags":["Focus · Discord"],"description":"Start thread. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:CREATE_PUBLIC_THREADS. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":100},"auto_archive_duration":{"type":"integer","enum":[60,1440,4320,10080]}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-create-thread","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}/end-poll":{"post":{"operationId":"discordMessagesEndPoll","summary":"Discord: End poll (Messages)","tags":["Focus · Discord"],"description":"End poll. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-end-poll","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/{itemId}/poll-voters":{"post":{"operationId":"discordMessagesPollVoters","summary":"Discord: Poll voters (Messages)","tags":["Focus · Discord"],"description":"Poll voters. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"answer_id":{"type":"integer"},"after":{"type":"string"},"limit":{"type":"integer","maximum":100}},"required":["answer_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-poll-voters","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/search":{"post":{"operationId":"discordMessagesSearch","summary":"Discord: Search messages (Messages)","tags":["Focus · Discord"],"description":"Guild message search; returns indexing=true with retry_after while Discord builds the index. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, intent:MESSAGE_CONTENT. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string"},"author_id":{"type":"string"},"channel_id":{"type":"string"},"mentions":{"type":"string"},"has":{"type":"string","enum":["link","embed","file","poll","image","video","sound","sticker","snapshot"]},"pinned":{"type":"boolean"},"limit":{"type":"integer","minimum":1,"maximum":25},"offset":{"type":"integer","minimum":0,"maximum":9975}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-search","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/messages/bulk-delete":{"post":{"operationId":"discordMessagesBulkDelete","summary":"Discord: Bulk delete (Messages)","tags":["Focus · Discord"],"description":"2-100 messages younger than 14 days. Channel and thread history. Without the MESSAGE_CONTENT intent Discord withholds other users' message content (content_restricted). Destructive. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:MANAGE_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel_id":{"type":"string"},"message_ids":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":100},"reason":{"type":"string","maxLength":512,"description":"Shown in the server audit log"}},"required":["message_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_discord","x-mcp-tool":"discord-messages-bulk-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/pins":{"get":{"operationId":"discordPinsList","summary":"Discord: List Pinned messages","tags":["Focus · Discord"],"description":"Pins per channel (≤250 per channel). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY. Network docs: https://docs.discord.com/developers/resources/message#get-channel-pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"channel_id","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"before","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-pins-list","x-zernio":["GET /v1/discord/channels/{channelId}/pins"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"channelId:messageId"},"message_id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"text":{"type":["null","string"],"maxLength":2000},"author":{"type":["null","string"],"readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"edited_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"count":{"type":"integer"},"me":{"type":"boolean"}}},"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"filename":{"type":"string"},"content_type":{"type":["null","string"]}}},"readOnly":true},"embeds":{"type":"array","items":{"type":"object","properties":{}},"readOnly":true},"content_restricted":{"type":"boolean","readOnly":true,"description":"Content withheld by Discord (MESSAGE_CONTENT intent missing)"},"url":{"type":"string","format":"uri","readOnly":true},"pinned_at":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordPinsCreate","summary":"Discord: Create a Pinned messages item","tags":["Focus · Discord"],"description":"Pins per channel (≤250 per channel). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:PIN_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message#get-channel-pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message_id":{"type":"string","description":"channel:message or message id"},"channel_id":{"type":"string"}},"required":["message_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-pins-create","x-idempotent":true,"x-zernio":["PUT /v1/discord/channels/{channelId}/pins/{messageId}"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"channelId:messageId"},"message_id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"text":{"type":["null","string"],"maxLength":2000},"author":{"type":["null","string"],"readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"edited_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"count":{"type":"integer"},"me":{"type":"boolean"}}},"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"filename":{"type":"string"},"content_type":{"type":["null","string"]}}},"readOnly":true},"embeds":{"type":"array","items":{"type":"object","properties":{}},"readOnly":true},"content_restricted":{"type":"boolean","readOnly":true,"description":"Content withheld by Discord (MESSAGE_CONTENT intent missing)"},"url":{"type":"string","format":"uri","readOnly":true},"pinned_at":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/pins/{itemId}":{"delete":{"operationId":"discordPinsDelete","summary":"Discord: Delete a Pinned messages item","tags":["Focus · Discord"],"description":"Pins per channel (≤250 per channel). Requires scopes: bot, permission:VIEW_CHANNEL, permission:READ_MESSAGE_HISTORY, permission:PIN_MESSAGES. Network docs: https://docs.discord.com/developers/resources/message#get-channel-pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-pins-delete","x-zernio":["DELETE /v1/discord/channels/{channelId}/pins/{messageId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/direct-messages":{"post":{"operationId":"discordDirectMessagesCreate","summary":"Discord: Create a Direct messages item","tags":["Focus · Discord"],"description":"Send a DM from the Socialit bot to a member of this server. DMs should be user-initiated; Discord blocks mass DMs. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/user#create-dm Generic route: `/v1/accounts/{accountId}/focus/direct-messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-direct-messages-create","x-idempotent":true,"x-zernio":["POST /v1/discord/dms"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","pattern":"^\\d{15,21}$"},"content":{"type":"string","maxLength":2000},"embeds":{"type":"array","items":{"type":"object","properties":{}},"maxItems":10},"attachments":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif","document"]},"filename":{"type":"string"},"mimeType":{"type":"string"}}},"maxItems":10},"tts":{"type":"boolean"}},"required":["userId"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/engagement":{"get":{"operationId":"discordEngagementList","summary":"Discord: List Post engagement","tags":["Focus · Discord"],"description":"Reactions and replies on recent messages (Discord exposes no views or reach). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:READ_MESSAGE_HISTORY. Generic route: `/v1/accounts/{accountId}/focus/engagement`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"channel_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"only_socialit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-engagement-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"text":{"type":["null","string"]},"likes":{"type":"integer","description":"Reactions"},"comments":{"type":"integer","description":"Thread + inline replies"},"reactions":{"type":"array","items":{"type":"object","properties":{"emoji":{"type":"string"},"count":{"type":"integer"}}}},"poll":{"type":["null","object"],"properties":{}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members":{"get":{"operationId":"discordMembersList","summary":"Discord: List Members","tags":["Focus · Discord"],"description":"Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, intent:GUILD_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":1000,"default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"string"},"in":"query","name":"query","required":false,"description":"Prefix search instead of listing"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-members-list","x-zernio":["GET /v1/discord/guilds/{guildId}/members","GET /v1/discord/guilds/{guildId}/members/search"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":["null","string"],"readOnly":true},"global_name":{"type":["null","string"],"readOnly":true},"nick":{"type":["null","string"],"maxLength":32},"display_name":{"type":["null","string"],"readOnly":true},"bot":{"type":"boolean","readOnly":true},"roles":{"type":"array","items":{"type":"string"}},"joined_at":{"type":["null","string"],"format":"date-time","readOnly":true},"premium_since":{"type":["null","string"],"format":"date-time","readOnly":true},"pending":{"type":"boolean","readOnly":true},"communication_disabled_until":{"type":["null","string"],"format":"date-time","description":"Timeout end (≤28 days)"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members/{itemId}":{"get":{"operationId":"discordMembersGet","summary":"Discord: Get a Members item","tags":["Focus · Discord"],"description":"Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-members-get","x-zernio":["GET /v1/discord/guilds/{guildId}/members/{userId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":["null","string"],"readOnly":true},"global_name":{"type":["null","string"],"readOnly":true},"nick":{"type":["null","string"],"maxLength":32},"display_name":{"type":["null","string"],"readOnly":true},"bot":{"type":"boolean","readOnly":true},"roles":{"type":"array","items":{"type":"string"}},"joined_at":{"type":["null","string"],"format":"date-time","readOnly":true},"premium_since":{"type":["null","string"],"format":"date-time","readOnly":true},"pending":{"type":"boolean","readOnly":true},"communication_disabled_until":{"type":["null","string"],"format":"date-time","description":"Timeout end (≤28 days)"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordMembersUpdate","summary":"Discord: Update a Members item","tags":["Focus · Discord"],"description":"nick (MANAGE_NICKNAMES), roles (MANAGE_ROLES), communication_disabled_until (MODERATE_MEMBERS). Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MANAGE_NICKNAMES. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-members-update","x-zernio":["PUT /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":["null","string"],"readOnly":true},"global_name":{"type":["null","string"],"readOnly":true},"nick":{"type":["null","string"],"maxLength":32},"display_name":{"type":["null","string"],"readOnly":true},"bot":{"type":"boolean","readOnly":true},"roles":{"type":"array","items":{"type":"string"}},"joined_at":{"type":["null","string"],"format":"date-time","readOnly":true},"premium_since":{"type":["null","string"],"format":"date-time","readOnly":true},"pending":{"type":"boolean","readOnly":true},"communication_disabled_until":{"type":["null","string"],"format":"date-time","description":"Timeout end (≤28 days)"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordMembersDelete","summary":"Discord: Delete a Members item","tags":["Focus · Discord"],"description":"Kick. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:KICK_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-members-delete","x-zernio":["DELETE /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members/search":{"post":{"operationId":"discordMembersSearch","summary":"Discord: Search (Members)","tags":["Focus · Discord"],"description":"Search. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":25}},"required":["query"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-members-search","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members/{itemId}/add-role":{"post":{"operationId":"discordMembersAddRole","summary":"Discord: Add role (Members)","tags":["Focus · Discord"],"description":"Add role. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role_id":{"type":"string"},"reason":{"type":"string","maxLength":512,"description":"Shown in the server audit log"}},"required":["role_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-members-add-role","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members/{itemId}/remove-role":{"post":{"operationId":"discordMembersRemoveRole","summary":"Discord: Remove role (Members)","tags":["Focus · Discord"],"description":"Remove role. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role_id":{"type":"string"},"reason":{"type":"string","maxLength":512,"description":"Shown in the server audit log"}},"required":["role_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-members-remove-role","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members/{itemId}/timeout":{"post":{"operationId":"discordMembersTimeout","summary":"Discord: Timeout (Members)","tags":["Focus · Discord"],"description":"Up to 28 days. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MODERATE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"duration_seconds":{"type":"integer","minimum":60,"maximum":2419200},"until":{"type":"string","format":"date-time"},"reason":{"type":"string","maxLength":512,"description":"Shown in the server audit log"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-members-timeout","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members/{itemId}/remove-timeout":{"post":{"operationId":"discordMembersRemoveTimeout","summary":"Discord: Remove timeout (Members)","tags":["Focus · Discord"],"description":"Remove timeout. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MODERATE_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-members-remove-timeout","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members/{itemId}/kick":{"post":{"operationId":"discordMembersKick","summary":"Discord: Kick (Members)","tags":["Focus · Discord"],"description":"Kick. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Destructive. Requires scopes: bot, permission:KICK_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":512,"description":"Shown in the server audit log"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_discord","x-mcp-tool":"discord-members-kick","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members/{itemId}/ban":{"post":{"operationId":"discordMembersBan","summary":"Discord: Ban (Members)","tags":["Focus · Discord"],"description":"Ban. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Destructive. Requires scopes: bot, permission:BAN_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"delete_message_seconds":{"type":"integer","minimum":0,"maximum":604800},"reason":{"type":"string","maxLength":512,"description":"Shown in the server audit log"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_discord","x-mcp-tool":"discord-members-ban","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members/prune-count":{"post":{"operationId":"discordMembersPruneCount","summary":"Discord: Preview prune (Members)","tags":["Focus · Discord"],"description":"Preview prune. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Requires scopes: bot, permission:MANAGE_GUILD, permission:KICK_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"days":{"type":"integer","minimum":1,"maximum":30,"default":7},"include_roles":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-members-prune-count","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/members/prune":{"post":{"operationId":"discordMembersPrune","summary":"Discord: Prune inactive members (Members)","tags":["Focus · Discord"],"description":"Prune inactive members. Server members: search, roles, nicknames and moderation. Listing every member needs the privileged GUILD_MEMBERS intent; search and lookup do not. Destructive. Requires scopes: bot, permission:MANAGE_GUILD, permission:KICK_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#guild-member-object Generic route: `/v1/accounts/{accountId}/focus/members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"days":{"type":"integer","minimum":1,"maximum":30},"include_roles":{"type":"array","items":{"type":"string"}},"reason":{"type":"string","maxLength":512,"description":"Shown in the server audit log"}},"required":["days"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_discord","x-mcp-tool":"discord-members-prune","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/roles":{"get":{"operationId":"discordRolesList","summary":"Discord: List Roles","tags":["Focus · Discord"],"description":"Roles with member counts. The Socialit bot can only manage roles below its own highest role. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: `/v1/accounts/{accountId}/focus/roles`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-roles-list","x-zernio":["GET /v1/discord/guilds/{guildId}/roles"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"color":{"type":"integer","description":"Primary color (decimal)"},"colors":{"type":["null","object"],"properties":{"primary_color":{"type":"integer"},"secondary_color":{"type":["null","integer"]},"tertiary_color":{"type":["null","integer"]}}},"position":{"type":"integer","readOnly":true},"permissions":{"type":"string","description":"Permission bitfield (string) or array of flag names on write"},"permission_names":{"type":"array","items":{"type":"string"},"readOnly":true},"managed":{"type":"boolean","readOnly":true},"mentionable":{"type":"boolean"},"hoist":{"type":"boolean","description":"Show separately in the member list"},"unicode_emoji":{"type":["null","string"]},"member_count":{"type":["null","integer"],"readOnly":true}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordRolesCreate","summary":"Discord: Create a Roles item","tags":["Focus · Discord"],"description":"Roles with member counts. The Socialit bot can only manage roles below its own highest role. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: `/v1/accounts/{accountId}/focus/roles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"color":{"type":"integer","description":"Primary color (decimal)"},"colors":{"type":["object","null"],"properties":{"primary_color":{"type":"integer"},"secondary_color":{"type":["integer","null"]},"tertiary_color":{"type":["integer","null"]}}},"position":{"type":"integer","readOnly":true},"permissions":{"type":"string","description":"Permission bitfield (string) or array of flag names on write"},"permission_names":{"type":"array","items":{"type":"string"},"readOnly":true},"managed":{"type":"boolean","readOnly":true},"mentionable":{"type":"boolean"},"hoist":{"type":"boolean","description":"Show separately in the member list"},"unicode_emoji":{"type":["string","null"]},"member_count":{"type":["integer","null"],"readOnly":true}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-roles-create","x-idempotent":true,"x-zernio":["POST /v1/discord/guilds/{guildId}/roles"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"color":{"type":"integer","description":"Primary color (decimal)"},"colors":{"type":["null","object"],"properties":{"primary_color":{"type":"integer"},"secondary_color":{"type":["null","integer"]},"tertiary_color":{"type":["null","integer"]}}},"position":{"type":"integer","readOnly":true},"permissions":{"type":"string","description":"Permission bitfield (string) or array of flag names on write"},"permission_names":{"type":"array","items":{"type":"string"},"readOnly":true},"managed":{"type":"boolean","readOnly":true},"mentionable":{"type":"boolean"},"hoist":{"type":"boolean","description":"Show separately in the member list"},"unicode_emoji":{"type":["null","string"]},"member_count":{"type":["null","integer"],"readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/roles/{itemId}":{"get":{"operationId":"discordRolesGet","summary":"Discord: Get a Roles item","tags":["Focus · Discord"],"description":"Roles with member counts. The Socialit bot can only manage roles below its own highest role. Requires scopes: bot. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: `/v1/accounts/{accountId}/focus/roles`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-roles-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"color":{"type":"integer","description":"Primary color (decimal)"},"colors":{"type":["null","object"],"properties":{"primary_color":{"type":"integer"},"secondary_color":{"type":["null","integer"]},"tertiary_color":{"type":["null","integer"]}}},"position":{"type":"integer","readOnly":true},"permissions":{"type":"string","description":"Permission bitfield (string) or array of flag names on write"},"permission_names":{"type":"array","items":{"type":"string"},"readOnly":true},"managed":{"type":"boolean","readOnly":true},"mentionable":{"type":"boolean"},"hoist":{"type":"boolean","description":"Show separately in the member list"},"unicode_emoji":{"type":["null","string"]},"member_count":{"type":["null","integer"],"readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordRolesUpdate","summary":"Discord: Update a Roles item","tags":["Focus · Discord"],"description":"Roles with member counts. The Socialit bot can only manage roles below its own highest role. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: `/v1/accounts/{accountId}/focus/roles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-roles-update","x-zernio":["PATCH /v1/discord/guilds/{guildId}/roles/{roleId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"color":{"type":"integer","description":"Primary color (decimal)"},"colors":{"type":["null","object"],"properties":{"primary_color":{"type":"integer"},"secondary_color":{"type":["null","integer"]},"tertiary_color":{"type":["null","integer"]}}},"position":{"type":"integer","readOnly":true},"permissions":{"type":"string","description":"Permission bitfield (string) or array of flag names on write"},"permission_names":{"type":"array","items":{"type":"string"},"readOnly":true},"managed":{"type":"boolean","readOnly":true},"mentionable":{"type":"boolean"},"hoist":{"type":"boolean","description":"Show separately in the member list"},"unicode_emoji":{"type":["null","string"]},"member_count":{"type":["null","integer"],"readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordRolesDelete","summary":"Discord: Delete a Roles item","tags":["Focus · Discord"],"description":"Roles with member counts. The Socialit bot can only manage roles below its own highest role. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: `/v1/accounts/{accountId}/focus/roles`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-roles-delete","x-zernio":["DELETE /v1/discord/guilds/{guildId}/roles/{roleId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/roles/reorder":{"post":{"operationId":"discordRolesReorder","summary":"Discord: Reorder roles (Roles)","tags":["Focus · Discord"],"description":"Reorder roles. Roles with member counts. The Socialit bot can only manage roles below its own highest role. Requires scopes: bot, permission:MANAGE_ROLES. Network docs: https://docs.discord.com/developers/topics/permissions#role-object Generic route: `/v1/accounts/{accountId}/focus/roles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"positions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"position":{"type":"integer"}}},"minItems":1}},"required":["positions"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-roles-reorder","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/bans":{"get":{"operationId":"discordBansList","summary":"Discord: List Bans","tags":["Focus · Discord"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:BAN_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#ban-object Generic route: `/v1/accounts/{accountId}/focus/bans`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":1000},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"string"},"in":"query","name":"before","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-bans-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"User id"},"username":{"type":["null","string"],"readOnly":true},"global_name":{"type":["null","string"],"readOnly":true},"reason":{"type":["null","string"],"maxLength":512},"delete_message_seconds":{"type":"integer","minimum":0,"maximum":604800,"writeOnly":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordBansCreate","summary":"Discord: Create a Bans item","tags":["Focus · Discord"],"description":"Requires scopes: bot, permission:BAN_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#ban-object Generic route: `/v1/accounts/{accountId}/focus/bans`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"User id"},"username":{"type":["string","null"],"readOnly":true},"global_name":{"type":["string","null"],"readOnly":true},"reason":{"type":["string","null"],"maxLength":512},"delete_message_seconds":{"type":"integer","minimum":0,"maximum":604800,"writeOnly":true}},"required":["id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-bans-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"User id"},"username":{"type":["null","string"],"readOnly":true},"global_name":{"type":["null","string"],"readOnly":true},"reason":{"type":["null","string"],"maxLength":512},"delete_message_seconds":{"type":"integer","minimum":0,"maximum":604800,"writeOnly":true}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/bans/{itemId}":{"get":{"operationId":"discordBansGet","summary":"Discord: Get a Bans item","tags":["Focus · Discord"],"description":"Requires scopes: bot, permission:BAN_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#ban-object Generic route: `/v1/accounts/{accountId}/focus/bans`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-bans-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"User id"},"username":{"type":["null","string"],"readOnly":true},"global_name":{"type":["null","string"],"readOnly":true},"reason":{"type":["null","string"],"maxLength":512},"delete_message_seconds":{"type":"integer","minimum":0,"maximum":604800,"writeOnly":true}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordBansDelete","summary":"Discord: Delete a Bans item","tags":["Focus · Discord"],"description":"Requires scopes: bot, permission:BAN_MEMBERS. Network docs: https://docs.discord.com/developers/resources/guild#ban-object Generic route: `/v1/accounts/{accountId}/focus/bans`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-bans-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/bans/bulk-ban":{"post":{"operationId":"discordBansBulkBan","summary":"Discord: Bulk ban (Bans)","tags":["Focus · Discord"],"description":"Bulk ban. Destructive. Requires scopes: bot, permission:BAN_MEMBERS, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/guild#ban-object Generic route: `/v1/accounts/{accountId}/focus/bans`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_ids":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":200},"delete_message_seconds":{"type":"integer","minimum":0,"maximum":604800},"reason":{"type":"string","maxLength":512,"description":"Shown in the server audit log"}},"required":["user_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_discord","x-mcp-tool":"discord-bans-bulk-ban","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/invites":{"get":{"operationId":"discordInvitesList","summary":"Discord: List Invites","tags":["Focus · Discord"],"description":"Campaign invites with usage counts (≤1000 per server). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/invite Generic route: `/v1/accounts/{accountId}/focus/invites`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-invites-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"channel_id":{"type":"string"},"inviter":{"type":["null","string"],"readOnly":true},"uses":{"type":"integer","readOnly":true},"max_uses":{"type":"integer","minimum":0,"maximum":100},"max_age":{"type":"integer","minimum":0,"maximum":604800,"description":"Seconds; 0 = never expires"},"temporary":{"type":"boolean","description":"Kick when they disconnect unless given a role"},"unique":{"type":"boolean"},"role_ids":{"type":"array","items":{"type":"string"},"description":"Roles granted on join (MANAGE_ROLES)"},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordInvitesCreate","summary":"Discord: Create a Invites item","tags":["Focus · Discord"],"description":"Campaign invites with usage counts (≤1000 per server). Requires scopes: bot, permission:MANAGE_GUILD, permission:CREATE_INSTANT_INVITE. Network docs: https://docs.discord.com/developers/resources/invite Generic route: `/v1/accounts/{accountId}/focus/invites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"channel_id":{"type":"string"},"inviter":{"type":["string","null"],"readOnly":true},"uses":{"type":"integer","readOnly":true},"max_uses":{"type":"integer","minimum":0,"maximum":100},"max_age":{"type":"integer","minimum":0,"maximum":604800,"description":"Seconds; 0 = never expires"},"temporary":{"type":"boolean","description":"Kick when they disconnect unless given a role"},"unique":{"type":"boolean"},"role_ids":{"type":"array","items":{"type":"string"},"description":"Roles granted on join (MANAGE_ROLES)"},"created_at":{"type":["string","null"],"format":"date-time","readOnly":true},"expires_at":{"type":["string","null"],"format":"date-time","readOnly":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-invites-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"channel_id":{"type":"string"},"inviter":{"type":["null","string"],"readOnly":true},"uses":{"type":"integer","readOnly":true},"max_uses":{"type":"integer","minimum":0,"maximum":100},"max_age":{"type":"integer","minimum":0,"maximum":604800,"description":"Seconds; 0 = never expires"},"temporary":{"type":"boolean","description":"Kick when they disconnect unless given a role"},"unique":{"type":"boolean"},"role_ids":{"type":"array","items":{"type":"string"},"description":"Roles granted on join (MANAGE_ROLES)"},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/invites/{itemId}":{"get":{"operationId":"discordInvitesGet","summary":"Discord: Get a Invites item","tags":["Focus · Discord"],"description":"Campaign invites with usage counts (≤1000 per server). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/invite Generic route: `/v1/accounts/{accountId}/focus/invites`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-invites-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"channel_id":{"type":"string"},"inviter":{"type":["null","string"],"readOnly":true},"uses":{"type":"integer","readOnly":true},"max_uses":{"type":"integer","minimum":0,"maximum":100},"max_age":{"type":"integer","minimum":0,"maximum":604800,"description":"Seconds; 0 = never expires"},"temporary":{"type":"boolean","description":"Kick when they disconnect unless given a role"},"unique":{"type":"boolean"},"role_ids":{"type":"array","items":{"type":"string"},"description":"Roles granted on join (MANAGE_ROLES)"},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordInvitesDelete","summary":"Discord: Delete a Invites item","tags":["Focus · Discord"],"description":"Campaign invites with usage counts (≤1000 per server). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/invite Generic route: `/v1/accounts/{accountId}/focus/invites`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-invites-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/invites/vanity":{"post":{"operationId":"discordInvitesVanity","summary":"Discord: Vanity URL (Invites)","tags":["Focus · Discord"],"description":"Vanity URL. Campaign invites with usage counts (≤1000 per server). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/invite Generic route: `/v1/accounts/{accountId}/focus/invites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-invites-vanity","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/scheduled-events":{"get":{"operationId":"discordScheduledEventsList","summary":"Discord: List Events","tags":["Focus · Discord"],"description":"Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: `/v1/accounts/{accountId}/focus/scheduled-events`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-scheduled-events-list","x-zernio":["GET /v1/discord/guilds/{guildId}/events"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"description":{"type":["null","string"],"maxLength":1000},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["scheduled","active","completed","cancelled"]},"entity_type":{"type":"string","enum":["external","voice","stage"]},"channel_id":{"type":["null","string"]},"location":{"type":["null","string"],"maxLength":100},"user_count":{"type":["null","integer"],"readOnly":true},"image":{"type":["null","string"]},"recurrence_rule":{"type":["null","object"],"properties":{"start":{"type":"string","format":"date-time"},"frequency":{"type":"integer","enum":[0,1,2,3],"description":"0 yearly, 1 monthly, 2 weekly, 3 daily"},"interval":{"type":"integer"},"by_weekday":{"type":["null","array"],"items":{"type":"integer"}},"by_n_weekday":{"type":["null","array"],"items":{"type":"object","properties":{"n":{"type":"integer"},"day":{"type":"integer"}}}},"by_month":{"type":["null","array"],"items":{"type":"integer"}},"by_month_day":{"type":["null","array"],"items":{"type":"integer"}}}}},"required":["name","starts_at","entity_type"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordScheduledEventsCreate","summary":"Discord: Create a Events item","tags":["Focus · Discord"],"description":"Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: `/v1/accounts/{accountId}/focus/scheduled-events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"description":{"type":["string","null"],"maxLength":1000},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","enum":["scheduled","active","completed","cancelled"]},"entity_type":{"type":"string","enum":["external","voice","stage"]},"channel_id":{"type":["string","null"]},"location":{"type":["string","null"],"maxLength":100},"user_count":{"type":["integer","null"],"readOnly":true},"image":{"type":["string","null"]},"recurrence_rule":{"type":["object","null"],"properties":{"start":{"type":"string","format":"date-time"},"frequency":{"type":"integer","enum":[0,1,2,3],"description":"0 yearly, 1 monthly, 2 weekly, 3 daily"},"interval":{"type":"integer"},"by_weekday":{"type":["array","null"],"items":{"type":"integer"}},"by_n_weekday":{"type":["array","null"],"items":{"type":"object","properties":{"n":{"type":"integer"},"day":{"type":"integer"}}}},"by_month":{"type":["array","null"],"items":{"type":"integer"}},"by_month_day":{"type":["array","null"],"items":{"type":"integer"}}}}},"required":["name","starts_at","entity_type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-scheduled-events-create","x-idempotent":true,"x-zernio":["POST /v1/discord/guilds/{guildId}/events"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"description":{"type":["null","string"],"maxLength":1000},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["scheduled","active","completed","cancelled"]},"entity_type":{"type":"string","enum":["external","voice","stage"]},"channel_id":{"type":["null","string"]},"location":{"type":["null","string"],"maxLength":100},"user_count":{"type":["null","integer"],"readOnly":true},"image":{"type":["null","string"]},"recurrence_rule":{"type":["null","object"],"properties":{"start":{"type":"string","format":"date-time"},"frequency":{"type":"integer","enum":[0,1,2,3],"description":"0 yearly, 1 monthly, 2 weekly, 3 daily"},"interval":{"type":"integer"},"by_weekday":{"type":["null","array"],"items":{"type":"integer"}},"by_n_weekday":{"type":["null","array"],"items":{"type":"object","properties":{"n":{"type":"integer"},"day":{"type":"integer"}}}},"by_month":{"type":["null","array"],"items":{"type":"integer"}},"by_month_day":{"type":["null","array"],"items":{"type":"integer"}}}}},"required":["name","starts_at","entity_type"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/scheduled-events/{itemId}":{"get":{"operationId":"discordScheduledEventsGet","summary":"Discord: Get a Events item","tags":["Focus · Discord"],"description":"Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: `/v1/accounts/{accountId}/focus/scheduled-events`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-scheduled-events-get","x-zernio":["GET /v1/discord/guilds/{guildId}/events/{eventId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"description":{"type":["null","string"],"maxLength":1000},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["scheduled","active","completed","cancelled"]},"entity_type":{"type":"string","enum":["external","voice","stage"]},"channel_id":{"type":["null","string"]},"location":{"type":["null","string"],"maxLength":100},"user_count":{"type":["null","integer"],"readOnly":true},"image":{"type":["null","string"]},"recurrence_rule":{"type":["null","object"],"properties":{"start":{"type":"string","format":"date-time"},"frequency":{"type":"integer","enum":[0,1,2,3],"description":"0 yearly, 1 monthly, 2 weekly, 3 daily"},"interval":{"type":"integer"},"by_weekday":{"type":["null","array"],"items":{"type":"integer"}},"by_n_weekday":{"type":["null","array"],"items":{"type":"object","properties":{"n":{"type":"integer"},"day":{"type":"integer"}}}},"by_month":{"type":["null","array"],"items":{"type":"integer"}},"by_month_day":{"type":["null","array"],"items":{"type":"integer"}}}}},"required":["name","starts_at","entity_type"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordScheduledEventsUpdate","summary":"Discord: Update a Events item","tags":["Focus · Discord"],"description":"Own events need CREATE_EVENTS; events created by others need MANAGE_EVENTS. Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: `/v1/accounts/{accountId}/focus/scheduled-events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-scheduled-events-update","x-zernio":["PATCH /v1/discord/guilds/{guildId}/events/{eventId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"description":{"type":["null","string"],"maxLength":1000},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":["null","string"],"format":"date-time"},"status":{"type":"string","enum":["scheduled","active","completed","cancelled"]},"entity_type":{"type":"string","enum":["external","voice","stage"]},"channel_id":{"type":["null","string"]},"location":{"type":["null","string"],"maxLength":100},"user_count":{"type":["null","integer"],"readOnly":true},"image":{"type":["null","string"]},"recurrence_rule":{"type":["null","object"],"properties":{"start":{"type":"string","format":"date-time"},"frequency":{"type":"integer","enum":[0,1,2,3],"description":"0 yearly, 1 monthly, 2 weekly, 3 daily"},"interval":{"type":"integer"},"by_weekday":{"type":["null","array"],"items":{"type":"integer"}},"by_n_weekday":{"type":["null","array"],"items":{"type":"object","properties":{"n":{"type":"integer"},"day":{"type":"integer"}}}},"by_month":{"type":["null","array"],"items":{"type":"integer"}},"by_month_day":{"type":["null","array"],"items":{"type":"integer"}}}}},"required":["name","starts_at","entity_type"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordScheduledEventsDelete","summary":"Discord: Delete a Events item","tags":["Focus · Discord"],"description":"Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: `/v1/accounts/{accountId}/focus/scheduled-events`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-scheduled-events-delete","x-zernio":["DELETE /v1/discord/guilds/{guildId}/events/{eventId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/scheduled-events/{itemId}/users":{"post":{"operationId":"discordScheduledEventsUsers","summary":"Discord: Interested users (Events)","tags":["Focus · Discord"],"description":"Interested users. Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: `/v1/accounts/{accountId}/focus/scheduled-events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","maximum":100},"after":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-scheduled-events-users","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/scheduled-events/{itemId}/start":{"post":{"operationId":"discordScheduledEventsStart","summary":"Discord: Start (Events)","tags":["Focus · Discord"],"description":"Start. Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: `/v1/accounts/{accountId}/focus/scheduled-events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-scheduled-events-start","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/scheduled-events/{itemId}/end":{"post":{"operationId":"discordScheduledEventsEnd","summary":"Discord: End (Events)","tags":["Focus · Discord"],"description":"End. Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: `/v1/accounts/{accountId}/focus/scheduled-events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-scheduled-events-end","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/scheduled-events/{itemId}/cancel":{"post":{"operationId":"discordScheduledEventsCancel","summary":"Discord: Cancel (Events)","tags":["Focus · Discord"],"description":"Cancel. Scheduled events (voice, stage, external; recurring) with RSVP counts. ≤100 scheduled or active per server. Destructive. Requires scopes: bot, permission:CREATE_EVENTS. Network docs: https://docs.discord.com/developers/resources/guild-scheduled-event Generic route: `/v1/accounts/{accountId}/focus/scheduled-events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_discord","x-mcp-tool":"discord-scheduled-events-cancel","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/automod-rules":{"get":{"operationId":"discordAutomodRulesList","summary":"Discord: List AutoMod rules","tags":["Focus · Discord"],"description":"Keyword, spam, preset, mention-spam and member-profile rules (block, alert, timeout). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/auto-moderation Generic route: `/v1/accounts/{accountId}/focus/automod-rules`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-automod-rules-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"event_type":{"type":"integer","enum":[1,2],"description":"1 message send, 2 member update"},"trigger_type":{"type":"integer","enum":[1,3,4,5,6],"description":"1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile"},"trigger_type_name":{"type":"string","readOnly":true},"trigger_metadata":{"type":"object","properties":{"keyword_filter":{"type":"array","items":{"type":"string","maxLength":60},"maxItems":1000},"regex_patterns":{"type":"array","items":{"type":"string","maxLength":260},"maxItems":10},"presets":{"type":"array","items":{"type":"integer","enum":[1,2,3]},"description":"1 profanity, 2 sexual content, 3 slurs"},"allow_list":{"type":"array","items":{"type":"string"},"maxItems":1000},"mention_total_limit":{"type":"integer","maximum":50},"mention_raid_protection_enabled":{"type":"boolean"}}},"actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer","enum":[1,2,3,4]},"metadata":{"type":"object","properties":{"channel_id":{"type":"string"},"duration_seconds":{"type":"integer","maximum":2419200},"custom_message":{"type":"string","maxLength":150}}}}},"minItems":1},"enabled":{"type":"boolean"},"exempt_roles":{"type":"array","items":{"type":"string"},"maxItems":20},"exempt_channels":{"type":"array","items":{"type":"string"},"maxItems":50}},"required":["name","event_type","trigger_type","actions"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordAutomodRulesCreate","summary":"Discord: Create a AutoMod rules item","tags":["Focus · Discord"],"description":"The timeout action also needs MODERATE_MEMBERS. Keyword, spam, preset, mention-spam and member-profile rules (block, alert, timeout). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/auto-moderation Generic route: `/v1/accounts/{accountId}/focus/automod-rules`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"event_type":{"type":"integer","enum":[1,2],"description":"1 message send, 2 member update"},"trigger_type":{"type":"integer","enum":[1,3,4,5,6],"description":"1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile"},"trigger_type_name":{"type":"string","readOnly":true},"trigger_metadata":{"type":"object","properties":{"keyword_filter":{"type":"array","items":{"type":"string","maxLength":60},"maxItems":1000},"regex_patterns":{"type":"array","items":{"type":"string","maxLength":260},"maxItems":10},"presets":{"type":"array","items":{"type":"integer","enum":[1,2,3]},"description":"1 profanity, 2 sexual content, 3 slurs"},"allow_list":{"type":"array","items":{"type":"string"},"maxItems":1000},"mention_total_limit":{"type":"integer","maximum":50},"mention_raid_protection_enabled":{"type":"boolean"}}},"actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer","enum":[1,2,3,4]},"metadata":{"type":"object","properties":{"channel_id":{"type":"string"},"duration_seconds":{"type":"integer","maximum":2419200},"custom_message":{"type":"string","maxLength":150}}}}},"minItems":1},"enabled":{"type":"boolean"},"exempt_roles":{"type":"array","items":{"type":"string"},"maxItems":20},"exempt_channels":{"type":"array","items":{"type":"string"},"maxItems":50}},"required":["name","event_type","trigger_type","actions"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-automod-rules-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"event_type":{"type":"integer","enum":[1,2],"description":"1 message send, 2 member update"},"trigger_type":{"type":"integer","enum":[1,3,4,5,6],"description":"1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile"},"trigger_type_name":{"type":"string","readOnly":true},"trigger_metadata":{"type":"object","properties":{"keyword_filter":{"type":"array","items":{"type":"string","maxLength":60},"maxItems":1000},"regex_patterns":{"type":"array","items":{"type":"string","maxLength":260},"maxItems":10},"presets":{"type":"array","items":{"type":"integer","enum":[1,2,3]},"description":"1 profanity, 2 sexual content, 3 slurs"},"allow_list":{"type":"array","items":{"type":"string"},"maxItems":1000},"mention_total_limit":{"type":"integer","maximum":50},"mention_raid_protection_enabled":{"type":"boolean"}}},"actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer","enum":[1,2,3,4]},"metadata":{"type":"object","properties":{"channel_id":{"type":"string"},"duration_seconds":{"type":"integer","maximum":2419200},"custom_message":{"type":"string","maxLength":150}}}}},"minItems":1},"enabled":{"type":"boolean"},"exempt_roles":{"type":"array","items":{"type":"string"},"maxItems":20},"exempt_channels":{"type":"array","items":{"type":"string"},"maxItems":50}},"required":["name","event_type","trigger_type","actions"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/automod-rules/{itemId}":{"get":{"operationId":"discordAutomodRulesGet","summary":"Discord: Get a AutoMod rules item","tags":["Focus · Discord"],"description":"Keyword, spam, preset, mention-spam and member-profile rules (block, alert, timeout). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/auto-moderation Generic route: `/v1/accounts/{accountId}/focus/automod-rules`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-automod-rules-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"event_type":{"type":"integer","enum":[1,2],"description":"1 message send, 2 member update"},"trigger_type":{"type":"integer","enum":[1,3,4,5,6],"description":"1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile"},"trigger_type_name":{"type":"string","readOnly":true},"trigger_metadata":{"type":"object","properties":{"keyword_filter":{"type":"array","items":{"type":"string","maxLength":60},"maxItems":1000},"regex_patterns":{"type":"array","items":{"type":"string","maxLength":260},"maxItems":10},"presets":{"type":"array","items":{"type":"integer","enum":[1,2,3]},"description":"1 profanity, 2 sexual content, 3 slurs"},"allow_list":{"type":"array","items":{"type":"string"},"maxItems":1000},"mention_total_limit":{"type":"integer","maximum":50},"mention_raid_protection_enabled":{"type":"boolean"}}},"actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer","enum":[1,2,3,4]},"metadata":{"type":"object","properties":{"channel_id":{"type":"string"},"duration_seconds":{"type":"integer","maximum":2419200},"custom_message":{"type":"string","maxLength":150}}}}},"minItems":1},"enabled":{"type":"boolean"},"exempt_roles":{"type":"array","items":{"type":"string"},"maxItems":20},"exempt_channels":{"type":"array","items":{"type":"string"},"maxItems":50}},"required":["name","event_type","trigger_type","actions"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordAutomodRulesUpdate","summary":"Discord: Update a AutoMod rules item","tags":["Focus · Discord"],"description":"Keyword, spam, preset, mention-spam and member-profile rules (block, alert, timeout). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/auto-moderation Generic route: `/v1/accounts/{accountId}/focus/automod-rules`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-automod-rules-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":100},"event_type":{"type":"integer","enum":[1,2],"description":"1 message send, 2 member update"},"trigger_type":{"type":"integer","enum":[1,3,4,5,6],"description":"1 keyword (≤6 rules), 3 spam, 4 keyword preset, 5 mention spam, 6 member profile"},"trigger_type_name":{"type":"string","readOnly":true},"trigger_metadata":{"type":"object","properties":{"keyword_filter":{"type":"array","items":{"type":"string","maxLength":60},"maxItems":1000},"regex_patterns":{"type":"array","items":{"type":"string","maxLength":260},"maxItems":10},"presets":{"type":"array","items":{"type":"integer","enum":[1,2,3]},"description":"1 profanity, 2 sexual content, 3 slurs"},"allow_list":{"type":"array","items":{"type":"string"},"maxItems":1000},"mention_total_limit":{"type":"integer","maximum":50},"mention_raid_protection_enabled":{"type":"boolean"}}},"actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer","enum":[1,2,3,4]},"metadata":{"type":"object","properties":{"channel_id":{"type":"string"},"duration_seconds":{"type":"integer","maximum":2419200},"custom_message":{"type":"string","maxLength":150}}}}},"minItems":1},"enabled":{"type":"boolean"},"exempt_roles":{"type":"array","items":{"type":"string"},"maxItems":20},"exempt_channels":{"type":"array","items":{"type":"string"},"maxItems":50}},"required":["name","event_type","trigger_type","actions"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordAutomodRulesDelete","summary":"Discord: Delete a AutoMod rules item","tags":["Focus · Discord"],"description":"Keyword, spam, preset, mention-spam and member-profile rules (block, alert, timeout). Requires scopes: bot, permission:MANAGE_GUILD. Network docs: https://docs.discord.com/developers/resources/auto-moderation Generic route: `/v1/accounts/{accountId}/focus/automod-rules`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-automod-rules-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/audit-log":{"get":{"operationId":"discordAuditLogList","summary":"Discord: List Audit log","tags":["Focus · Discord"],"description":"Who did what in the server (45-day retention). Socialit actions carry a \"Socialit: …\" reason. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, permission:VIEW_AUDIT_LOG. Network docs: https://docs.discord.com/developers/resources/audit-log Generic route: `/v1/accounts/{accountId}/focus/audit-log`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"user_id","required":false},{"schema":{"type":"integer"},"in":"query","name":"action_type","required":false},{"schema":{"type":"string"},"in":"query","name":"before","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-audit-log-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"user_id":{"type":["null","string"]},"user":{"type":["null","string"]},"action_type":{"type":"integer"},"target_id":{"type":["null","string"]},"reason":{"type":["null","string"]},"changes":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"old_value":{},"new_value":{}}}},"options":{"type":["null","object"],"properties":{}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/emojis":{"get":{"operationId":"discordEmojisList","summary":"Discord: List Emoji","tags":["Focus · Discord"],"description":"Custom server emoji (≤256 KiB, 128×128; JPEG, PNG, GIF, WebP, AVIF). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/emoji Generic route: `/v1/accounts/{accountId}/focus/emojis`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-emojis-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":32,"pattern":"^[A-Za-z0-9_]+$"},"image":{"type":"string","writeOnly":true,"description":"Image (create only)"},"roles":{"type":"array","items":{"type":"string"},"description":"Roles allowed to use it"},"animated":{"type":"boolean","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"markdown":{"type":"string","readOnly":true},"creator":{"type":["null","string"],"readOnly":true}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordEmojisCreate","summary":"Discord: Create a Emoji item","tags":["Focus · Discord"],"description":"Custom server emoji (≤256 KiB, 128×128; JPEG, PNG, GIF, WebP, AVIF). Requires scopes: bot, permission:CREATE_GUILD_EXPRESSIONS. Network docs: https://docs.discord.com/developers/resources/emoji Generic route: `/v1/accounts/{accountId}/focus/emojis`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-emojis-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":32,"pattern":"^[A-Za-z0-9_]+$"},"image":{"type":"string","writeOnly":true,"description":"Image (create only)"},"roles":{"type":"array","items":{"type":"string"},"description":"Roles allowed to use it"},"animated":{"type":"boolean","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"markdown":{"type":"string","readOnly":true},"creator":{"type":["null","string"],"readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/emojis/{itemId}":{"get":{"operationId":"discordEmojisGet","summary":"Discord: Get a Emoji item","tags":["Focus · Discord"],"description":"Custom server emoji (≤256 KiB, 128×128; JPEG, PNG, GIF, WebP, AVIF). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/emoji Generic route: `/v1/accounts/{accountId}/focus/emojis`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-emojis-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":32,"pattern":"^[A-Za-z0-9_]+$"},"image":{"type":"string","writeOnly":true,"description":"Image (create only)"},"roles":{"type":"array","items":{"type":"string"},"description":"Roles allowed to use it"},"animated":{"type":"boolean","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"markdown":{"type":"string","readOnly":true},"creator":{"type":["null","string"],"readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordEmojisUpdate","summary":"Discord: Update a Emoji item","tags":["Focus · Discord"],"description":"Custom server emoji (≤256 KiB, 128×128; JPEG, PNG, GIF, WebP, AVIF). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/emoji Generic route: `/v1/accounts/{accountId}/focus/emojis`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-emojis-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":32,"pattern":"^[A-Za-z0-9_]+$"},"image":{"type":"string","writeOnly":true,"description":"Image (create only)"},"roles":{"type":"array","items":{"type":"string"},"description":"Roles allowed to use it"},"animated":{"type":"boolean","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"markdown":{"type":"string","readOnly":true},"creator":{"type":["null","string"],"readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordEmojisDelete","summary":"Discord: Delete a Emoji item","tags":["Focus · Discord"],"description":"Custom server emoji (≤256 KiB, 128×128; JPEG, PNG, GIF, WebP, AVIF). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/emoji Generic route: `/v1/accounts/{accountId}/focus/emojis`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-emojis-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/stickers":{"get":{"operationId":"discordStickersList","summary":"Discord: List Stickers","tags":["Focus · Discord"],"description":"Server stickers (PNG, APNG, GIF; ≤512 KiB, 320×320). Free servers get 5 slots, more with boosts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/sticker Generic route: `/v1/accounts/{accountId}/focus/stickers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-stickers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":30},"description":{"type":["null","string"],"maxLength":100},"tags":{"type":"string","maxLength":200,"description":"Autocomplete/suggestion tags (e.g. a unicode emoji name)"},"file":{"type":"string","writeOnly":true,"description":"Sticker file (create only)"},"format":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["name","tags"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordStickersCreate","summary":"Discord: Create a Stickers item","tags":["Focus · Discord"],"description":"Server stickers (PNG, APNG, GIF; ≤512 KiB, 320×320). Free servers get 5 slots, more with boosts. Requires scopes: bot, permission:CREATE_GUILD_EXPRESSIONS. Network docs: https://docs.discord.com/developers/resources/sticker Generic route: `/v1/accounts/{accountId}/focus/stickers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-stickers-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":30},"description":{"type":["null","string"],"maxLength":100},"tags":{"type":"string","maxLength":200,"description":"Autocomplete/suggestion tags (e.g. a unicode emoji name)"},"file":{"type":"string","writeOnly":true,"description":"Sticker file (create only)"},"format":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["name","tags"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/stickers/{itemId}":{"get":{"operationId":"discordStickersGet","summary":"Discord: Get a Stickers item","tags":["Focus · Discord"],"description":"Server stickers (PNG, APNG, GIF; ≤512 KiB, 320×320). Free servers get 5 slots, more with boosts. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/sticker Generic route: `/v1/accounts/{accountId}/focus/stickers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-stickers-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":30},"description":{"type":["null","string"],"maxLength":100},"tags":{"type":"string","maxLength":200,"description":"Autocomplete/suggestion tags (e.g. a unicode emoji name)"},"file":{"type":"string","writeOnly":true,"description":"Sticker file (create only)"},"format":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["name","tags"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordStickersUpdate","summary":"Discord: Update a Stickers item","tags":["Focus · Discord"],"description":"Server stickers (PNG, APNG, GIF; ≤512 KiB, 320×320). Free servers get 5 slots, more with boosts. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/sticker Generic route: `/v1/accounts/{accountId}/focus/stickers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-stickers-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":30},"description":{"type":["null","string"],"maxLength":100},"tags":{"type":"string","maxLength":200,"description":"Autocomplete/suggestion tags (e.g. a unicode emoji name)"},"file":{"type":"string","writeOnly":true,"description":"Sticker file (create only)"},"format":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["name","tags"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordStickersDelete","summary":"Discord: Delete a Stickers item","tags":["Focus · Discord"],"description":"Server stickers (PNG, APNG, GIF; ≤512 KiB, 320×320). Free servers get 5 slots, more with boosts. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/sticker Generic route: `/v1/accounts/{accountId}/focus/stickers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-stickers-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/soundboard-sounds":{"get":{"operationId":"discordSoundboardSoundsList","summary":"Discord: List Soundboard","tags":["Focus · Discord"],"description":"Server soundboard sounds (MP3/Ogg, ≤512 KB, ≤5.2 s). Socialit cannot play sounds (no voice connection). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/soundboard Generic route: `/v1/accounts/{accountId}/focus/soundboard-sounds`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-soundboard-sounds-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":32},"sound":{"type":"string","writeOnly":true,"description":"Audio file (create only)"},"volume":{"type":"number","minimum":0,"maximum":1,"default":1},"emoji_id":{"type":["null","string"]},"emoji_name":{"type":["null","string"]},"url":{"type":"string","format":"uri","readOnly":true}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordSoundboardSoundsCreate","summary":"Discord: Create a Soundboard item","tags":["Focus · Discord"],"description":"Server soundboard sounds (MP3/Ogg, ≤512 KB, ≤5.2 s). Socialit cannot play sounds (no voice connection). Requires scopes: bot, permission:CREATE_GUILD_EXPRESSIONS. Network docs: https://docs.discord.com/developers/resources/soundboard Generic route: `/v1/accounts/{accountId}/focus/soundboard-sounds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-soundboard-sounds-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":32},"sound":{"type":"string","writeOnly":true,"description":"Audio file (create only)"},"volume":{"type":"number","minimum":0,"maximum":1,"default":1},"emoji_id":{"type":["null","string"]},"emoji_name":{"type":["null","string"]},"url":{"type":"string","format":"uri","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/soundboard-sounds/{itemId}":{"get":{"operationId":"discordSoundboardSoundsGet","summary":"Discord: Get a Soundboard item","tags":["Focus · Discord"],"description":"Server soundboard sounds (MP3/Ogg, ≤512 KB, ≤5.2 s). Socialit cannot play sounds (no voice connection). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/soundboard Generic route: `/v1/accounts/{accountId}/focus/soundboard-sounds`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-soundboard-sounds-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":32},"sound":{"type":"string","writeOnly":true,"description":"Audio file (create only)"},"volume":{"type":"number","minimum":0,"maximum":1,"default":1},"emoji_id":{"type":["null","string"]},"emoji_name":{"type":["null","string"]},"url":{"type":"string","format":"uri","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordSoundboardSoundsUpdate","summary":"Discord: Update a Soundboard item","tags":["Focus · Discord"],"description":"Server soundboard sounds (MP3/Ogg, ≤512 KB, ≤5.2 s). Socialit cannot play sounds (no voice connection). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/soundboard Generic route: `/v1/accounts/{accountId}/focus/soundboard-sounds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-soundboard-sounds-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":2,"maxLength":32},"sound":{"type":"string","writeOnly":true,"description":"Audio file (create only)"},"volume":{"type":"number","minimum":0,"maximum":1,"default":1},"emoji_id":{"type":["null","string"]},"emoji_name":{"type":["null","string"]},"url":{"type":"string","format":"uri","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordSoundboardSoundsDelete","summary":"Discord: Delete a Soundboard item","tags":["Focus · Discord"],"description":"Server soundboard sounds (MP3/Ogg, ≤512 KB, ≤5.2 s). Socialit cannot play sounds (no voice connection). Requires scopes: bot. Network docs: https://docs.discord.com/developers/resources/soundboard Generic route: `/v1/accounts/{accountId}/focus/soundboard-sounds`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-soundboard-sounds-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/commands":{"get":{"operationId":"discordCommandsList","summary":"Discord: List Socialit commands","tags":["Focus · Discord"],"description":"Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: `/v1/accounts/{accountId}/focus/commands`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-commands-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"integer","enum":[1,2,3],"description":"1 slash, 2 user context menu, 3 message context menu"},"type_name":{"type":"string","readOnly":true},"description":{"type":"string","maxLength":100,"description":"Required for slash commands"},"options":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer"},"name":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"}}},"maxItems":25},"default_member_permissions":{"type":["null","string"],"description":"Permission bitfield required to see the command"},"nsfw":{"type":"boolean"},"version":{"type":"string","readOnly":true}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"discordCommandsCreate","summary":"Discord: Create a Socialit commands item","tags":["Focus · Discord"],"description":"Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: `/v1/accounts/{accountId}/focus/commands`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"integer","enum":[1,2,3],"description":"1 slash, 2 user context menu, 3 message context menu"},"type_name":{"type":"string","readOnly":true},"description":{"type":"string","maxLength":100,"description":"Required for slash commands"},"options":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer"},"name":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"}}},"maxItems":25},"default_member_permissions":{"type":["string","null"],"description":"Permission bitfield required to see the command"},"nsfw":{"type":"boolean"},"version":{"type":"string","readOnly":true}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_discord","x-mcp-tool":"discord-commands-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"integer","enum":[1,2,3],"description":"1 slash, 2 user context menu, 3 message context menu"},"type_name":{"type":"string","readOnly":true},"description":{"type":"string","maxLength":100,"description":"Required for slash commands"},"options":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer"},"name":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"}}},"maxItems":25},"default_member_permissions":{"type":["null","string"],"description":"Permission bitfield required to see the command"},"nsfw":{"type":"boolean"},"version":{"type":"string","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/commands/{itemId}":{"get":{"operationId":"discordCommandsGet","summary":"Discord: Get a Socialit commands item","tags":["Focus · Discord"],"description":"Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: `/v1/accounts/{accountId}/focus/commands`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_discord","x-mcp-tool":"discord-commands-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"integer","enum":[1,2,3],"description":"1 slash, 2 user context menu, 3 message context menu"},"type_name":{"type":"string","readOnly":true},"description":{"type":"string","maxLength":100,"description":"Required for slash commands"},"options":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer"},"name":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"}}},"maxItems":25},"default_member_permissions":{"type":["null","string"],"description":"Permission bitfield required to see the command"},"nsfw":{"type":"boolean"},"version":{"type":"string","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"discordCommandsUpdate","summary":"Discord: Update a Socialit commands item","tags":["Focus · Discord"],"description":"Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: `/v1/accounts/{accountId}/focus/commands`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_discord","x-mcp-tool":"discord-commands-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"integer","enum":[1,2,3],"description":"1 slash, 2 user context menu, 3 message context menu"},"type_name":{"type":"string","readOnly":true},"description":{"type":"string","maxLength":100,"description":"Required for slash commands"},"options":{"type":"array","items":{"type":"object","properties":{"type":{"type":"integer"},"name":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"}}},"maxItems":25},"default_member_permissions":{"type":["null","string"],"description":"Permission bitfield required to see the command"},"nsfw":{"type":"boolean"},"version":{"type":"string","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"discordCommandsDelete","summary":"Discord: Delete a Socialit commands item","tags":["Focus · Discord"],"description":"Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: `/v1/accounts/{accountId}/focus/commands`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_discord","x-mcp-tool":"discord-commands-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/commands/register-defaults":{"post":{"operationId":"discordCommandsRegisterDefaults","summary":"Discord: Reset to Socialit defaults (Socialit commands)","tags":["Focus · Discord"],"description":"Bulk-overwrites the server's Socialit commands with: Send to Socialit inbox, socialit. Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: `/v1/accounts/{accountId}/focus/commands`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-commands-register-defaults","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/discord/commands/{itemId}/permissions":{"post":{"operationId":"discordCommandsPermissions","summary":"Discord: Permissions (Socialit commands)","tags":["Focus · Discord"],"description":"Per-command role/user/channel permissions (editing them needs a user token with applications.commands.permissions.update). Slash and context-menu commands Socialit registers in this server (≤100 slash, 15 user, 15 message; 200 creates/day). Requires scopes: bot, applications.commands. Network docs: https://docs.discord.com/developers/interactions/application-commands Generic route: `/v1/accounts/{accountId}/focus/commands`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_discord","x-mcp-tool":"discord-commands-permissions","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/posts":{"get":{"operationId":"facebookPostsList","summary":"Facebook Page: List Posts","tags":["Focus · Facebook Page"],"description":"Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["published_posts","feed"],"default":"published_posts"},"in":"query","name":"edge","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message":{"type":"string","maxLength":63206},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"scheduled_publish_time":{"type":["null","string"],"format":"date-time"},"permalink_url":{"type":"string","format":"uri","readOnly":true},"full_picture":{"type":"string","format":"uri","readOnly":true},"status_type":{"type":"string","readOnly":true},"is_published":{"type":"boolean","readOnly":true},"shares":{"type":"integer","readOnly":true},"reactions":{"type":"integer","readOnly":true},"comments":{"type":"integer","readOnly":true},"from":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookPostsCreate","summary":"Facebook Page: Create a Posts item","tags":["Focus · Facebook Page"],"description":"Publish a feed post (text, link, photos, video, carousel). Use options.scheduledPublishTime / draft for native scheduling. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":63206},"media":{"type":"array","items":{"type":"object","properties":{"mediaId":{"type":"string","description":"Socialit media id"},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video"]},"altText":{"type":"string"},"thumbnail":{"type":"string","format":"uri","description":"Video cover URL"},"subtitles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"language":{"type":"string"}}}}},"description":"Media id or public URL"},"maxItems":10},"options":{"type":"object","title":"Facebook Page options","additionalProperties":true,"properties":{"contentType":{"type":"string","enum":["feed","reel","story"],"default":"feed","description":"feed = Page post (text, link, photos, video, carousel); reel = single vertical 3-90 s video; story = 1 photo or video ≤60 s, 24 h, no caption."},"pageId":{"type":"string","pattern":"^\\d+$","description":"Publish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token."},"link":{"type":"string","format":"uri","description":"Link to share (feed text posts). Generates a link preview."},"title":{"type":"string","maxLength":255,"description":"Video / Reel title (separate from the caption)."},"draft":{"type":"boolean","default":false,"description":"Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped."},"published":{"type":"boolean","default":true,"description":"false = unpublished (same as draft)."},"scheduledPublishTime":{"description":"Native Facebook scheduling: ISO 8601 or unix seconds, 10 minutes to 30 days ahead (Reels ≤29 days). Not for Stories. Socialit-side scheduling does not need this.","anyOf":[{"type":"string"},{"type":"integer"}]},"geoRestriction":{"type":"object","description":"Hard visibility restriction (Graph `targeting.geo_locations.countries`). Feed posts, videos, Reels.","required":["countries"],"properties":{"countries":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string","pattern":"^[A-Z]{2}$"}}}},"targeting":{"type":"object","description":"Raw Graph `targeting` object (who can see the post). Overrides geoRestriction."},"feedTargeting":{"type":"object","description":"Raw Graph `feed_targeting` (News Feed preference, does not restrict visibility): geo_locations {countries|regions|cities}, age_min, age_max, genders, locales, interests… Do not mix countries with regions."},"place":{"type":"string","pattern":"^\\d+$","description":"Location tag: id of a Page with a location."},"carouselCards":{"type":"array","minItems":2,"maxItems":10,"description":"Multi-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.","items":{"type":"object","required":["link"],"properties":{"link":{"type":"string","format":"uri"},"name":{"type":"string","maxLength":255,"description":"Headline (~35 chars shown)."},"description":{"type":"string","maxLength":255,"description":"Subhead (~30 chars shown)."},"picture":{"type":"string","format":"uri","description":"Card image URL (defaults to media[i].url)."}}}},"carouselLink":{"type":"string","format":"uri","description":"\"See more\" end-card URL (defaults to the first card link)."},"multiShareOptimized":{"type":"boolean","description":"Let Facebook reorder carousel cards by performance."},"multiShareEndCard":{"type":"boolean","description":"Show the Page end card on carousels."},"textFormatPresetId":{"type":"string","pattern":"^\\d+$","description":"Text background preset (text-only feed posts; rejected with media, cards, link or empty content)."},"callToAction":{"type":"object","description":"Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)","required":["type"],"properties":{"type":{"type":"string","enum":["LEARN_MORE","SHOP_NOW","BOOK_TRAVEL","SIGN_UP","DOWNLOAD","WATCH_MORE","CONTACT_US","APPLY_NOW","GET_DIRECTIONS","CALL_NOW","MESSAGE_PAGE","ORDER_NOW","SUBSCRIBE","GET_QUOTE","NO_BUTTON"]},"link":{"type":"string","format":"uri"},"appLink":{"type":"string"}}},"backdatedTime":{"description":"Backdate a feed/photo post (ISO or unix).","anyOf":[{"type":"string"},{"type":"integer"}]},"backdatedTimeGranularity":{"type":"string","enum":["year","month","day","hour","min","none"]},"noStory":{"type":"boolean","description":"Photos/videos: upload without generating a feed story."},"altText":{"type":"string","description":"Alt text for photos (alt_text_custom). media[].altText wins per image."},"firstComment":{"type":"string","maxLength":8000,"description":"Comment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules)."},"thumbnailUrl":{"type":"string","format":"uri","description":"Custom video / Reel cover (≤10 MB). media[].thumbnail wins."},"contentTags":{"type":"array","items":{"type":"string"},"description":"Video content tag ids."},"secret":{"type":"boolean","description":"Video: hide from the Page (unlisted)."},"embeddable":{"type":"boolean","description":"Video: allow embedding."},"socialActions":{"type":"boolean","description":"Video: allow likes/comments/shares."},"crosspostToPageIds":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"description":"Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship)."},"crosspostingActions":{"type":"array","description":"Raw Graph `crossposting_actions` ([{ page_id, action }]); overrides crosspostToPageIds. (verify)","items":{"type":"object"}},"collaborators":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"description":"Reels: Page ids to invite as collaborators (10 invites / Page / 24 h)."},"uploadMode":{"type":"string","enum":["auto","url","resumable"],"default":"auto","description":"Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided."},"videoState":{"type":"string","enum":["PUBLISHED","SCHEDULED","DRAFT"],"description":"Reels: explicit video_state (derived from draft/schedule by default)."},"waitForUpload":{"type":"boolean","default":true,"description":"Reels/video Stories: poll upload status before finishing."}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-posts-create","x-idempotent":true,"x-zernio":["POST /v1/posts/{postId}/edit","POST /v1/posts/{postId}/unpublish","POST /v1/inbox/posts/{postId}/like"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message":{"type":"string","maxLength":63206},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"scheduled_publish_time":{"type":["null","string"],"format":"date-time"},"permalink_url":{"type":"string","format":"uri","readOnly":true},"full_picture":{"type":"string","format":"uri","readOnly":true},"status_type":{"type":"string","readOnly":true},"is_published":{"type":"boolean","readOnly":true},"shares":{"type":"integer","readOnly":true},"reactions":{"type":"integer","readOnly":true},"comments":{"type":"integer","readOnly":true},"from":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/posts/{itemId}":{"get":{"operationId":"facebookPostsGet","summary":"Facebook Page: Get a Posts item","tags":["Focus · Facebook Page"],"description":"Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-posts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message":{"type":"string","maxLength":63206},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"scheduled_publish_time":{"type":["null","string"],"format":"date-time"},"permalink_url":{"type":"string","format":"uri","readOnly":true},"full_picture":{"type":"string","format":"uri","readOnly":true},"status_type":{"type":"string","readOnly":true},"is_published":{"type":"boolean","readOnly":true},"shares":{"type":"integer","readOnly":true},"reactions":{"type":"integer","readOnly":true},"comments":{"type":"integer","readOnly":true},"from":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookPostsUpdate","summary":"Facebook Page: Update a Posts item","tags":["Focus · Facebook Page"],"description":"Edit the post text (posts created by Socialit only). Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":63206},"place":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-posts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message":{"type":"string","maxLength":63206},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"scheduled_publish_time":{"type":["null","string"],"format":"date-time"},"permalink_url":{"type":"string","format":"uri","readOnly":true},"full_picture":{"type":"string","format":"uri","readOnly":true},"status_type":{"type":"string","readOnly":true},"is_published":{"type":"boolean","readOnly":true},"shares":{"type":"integer","readOnly":true},"reactions":{"type":"integer","readOnly":true},"comments":{"type":"integer","readOnly":true},"from":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookPostsDelete","summary":"Facebook Page: Delete a Posts item","tags":["Focus · Facebook Page"],"description":"Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-posts-delete","x-zernio":["DELETE /v1/inbox/posts/{postId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/posts/{itemId}/like":{"post":{"operationId":"facebookPostsLike","summary":"Facebook Page: Like as Page (Posts)","tags":["Focus · Facebook Page"],"description":"Like as Page. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-posts-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/posts/{itemId}/unlike":{"post":{"operationId":"facebookPostsUnlike","summary":"Facebook Page: Unlike (Posts)","tags":["Focus · Facebook Page"],"description":"Unlike. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-posts-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/posts/{itemId}/comment":{"post":{"operationId":"facebookPostsComment","summary":"Facebook Page: Comment as Page (Posts)","tags":["Focus · Facebook Page"],"description":"Comment as Page. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":8000},"attachmentUrl":{"type":"string","format":"uri"}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-posts-comment","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/posts/{itemId}/reactions":{"post":{"operationId":"facebookPostsReactions","summary":"Facebook Page: Reaction breakdown (Posts)","tags":["Focus · Facebook Page"],"description":"Reaction breakdown. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-posts-reactions","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/posts/{itemId}/insights":{"post":{"operationId":"facebookPostsInsights","summary":"Facebook Page: Post insights (Posts)","tags":["Focus · Facebook Page"],"description":"Post insights. Published Page posts (text, links, photos, videos, carousels). Edit text, delete, like, comment. Requires scopes: pages_read_engagement, read_insights. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-posts-insights","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/scheduled-posts":{"get":{"operationId":"facebookScheduledPostsList","summary":"Facebook Page: List Scheduled on Facebook","tags":["Focus · Facebook Page"],"description":"Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/scheduled-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-scheduled-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message":{"type":"string","maxLength":63206},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"scheduled_publish_time":{"type":["null","string"],"format":"date-time"},"permalink_url":{"type":"string","format":"uri","readOnly":true},"full_picture":{"type":"string","format":"uri","readOnly":true},"status_type":{"type":"string","readOnly":true},"is_published":{"type":"boolean","readOnly":true},"shares":{"type":"integer","readOnly":true},"reactions":{"type":"integer","readOnly":true},"comments":{"type":"integer","readOnly":true},"from":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookScheduledPostsCreate","summary":"Facebook Page: Create a Scheduled on Facebook item","tags":["Focus · Facebook Page"],"description":"Schedule a feed post natively (options.scheduledPublishTime required). Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/scheduled-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":63206},"media":{"type":"array","items":{"type":"object","properties":{"mediaId":{"type":"string","description":"Socialit media id"},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video"]},"altText":{"type":"string"},"thumbnail":{"type":"string","format":"uri","description":"Video cover URL"},"subtitles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"language":{"type":"string"}}}}},"description":"Media id or public URL"},"maxItems":10},"options":{"type":"object","title":"Facebook Page options","additionalProperties":true,"properties":{"contentType":{"type":"string","enum":["feed","reel","story"],"default":"feed","description":"feed = Page post (text, link, photos, video, carousel); reel = single vertical 3-90 s video; story = 1 photo or video ≤60 s, 24 h, no caption."},"pageId":{"type":"string","pattern":"^\\d+$","description":"Publish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token."},"link":{"type":"string","format":"uri","description":"Link to share (feed text posts). Generates a link preview."},"title":{"type":"string","maxLength":255,"description":"Video / Reel title (separate from the caption)."},"draft":{"type":"boolean","default":false,"description":"Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped."},"published":{"type":"boolean","default":true,"description":"false = unpublished (same as draft)."},"scheduledPublishTime":{"description":"Native Facebook scheduling: ISO 8601 or unix seconds, 10 minutes to 30 days ahead (Reels ≤29 days). Not for Stories. Socialit-side scheduling does not need this.","anyOf":[{"type":"string"},{"type":"integer"}]},"geoRestriction":{"type":"object","description":"Hard visibility restriction (Graph `targeting.geo_locations.countries`). Feed posts, videos, Reels.","required":["countries"],"properties":{"countries":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string","pattern":"^[A-Z]{2}$"}}}},"targeting":{"type":"object","description":"Raw Graph `targeting` object (who can see the post). Overrides geoRestriction."},"feedTargeting":{"type":"object","description":"Raw Graph `feed_targeting` (News Feed preference, does not restrict visibility): geo_locations {countries|regions|cities}, age_min, age_max, genders, locales, interests… Do not mix countries with regions."},"place":{"type":"string","pattern":"^\\d+$","description":"Location tag: id of a Page with a location."},"carouselCards":{"type":"array","minItems":2,"maxItems":10,"description":"Multi-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.","items":{"type":"object","required":["link"],"properties":{"link":{"type":"string","format":"uri"},"name":{"type":"string","maxLength":255,"description":"Headline (~35 chars shown)."},"description":{"type":"string","maxLength":255,"description":"Subhead (~30 chars shown)."},"picture":{"type":"string","format":"uri","description":"Card image URL (defaults to media[i].url)."}}}},"carouselLink":{"type":"string","format":"uri","description":"\"See more\" end-card URL (defaults to the first card link)."},"multiShareOptimized":{"type":"boolean","description":"Let Facebook reorder carousel cards by performance."},"multiShareEndCard":{"type":"boolean","description":"Show the Page end card on carousels."},"textFormatPresetId":{"type":"string","pattern":"^\\d+$","description":"Text background preset (text-only feed posts; rejected with media, cards, link or empty content)."},"callToAction":{"type":"object","description":"Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)","required":["type"],"properties":{"type":{"type":"string","enum":["LEARN_MORE","SHOP_NOW","BOOK_TRAVEL","SIGN_UP","DOWNLOAD","WATCH_MORE","CONTACT_US","APPLY_NOW","GET_DIRECTIONS","CALL_NOW","MESSAGE_PAGE","ORDER_NOW","SUBSCRIBE","GET_QUOTE","NO_BUTTON"]},"link":{"type":"string","format":"uri"},"appLink":{"type":"string"}}},"backdatedTime":{"description":"Backdate a feed/photo post (ISO or unix).","anyOf":[{"type":"string"},{"type":"integer"}]},"backdatedTimeGranularity":{"type":"string","enum":["year","month","day","hour","min","none"]},"noStory":{"type":"boolean","description":"Photos/videos: upload without generating a feed story."},"altText":{"type":"string","description":"Alt text for photos (alt_text_custom). media[].altText wins per image."},"firstComment":{"type":"string","maxLength":8000,"description":"Comment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules)."},"thumbnailUrl":{"type":"string","format":"uri","description":"Custom video / Reel cover (≤10 MB). media[].thumbnail wins."},"contentTags":{"type":"array","items":{"type":"string"},"description":"Video content tag ids."},"secret":{"type":"boolean","description":"Video: hide from the Page (unlisted)."},"embeddable":{"type":"boolean","description":"Video: allow embedding."},"socialActions":{"type":"boolean","description":"Video: allow likes/comments/shares."},"crosspostToPageIds":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"description":"Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship)."},"crosspostingActions":{"type":"array","description":"Raw Graph `crossposting_actions` ([{ page_id, action }]); overrides crosspostToPageIds. (verify)","items":{"type":"object"}},"collaborators":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"description":"Reels: Page ids to invite as collaborators (10 invites / Page / 24 h)."},"uploadMode":{"type":"string","enum":["auto","url","resumable"],"default":"auto","description":"Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided."},"videoState":{"type":"string","enum":["PUBLISHED","SCHEDULED","DRAFT"],"description":"Reels: explicit video_state (derived from draft/schedule by default)."},"waitForUpload":{"type":"boolean","default":true,"description":"Reels/video Stories: poll upload status before finishing."}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-scheduled-posts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message":{"type":"string","maxLength":63206},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"scheduled_publish_time":{"type":["null","string"],"format":"date-time"},"permalink_url":{"type":"string","format":"uri","readOnly":true},"full_picture":{"type":"string","format":"uri","readOnly":true},"status_type":{"type":"string","readOnly":true},"is_published":{"type":"boolean","readOnly":true},"shares":{"type":"integer","readOnly":true},"reactions":{"type":"integer","readOnly":true},"comments":{"type":"integer","readOnly":true},"from":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/scheduled-posts/{itemId}":{"patch":{"operationId":"facebookScheduledPostsUpdate","summary":"Facebook Page: Update a Scheduled on Facebook item","tags":["Focus · Facebook Page"],"description":"Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/scheduled-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"scheduled_publish_time":{"type":"string","format":"date-time"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-scheduled-posts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message":{"type":"string","maxLength":63206},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"scheduled_publish_time":{"type":["null","string"],"format":"date-time"},"permalink_url":{"type":"string","format":"uri","readOnly":true},"full_picture":{"type":"string","format":"uri","readOnly":true},"status_type":{"type":"string","readOnly":true},"is_published":{"type":"boolean","readOnly":true},"shares":{"type":"integer","readOnly":true},"reactions":{"type":"integer","readOnly":true},"comments":{"type":"integer","readOnly":true},"from":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookScheduledPostsDelete","summary":"Facebook Page: Delete a Scheduled on Facebook item","tags":["Focus · Facebook Page"],"description":"Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/scheduled-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-scheduled-posts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/scheduled-posts/{itemId}/publish-now":{"post":{"operationId":"facebookScheduledPostsPublishNow","summary":"Facebook Page: Publish now (Scheduled on Facebook)","tags":["Focus · Facebook Page"],"description":"Publish now. Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/scheduled-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-scheduled-posts-publish-now","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/scheduled-posts/{itemId}/reschedule":{"post":{"operationId":"facebookScheduledPostsReschedule","summary":"Facebook Page: Reschedule (Scheduled on Facebook)","tags":["Focus · Facebook Page"],"description":"Reschedule. Posts scheduled natively on Facebook (10 minutes to 30 days ahead). Reschedule or publish now. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/pages-api/posts Generic route: `/v1/accounts/{accountId}/focus/scheduled-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduled_publish_time":{"type":"string","format":"date-time"}},"required":["scheduled_publish_time"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-scheduled-posts-reschedule","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/visitor-posts":{"get":{"operationId":"facebookVisitorPostsList","summary":"Facebook Page: List Visitor posts","tags":["Focus · Facebook Page"],"description":"Posts by people on the Page. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_user_content. Generic route: `/v1/accounts/{accountId}/focus/visitor-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-visitor-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/visitor-posts/{itemId}":{"delete":{"operationId":"facebookVisitorPostsDelete","summary":"Facebook Page: Delete a Visitor posts item","tags":["Focus · Facebook Page"],"description":"Posts by people on the Page. Requires scopes: pages_read_user_content, pages_manage_engagement. Generic route: `/v1/accounts/{accountId}/focus/visitor-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-visitor-posts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/visitor-posts/{itemId}/reply":{"post":{"operationId":"facebookVisitorPostsReply","summary":"Facebook Page: Reply (Visitor posts)","tags":["Focus · Facebook Page"],"description":"Reply. Posts by people on the Page. Requires scopes: pages_read_user_content, pages_manage_engagement. Generic route: `/v1/accounts/{accountId}/focus/visitor-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":8000}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-visitor-posts-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/photos":{"get":{"operationId":"facebookPhotosList","summary":"Facebook Page: List Photos","tags":["Focus · Facebook Page"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/photos/ Generic route: `/v1/accounts/{accountId}/focus/photos`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["uploaded","tagged"],"default":"uploaded"},"in":"query","name":"type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-photos-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":"string","readOnly":true},"alt_text":{"type":"string","description":"alt_text_custom"},"created_time":{"type":"string","format":"date-time","readOnly":true},"link":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"image_url":{"type":"string","format":"uri","readOnly":true},"width":{"type":"integer","readOnly":true},"height":{"type":"integer","readOnly":true},"album":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookPhotosCreate","summary":"Facebook Page: Create a Photos item","tags":["Focus · Facebook Page"],"description":"Publish a photo (or 2-10 photos as one post). Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/photos/ Generic route: `/v1/accounts/{accountId}/focus/photos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":63206},"media":{"type":"array","items":{"type":"object","properties":{"mediaId":{"type":"string","description":"Socialit media id"},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video"]},"altText":{"type":"string"},"thumbnail":{"type":"string","format":"uri","description":"Video cover URL"},"subtitles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"language":{"type":"string"}}}}},"description":"Media id or public URL"},"maxItems":10},"options":{"type":"object","title":"Facebook Page options","additionalProperties":true,"properties":{"contentType":{"type":"string","enum":["feed","reel","story"],"default":"feed","description":"feed = Page post (text, link, photos, video, carousel); reel = single vertical 3-90 s video; story = 1 photo or video ≤60 s, 24 h, no caption."},"pageId":{"type":"string","pattern":"^\\d+$","description":"Publish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token."},"link":{"type":"string","format":"uri","description":"Link to share (feed text posts). Generates a link preview."},"title":{"type":"string","maxLength":255,"description":"Video / Reel title (separate from the caption)."},"draft":{"type":"boolean","default":false,"description":"Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped."},"published":{"type":"boolean","default":true,"description":"false = unpublished (same as draft)."},"scheduledPublishTime":{"description":"Native Facebook scheduling: ISO 8601 or unix seconds, 10 minutes to 30 days ahead (Reels ≤29 days). Not for Stories. Socialit-side scheduling does not need this.","anyOf":[{"type":"string"},{"type":"integer"}]},"geoRestriction":{"type":"object","description":"Hard visibility restriction (Graph `targeting.geo_locations.countries`). Feed posts, videos, Reels.","required":["countries"],"properties":{"countries":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string","pattern":"^[A-Z]{2}$"}}}},"targeting":{"type":"object","description":"Raw Graph `targeting` object (who can see the post). Overrides geoRestriction."},"feedTargeting":{"type":"object","description":"Raw Graph `feed_targeting` (News Feed preference, does not restrict visibility): geo_locations {countries|regions|cities}, age_min, age_max, genders, locales, interests… Do not mix countries with regions."},"place":{"type":"string","pattern":"^\\d+$","description":"Location tag: id of a Page with a location."},"carouselCards":{"type":"array","minItems":2,"maxItems":10,"description":"Multi-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.","items":{"type":"object","required":["link"],"properties":{"link":{"type":"string","format":"uri"},"name":{"type":"string","maxLength":255,"description":"Headline (~35 chars shown)."},"description":{"type":"string","maxLength":255,"description":"Subhead (~30 chars shown)."},"picture":{"type":"string","format":"uri","description":"Card image URL (defaults to media[i].url)."}}}},"carouselLink":{"type":"string","format":"uri","description":"\"See more\" end-card URL (defaults to the first card link)."},"multiShareOptimized":{"type":"boolean","description":"Let Facebook reorder carousel cards by performance."},"multiShareEndCard":{"type":"boolean","description":"Show the Page end card on carousels."},"textFormatPresetId":{"type":"string","pattern":"^\\d+$","description":"Text background preset (text-only feed posts; rejected with media, cards, link or empty content)."},"callToAction":{"type":"object","description":"Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)","required":["type"],"properties":{"type":{"type":"string","enum":["LEARN_MORE","SHOP_NOW","BOOK_TRAVEL","SIGN_UP","DOWNLOAD","WATCH_MORE","CONTACT_US","APPLY_NOW","GET_DIRECTIONS","CALL_NOW","MESSAGE_PAGE","ORDER_NOW","SUBSCRIBE","GET_QUOTE","NO_BUTTON"]},"link":{"type":"string","format":"uri"},"appLink":{"type":"string"}}},"backdatedTime":{"description":"Backdate a feed/photo post (ISO or unix).","anyOf":[{"type":"string"},{"type":"integer"}]},"backdatedTimeGranularity":{"type":"string","enum":["year","month","day","hour","min","none"]},"noStory":{"type":"boolean","description":"Photos/videos: upload without generating a feed story."},"altText":{"type":"string","description":"Alt text for photos (alt_text_custom). media[].altText wins per image."},"firstComment":{"type":"string","maxLength":8000,"description":"Comment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules)."},"thumbnailUrl":{"type":"string","format":"uri","description":"Custom video / Reel cover (≤10 MB). media[].thumbnail wins."},"contentTags":{"type":"array","items":{"type":"string"},"description":"Video content tag ids."},"secret":{"type":"boolean","description":"Video: hide from the Page (unlisted)."},"embeddable":{"type":"boolean","description":"Video: allow embedding."},"socialActions":{"type":"boolean","description":"Video: allow likes/comments/shares."},"crosspostToPageIds":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"description":"Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship)."},"crosspostingActions":{"type":"array","description":"Raw Graph `crossposting_actions` ([{ page_id, action }]); overrides crosspostToPageIds. (verify)","items":{"type":"object"}},"collaborators":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"description":"Reels: Page ids to invite as collaborators (10 invites / Page / 24 h)."},"uploadMode":{"type":"string","enum":["auto","url","resumable"],"default":"auto","description":"Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided."},"videoState":{"type":"string","enum":["PUBLISHED","SCHEDULED","DRAFT"],"description":"Reels: explicit video_state (derived from draft/schedule by default)."},"waitForUpload":{"type":"boolean","default":true,"description":"Reels/video Stories: poll upload status before finishing."}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-photos-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":"string","readOnly":true},"alt_text":{"type":"string","description":"alt_text_custom"},"created_time":{"type":"string","format":"date-time","readOnly":true},"link":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"image_url":{"type":"string","format":"uri","readOnly":true},"width":{"type":"integer","readOnly":true},"height":{"type":"integer","readOnly":true},"album":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/photos/{itemId}":{"get":{"operationId":"facebookPhotosGet","summary":"Facebook Page: Get a Photos item","tags":["Focus · Facebook Page"],"description":"Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/photos/ Generic route: `/v1/accounts/{accountId}/focus/photos`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-photos-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":"string","readOnly":true},"alt_text":{"type":"string","description":"alt_text_custom"},"created_time":{"type":"string","format":"date-time","readOnly":true},"link":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"image_url":{"type":"string","format":"uri","readOnly":true},"width":{"type":"integer","readOnly":true},"height":{"type":"integer","readOnly":true},"album":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookPhotosUpdate","summary":"Facebook Page: Update a Photos item","tags":["Focus · Facebook Page"],"description":"Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/photos/ Generic route: `/v1/accounts/{accountId}/focus/photos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"alt_text":{"type":"string"}},"required":["alt_text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-photos-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":"string","readOnly":true},"alt_text":{"type":"string","description":"alt_text_custom"},"created_time":{"type":"string","format":"date-time","readOnly":true},"link":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"image_url":{"type":"string","format":"uri","readOnly":true},"width":{"type":"integer","readOnly":true},"height":{"type":"integer","readOnly":true},"album":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookPhotosDelete","summary":"Facebook Page: Delete a Photos item","tags":["Focus · Facebook Page"],"description":"Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/photos/ Generic route: `/v1/accounts/{accountId}/focus/photos`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-photos-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/albums":{"get":{"operationId":"facebookAlbumsList","summary":"Facebook Page: List Albums","tags":["Focus · Facebook Page"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/albums/ Generic route: `/v1/accounts/{accountId}/focus/albums`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-albums-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"description":{"type":"string"},"count":{"type":"integer","readOnly":true},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"link":{"type":"string","format":"uri","readOnly":true},"type":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookAlbumsCreate","summary":"Facebook Page: Create a Albums item","tags":["Focus · Facebook Page"],"description":"Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/albums/ Generic route: `/v1/accounts/{accountId}/focus/albums`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"place":{"type":"string"}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-albums-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"description":{"type":"string"},"count":{"type":"integer","readOnly":true},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"link":{"type":"string","format":"uri","readOnly":true},"type":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/albums/{itemId}/photos":{"post":{"operationId":"facebookAlbumsPhotos","summary":"Facebook Page: List photos (Albums)","tags":["Focus · Facebook Page"],"description":"List photos. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/albums/ Generic route: `/v1/accounts/{accountId}/focus/albums`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-albums-photos","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/albums/{itemId}/add-photo":{"post":{"operationId":"facebookAlbumsAddPhoto","summary":"Facebook Page: Add photo (Albums)","tags":["Focus · Facebook Page"],"description":"Add photo. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/albums/ Generic route: `/v1/accounts/{accountId}/focus/albums`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"mediaId":{"type":"string"},"caption":{"type":"string"},"altText":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-albums-add-photo","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/videos":{"get":{"operationId":"facebookVideosList","summary":"Facebook Page: List Videos","tags":["Focus · Facebook Page"],"description":"Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["uploaded","tagged"],"default":"uploaded"},"in":"query","name":"type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"length":{"type":"number","description":"seconds","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"published":{"type":"boolean","readOnly":true},"status":{"type":"string","readOnly":true},"embeddable":{"type":"boolean"},"post_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookVideosCreate","summary":"Facebook Page: Create a Videos item","tags":["Focus · Facebook Page"],"description":"Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":63206},"media":{"type":"array","items":{"type":"object","properties":{"mediaId":{"type":"string","description":"Socialit media id"},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video"]},"altText":{"type":"string"},"thumbnail":{"type":"string","format":"uri","description":"Video cover URL"},"subtitles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"language":{"type":"string"}}}}},"description":"Media id or public URL"},"maxItems":10},"options":{"type":"object","title":"Facebook Page options","additionalProperties":true,"properties":{"contentType":{"type":"string","enum":["feed","reel","story"],"default":"feed","description":"feed = Page post (text, link, photos, video, carousel); reel = single vertical 3-90 s video; story = 1 photo or video ≤60 s, 24 h, no caption."},"pageId":{"type":"string","pattern":"^\\d+$","description":"Publish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token."},"link":{"type":"string","format":"uri","description":"Link to share (feed text posts). Generates a link preview."},"title":{"type":"string","maxLength":255,"description":"Video / Reel title (separate from the caption)."},"draft":{"type":"boolean","default":false,"description":"Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped."},"published":{"type":"boolean","default":true,"description":"false = unpublished (same as draft)."},"scheduledPublishTime":{"description":"Native Facebook scheduling: ISO 8601 or unix seconds, 10 minutes to 30 days ahead (Reels ≤29 days). Not for Stories. Socialit-side scheduling does not need this.","anyOf":[{"type":"string"},{"type":"integer"}]},"geoRestriction":{"type":"object","description":"Hard visibility restriction (Graph `targeting.geo_locations.countries`). Feed posts, videos, Reels.","required":["countries"],"properties":{"countries":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string","pattern":"^[A-Z]{2}$"}}}},"targeting":{"type":"object","description":"Raw Graph `targeting` object (who can see the post). Overrides geoRestriction."},"feedTargeting":{"type":"object","description":"Raw Graph `feed_targeting` (News Feed preference, does not restrict visibility): geo_locations {countries|regions|cities}, age_min, age_max, genders, locales, interests… Do not mix countries with regions."},"place":{"type":"string","pattern":"^\\d+$","description":"Location tag: id of a Page with a location."},"carouselCards":{"type":"array","minItems":2,"maxItems":10,"description":"Multi-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.","items":{"type":"object","required":["link"],"properties":{"link":{"type":"string","format":"uri"},"name":{"type":"string","maxLength":255,"description":"Headline (~35 chars shown)."},"description":{"type":"string","maxLength":255,"description":"Subhead (~30 chars shown)."},"picture":{"type":"string","format":"uri","description":"Card image URL (defaults to media[i].url)."}}}},"carouselLink":{"type":"string","format":"uri","description":"\"See more\" end-card URL (defaults to the first card link)."},"multiShareOptimized":{"type":"boolean","description":"Let Facebook reorder carousel cards by performance."},"multiShareEndCard":{"type":"boolean","description":"Show the Page end card on carousels."},"textFormatPresetId":{"type":"string","pattern":"^\\d+$","description":"Text background preset (text-only feed posts; rejected with media, cards, link or empty content)."},"callToAction":{"type":"object","description":"Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)","required":["type"],"properties":{"type":{"type":"string","enum":["LEARN_MORE","SHOP_NOW","BOOK_TRAVEL","SIGN_UP","DOWNLOAD","WATCH_MORE","CONTACT_US","APPLY_NOW","GET_DIRECTIONS","CALL_NOW","MESSAGE_PAGE","ORDER_NOW","SUBSCRIBE","GET_QUOTE","NO_BUTTON"]},"link":{"type":"string","format":"uri"},"appLink":{"type":"string"}}},"backdatedTime":{"description":"Backdate a feed/photo post (ISO or unix).","anyOf":[{"type":"string"},{"type":"integer"}]},"backdatedTimeGranularity":{"type":"string","enum":["year","month","day","hour","min","none"]},"noStory":{"type":"boolean","description":"Photos/videos: upload without generating a feed story."},"altText":{"type":"string","description":"Alt text for photos (alt_text_custom). media[].altText wins per image."},"firstComment":{"type":"string","maxLength":8000,"description":"Comment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules)."},"thumbnailUrl":{"type":"string","format":"uri","description":"Custom video / Reel cover (≤10 MB). media[].thumbnail wins."},"contentTags":{"type":"array","items":{"type":"string"},"description":"Video content tag ids."},"secret":{"type":"boolean","description":"Video: hide from the Page (unlisted)."},"embeddable":{"type":"boolean","description":"Video: allow embedding."},"socialActions":{"type":"boolean","description":"Video: allow likes/comments/shares."},"crosspostToPageIds":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"description":"Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship)."},"crosspostingActions":{"type":"array","description":"Raw Graph `crossposting_actions` ([{ page_id, action }]); overrides crosspostToPageIds. (verify)","items":{"type":"object"}},"collaborators":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"description":"Reels: Page ids to invite as collaborators (10 invites / Page / 24 h)."},"uploadMode":{"type":"string","enum":["auto","url","resumable"],"default":"auto","description":"Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided."},"videoState":{"type":"string","enum":["PUBLISHED","SCHEDULED","DRAFT"],"description":"Reels: explicit video_state (derived from draft/schedule by default)."},"waitForUpload":{"type":"boolean","default":true,"description":"Reels/video Stories: poll upload status before finishing."}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"length":{"type":"number","description":"seconds","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"published":{"type":"boolean","readOnly":true},"status":{"type":"string","readOnly":true},"embeddable":{"type":"boolean"},"post_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/videos/{itemId}":{"get":{"operationId":"facebookVideosGet","summary":"Facebook Page: Get a Videos item","tags":["Focus · Facebook Page"],"description":"Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"length":{"type":"number","description":"seconds","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"published":{"type":"boolean","readOnly":true},"status":{"type":"string","readOnly":true},"embeddable":{"type":"boolean"},"post_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookVideosUpdate","summary":"Facebook Page: Update a Videos item","tags":["Focus · Facebook Page"],"description":"Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":255},"description":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"length":{"type":"number","description":"seconds","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"published":{"type":"boolean","readOnly":true},"status":{"type":"string","readOnly":true},"embeddable":{"type":"boolean"},"post_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookVideosDelete","summary":"Facebook Page: Delete a Videos item","tags":["Focus · Facebook Page"],"description":"Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/videos/{itemId}/insights":{"post":{"operationId":"facebookVideosInsights","summary":"Facebook Page: Video insights (Videos)","tags":["Focus · Facebook Page"],"description":"Video insights. Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, read_insights. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-insights","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/videos/{itemId}/thumbnails":{"post":{"operationId":"facebookVideosThumbnails","summary":"Facebook Page: Thumbnails (Videos)","tags":["Focus · Facebook Page"],"description":"Thumbnails. Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-thumbnails","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/videos/{itemId}/set-thumbnail":{"post":{"operationId":"facebookVideosSetThumbnail","summary":"Facebook Page: Upload thumbnail (Videos)","tags":["Focus · Facebook Page"],"description":"Upload thumbnail. Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"mediaId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-set-thumbnail","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/videos/{itemId}/captions":{"post":{"operationId":"facebookVideosCaptions","summary":"Facebook Page: Captions (Videos)","tags":["Focus · Facebook Page"],"description":"Captions. Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-captions","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/videos/{itemId}/add-captions":{"post":{"operationId":"facebookVideosAddCaptions","summary":"Facebook Page: Upload captions (.srt) (Videos)","tags":["Focus · Facebook Page"],"description":"Upload captions (.srt). Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"language":{"type":"string","default":"en_US"},"isDefault":{"type":"boolean"}},"required":["url"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-add-captions","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/videos/{itemId}/delete-captions":{"post":{"operationId":"facebookVideosDeleteCaptions","summary":"Facebook Page: Delete captions (Videos)","tags":["Focus · Facebook Page"],"description":"Delete captions. Feed videos: upload (URL or resumable up to 10 GB), edit title/description, thumbnails, captions, crosspost. Destructive. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/publishing Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locale":{"type":"string"}},"required":["locale"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_facebook","x-mcp-tool":"facebook-videos-delete-captions","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reels":{"get":{"operationId":"facebookReelsList","summary":"Facebook Page: List Reels","tags":["Focus · Facebook Page"],"description":"Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reels-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"length":{"type":"number","description":"seconds","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"published":{"type":"boolean","readOnly":true},"status":{"type":"string","readOnly":true},"embeddable":{"type":"boolean"},"post_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookReelsCreate","summary":"Facebook Page: Create a Reels item","tags":["Focus · Facebook Page"],"description":"Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":63206},"media":{"type":"array","items":{"type":"object","properties":{"mediaId":{"type":"string","description":"Socialit media id"},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video"]},"altText":{"type":"string"},"thumbnail":{"type":"string","format":"uri","description":"Video cover URL"},"subtitles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"language":{"type":"string"}}}}},"description":"Media id or public URL"},"maxItems":10},"options":{"type":"object","title":"Facebook Page options","additionalProperties":true,"properties":{"contentType":{"type":"string","enum":["feed","reel","story"],"default":"feed","description":"feed = Page post (text, link, photos, video, carousel); reel = single vertical 3-90 s video; story = 1 photo or video ≤60 s, 24 h, no caption."},"pageId":{"type":"string","pattern":"^\\d+$","description":"Publish to another Page the connecting user manages (Zernio multi-Page). Defaults to the connected Page. Needs the user token."},"link":{"type":"string","format":"uri","description":"Link to share (feed text posts). Generates a link preview."},"title":{"type":"string","maxLength":255,"description":"Video / Reel title (separate from the caption)."},"draft":{"type":"boolean","default":false,"description":"Create an unpublished draft in Meta Publishing Tools (feed and Reels; not Stories). First comment is skipped."},"published":{"type":"boolean","default":true,"description":"false = unpublished (same as draft)."},"scheduledPublishTime":{"description":"Native Facebook scheduling: ISO 8601 or unix seconds, 10 minutes to 30 days ahead (Reels ≤29 days). Not for Stories. Socialit-side scheduling does not need this.","anyOf":[{"type":"string"},{"type":"integer"}]},"geoRestriction":{"type":"object","description":"Hard visibility restriction (Graph `targeting.geo_locations.countries`). Feed posts, videos, Reels.","required":["countries"],"properties":{"countries":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string","pattern":"^[A-Z]{2}$"}}}},"targeting":{"type":"object","description":"Raw Graph `targeting` object (who can see the post). Overrides geoRestriction."},"feedTargeting":{"type":"object","description":"Raw Graph `feed_targeting` (News Feed preference, does not restrict visibility): geo_locations {countries|regions|cities}, age_min, age_max, genders, locales, interests… Do not mix countries with regions."},"place":{"type":"string","pattern":"^\\d+$","description":"Location tag: id of a Page with a location."},"carouselCards":{"type":"array","minItems":2,"maxItems":10,"description":"Multi-link carousel (child_attachments). Media must be images, one per card (same length), or set card.picture. Mutually exclusive with contentType reel/story.","items":{"type":"object","required":["link"],"properties":{"link":{"type":"string","format":"uri"},"name":{"type":"string","maxLength":255,"description":"Headline (~35 chars shown)."},"description":{"type":"string","maxLength":255,"description":"Subhead (~30 chars shown)."},"picture":{"type":"string","format":"uri","description":"Card image URL (defaults to media[i].url)."}}}},"carouselLink":{"type":"string","format":"uri","description":"\"See more\" end-card URL (defaults to the first card link)."},"multiShareOptimized":{"type":"boolean","description":"Let Facebook reorder carousel cards by performance."},"multiShareEndCard":{"type":"boolean","description":"Show the Page end card on carousels."},"textFormatPresetId":{"type":"string","pattern":"^\\d+$","description":"Text background preset (text-only feed posts; rejected with media, cards, link or empty content)."},"callToAction":{"type":"object","description":"Link-post button (call_to_action). Requires a link. (verify: Meta may limit this to ads)","required":["type"],"properties":{"type":{"type":"string","enum":["LEARN_MORE","SHOP_NOW","BOOK_TRAVEL","SIGN_UP","DOWNLOAD","WATCH_MORE","CONTACT_US","APPLY_NOW","GET_DIRECTIONS","CALL_NOW","MESSAGE_PAGE","ORDER_NOW","SUBSCRIBE","GET_QUOTE","NO_BUTTON"]},"link":{"type":"string","format":"uri"},"appLink":{"type":"string"}}},"backdatedTime":{"description":"Backdate a feed/photo post (ISO or unix).","anyOf":[{"type":"string"},{"type":"integer"}]},"backdatedTimeGranularity":{"type":"string","enum":["year","month","day","hour","min","none"]},"noStory":{"type":"boolean","description":"Photos/videos: upload without generating a feed story."},"altText":{"type":"string","description":"Alt text for photos (alt_text_custom). media[].altText wins per image."},"firstComment":{"type":"string","maxLength":8000,"description":"Comment posted as the Page right after publishing (feed and Reels; skipped for Stories, drafts and native schedules)."},"thumbnailUrl":{"type":"string","format":"uri","description":"Custom video / Reel cover (≤10 MB). media[].thumbnail wins."},"contentTags":{"type":"array","items":{"type":"string"},"description":"Video content tag ids."},"secret":{"type":"boolean","description":"Video: hide from the Page (unlisted)."},"embeddable":{"type":"boolean","description":"Video: allow embedding."},"socialActions":{"type":"boolean","description":"Video: allow likes/comments/shares."},"crosspostToPageIds":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"description":"Video: enable crossposting and create a post on these partner Pages (requires an accepted crossposting relationship)."},"crosspostingActions":{"type":"array","description":"Raw Graph `crossposting_actions` ([{ page_id, action }]); overrides crosspostToPageIds. (verify)","items":{"type":"object"}},"collaborators":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"description":"Reels: Page ids to invite as collaborators (10 invites / Page / 24 h)."},"uploadMode":{"type":"string","enum":["auto","url","resumable"],"default":"auto","description":"Feed video upload: url = Facebook fetches file_url (≤1 GB); resumable = chunked upload of the bytes (≤10 GB); auto = resumable when bytes are provided."},"videoState":{"type":"string","enum":["PUBLISHED","SCHEDULED","DRAFT"],"description":"Reels: explicit video_state (derived from draft/schedule by default)."},"waitForUpload":{"type":"boolean","default":true,"description":"Reels/video Stories: poll upload status before finishing."}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reels-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"length":{"type":"number","description":"seconds","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"published":{"type":"boolean","readOnly":true},"status":{"type":"string","readOnly":true},"embeddable":{"type":"boolean"},"post_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reels/{itemId}":{"get":{"operationId":"facebookReelsGet","summary":"Facebook Page: Get a Reels item","tags":["Focus · Facebook Page"],"description":"Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reels-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"length":{"type":"number","description":"seconds","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"published":{"type":"boolean","readOnly":true},"status":{"type":"string","readOnly":true},"embeddable":{"type":"boolean"},"post_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookReelsUpdate","summary":"Facebook Page: Update a Reels item","tags":["Focus · Facebook Page"],"description":"Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reels-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":255},"description":{"type":"string"},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true},"length":{"type":"number","description":"seconds","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"published":{"type":"boolean","readOnly":true},"status":{"type":"string","readOnly":true},"embeddable":{"type":"boolean"},"post_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookReelsDelete","summary":"Facebook Page: Delete a Reels item","tags":["Focus · Facebook Page"],"description":"Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reels-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reels/{itemId}/insights":{"post":{"operationId":"facebookReelsInsights","summary":"Facebook Page: Reel insights (Reels)","tags":["Focus · Facebook Page"],"description":"Reel insights. Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement, read_insights. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reels-insights","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reels/{itemId}/collaborators":{"post":{"operationId":"facebookReelsCollaborators","summary":"Facebook Page: Collaborators (Reels)","tags":["Focus · Facebook Page"],"description":"Collaborators. Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reels-collaborators","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reels/{itemId}/invite-collaborator":{"post":{"operationId":"facebookReelsInviteCollaborator","summary":"Facebook Page: Invite collaborator (Reels)","tags":["Focus · Facebook Page"],"description":"Invite collaborator. Vertical 3-90 s videos. 30 API-published Reels per Page per 24 h. Collaborator invites. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/reels-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pageId":{"type":"string","pattern":"^\\d+$"}},"required":["pageId"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reels-invite-collaborator","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/stories":{"get":{"operationId":"facebookStoriesList","summary":"Facebook Page: List Stories","tags":["Focus · Facebook Page"],"description":"Page Stories (24 h). One photo or a ≤60 s video; no stickers, links or scheduling via API. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/page-stories-api Generic route: `/v1/accounts/{accountId}/focus/stories`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-stories-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status":{"type":"string","enum":["PUBLISHED","ARCHIVED"],"readOnly":true},"media_type":{"type":"string","readOnly":true},"media_id":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"created_time":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookStoriesCreate","summary":"Facebook Page: Create a Stories item","tags":["Focus · Facebook Page"],"description":"Page Stories (24 h). One photo or a ≤60 s video; no stickers, links or scheduling via API. Requires scopes: pages_read_engagement, pages_manage_posts. Network docs: https://developers.facebook.com/docs/page-stories-api Generic route: `/v1/accounts/{accountId}/focus/stories`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"array","items":{"type":"object","properties":{"mediaId":{"type":"string","description":"Socialit media id"},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video"]},"altText":{"type":"string"},"thumbnail":{"type":"string","format":"uri","description":"Video cover URL"},"subtitles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"language":{"type":"string"}}}}},"description":"Media id or public URL"},"minItems":1,"maxItems":1}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-stories-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status":{"type":"string","enum":["PUBLISHED","ARCHIVED"],"readOnly":true},"media_type":{"type":"string","readOnly":true},"media_id":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"created_time":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/stories/{itemId}/insights":{"post":{"operationId":"facebookStoriesInsights","summary":"Facebook Page: Story insights (Stories)","tags":["Focus · Facebook Page"],"description":"Story insights. Page Stories (24 h). One photo or a ≤60 s video; no stickers, links or scheduling via API. Requires scopes: pages_read_engagement, read_insights. Network docs: https://developers.facebook.com/docs/page-stories-api Generic route: `/v1/accounts/{accountId}/focus/stories`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-stories-insights","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/live-videos":{"get":{"operationId":"facebookLiveVideosList","summary":"Facebook Page: List Live","tags":["Focus · Facebook Page"],"description":"Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: `/v1/accounts/{accountId}/focus/live-videos`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["LIVE","UNPUBLISHED","SCHEDULED_UNPUBLISHED","VOD","PROCESSING"]},"in":"query","name":"broadcastStatus","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-live-videos-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["LIVE_NOW","SCHEDULED_UNPUBLISHED","UNPUBLISHED","LIVE","VOD","SCHEDULED_LIVE","SCHEDULED_CANCELED","PROCESSING"]},"planned_start_time":{"type":["null","string"],"format":"date-time"},"created_time":{"type":"string","format":"date-time","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"secure_stream_url":{"type":"string","description":"RTMPS URL (server + key)","readOnly":true},"stream_server":{"type":"string","readOnly":true},"stream_key":{"type":"string","format":"password","readOnly":true},"live_views":{"type":"integer","readOnly":true},"video_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookLiveVideosCreate","summary":"Facebook Page: Create a Live item","tags":["Focus · Facebook Page"],"description":"Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: `/v1/accounts/{accountId}/focus/live-videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["LIVE_NOW","SCHEDULED_UNPUBLISHED","UNPUBLISHED"],"default":"UNPUBLISHED"},"plannedStartTime":{"type":"string","format":"date-time"},"enableBackupIngest":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-live-videos-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["LIVE_NOW","SCHEDULED_UNPUBLISHED","UNPUBLISHED","LIVE","VOD","SCHEDULED_LIVE","SCHEDULED_CANCELED","PROCESSING"]},"planned_start_time":{"type":["null","string"],"format":"date-time"},"created_time":{"type":"string","format":"date-time","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"secure_stream_url":{"type":"string","description":"RTMPS URL (server + key)","readOnly":true},"stream_server":{"type":"string","readOnly":true},"stream_key":{"type":"string","format":"password","readOnly":true},"live_views":{"type":"integer","readOnly":true},"video_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/live-videos/{itemId}":{"get":{"operationId":"facebookLiveVideosGet","summary":"Facebook Page: Get a Live item","tags":["Focus · Facebook Page"],"description":"Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: `/v1/accounts/{accountId}/focus/live-videos`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-live-videos-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["LIVE_NOW","SCHEDULED_UNPUBLISHED","UNPUBLISHED","LIVE","VOD","SCHEDULED_LIVE","SCHEDULED_CANCELED","PROCESSING"]},"planned_start_time":{"type":["null","string"],"format":"date-time"},"created_time":{"type":"string","format":"date-time","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"secure_stream_url":{"type":"string","description":"RTMPS URL (server + key)","readOnly":true},"stream_server":{"type":"string","readOnly":true},"stream_key":{"type":"string","format":"password","readOnly":true},"live_views":{"type":"integer","readOnly":true},"video_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookLiveVideosUpdate","summary":"Facebook Page: Update a Live item","tags":["Focus · Facebook Page"],"description":"Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: `/v1/accounts/{accountId}/focus/live-videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"plannedStartTime":{"type":"string","format":"date-time"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-live-videos-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["LIVE_NOW","SCHEDULED_UNPUBLISHED","UNPUBLISHED","LIVE","VOD","SCHEDULED_LIVE","SCHEDULED_CANCELED","PROCESSING"]},"planned_start_time":{"type":["null","string"],"format":"date-time"},"created_time":{"type":"string","format":"date-time","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"secure_stream_url":{"type":"string","description":"RTMPS URL (server + key)","readOnly":true},"stream_server":{"type":"string","readOnly":true},"stream_key":{"type":"string","format":"password","readOnly":true},"live_views":{"type":"integer","readOnly":true},"video_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookLiveVideosDelete","summary":"Facebook Page: Delete a Live item","tags":["Focus · Facebook Page"],"description":"Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: `/v1/accounts/{accountId}/focus/live-videos`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-live-videos-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/live-videos/{itemId}/go-live":{"post":{"operationId":"facebookLiveVideosGoLive","summary":"Facebook Page: Go live (Live)","tags":["Focus · Facebook Page"],"description":"Go live. Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: `/v1/accounts/{accountId}/focus/live-videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-live-videos-go-live","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/live-videos/{itemId}/end":{"post":{"operationId":"facebookLiveVideosEnd","summary":"Facebook Page: End broadcast (Live)","tags":["Focus · Facebook Page"],"description":"End broadcast. Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Destructive. Requires scopes: publish_video, pages_manage_posts. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: `/v1/accounts/{accountId}/focus/live-videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_facebook","x-mcp-tool":"facebook-live-videos-end","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/live-videos/{itemId}/comments":{"post":{"operationId":"facebookLiveVideosComments","summary":"Facebook Page: Live comments (Live)","tags":["Focus · Facebook Page"],"description":"Live comments. Live broadcasts from an encoder (RTMPS). Requires publish_video and the Live Video API feature. Requires scopes: publish_video, pages_manage_posts, pages_read_user_content. Network docs: https://developers.facebook.com/docs/live-video-api/getting-started Generic route: `/v1/accounts/{accountId}/focus/live-videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-live-videos-comments","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/crossposting":{"get":{"operationId":"facebookCrosspostingList","summary":"Facebook Page: List Crossposting","tags":["Focus · Facebook Page"],"description":"Video crossposting relationships with partner Pages; crosspost a partner video. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/crossposting Generic route: `/v1/accounts/{accountId}/focus/crossposting`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-crossposting-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"allows_live_crossposts":{"type":["null","boolean"],"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookCrosspostingCreate","summary":"Facebook Page: Create a Crossposting item","tags":["Focus · Facebook Page"],"description":"Request a crossposting relationship (handshake) with partner Pages. Video crossposting relationships with partner Pages; crosspost a partner video. Requires scopes: pages_manage_posts, pages_manage_metadata. Network docs: https://developers.facebook.com/docs/video-api/guides/crossposting Generic route: `/v1/accounts/{accountId}/focus/crossposting`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"partnerPageIds":{"type":"array","items":{"type":"string","pattern":"^\\d+$"},"minItems":1},"allowLive":{"type":"boolean","default":true}},"required":["partnerPageIds"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-crossposting-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"allows_live_crossposts":{"type":["null","boolean"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/crossposting/accept":{"post":{"operationId":"facebookCrosspostingAccept","summary":"Facebook Page: Accept handshake (Crossposting)","tags":["Focus · Facebook Page"],"description":"Accept handshake. Video crossposting relationships with partner Pages; crosspost a partner video. Requires scopes: pages_manage_posts, pages_manage_metadata. Network docs: https://developers.facebook.com/docs/video-api/guides/crossposting Generic route: `/v1/accounts/{accountId}/focus/crossposting`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"partnerPageId":{"type":"string"},"allowLive":{"type":"boolean","default":true}},"required":["partnerPageId"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-crossposting-accept","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/crossposting/crosspost-video":{"post":{"operationId":"facebookCrosspostingCrosspostVideo","summary":"Facebook Page: Crosspost a video (Crossposting)","tags":["Focus · Facebook Page"],"description":"Crosspost a video. Video crossposting relationships with partner Pages; crosspost a partner video. Requires scopes: pages_manage_posts. Network docs: https://developers.facebook.com/docs/video-api/guides/crossposting Generic route: `/v1/accounts/{accountId}/focus/crossposting`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"videoId":{"type":"string"},"description":{"type":"string"},"scheduledPublishTime":{"type":"string","format":"date-time"}},"required":["videoId"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-crossposting-crosspost-video","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/commented-posts":{"get":{"operationId":"facebookCommentedPostsList","summary":"Facebook Page: List Posts with comments","tags":["Focus · Facebook Page"],"description":"Recent Page posts with comment counts — pick one to moderate its comments. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement. Generic route: `/v1/accounts/{accountId}/focus/commented-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"integer","minimum":0},"in":"query","name":"minComments","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-commented-posts-list","x-zernio":["GET /v1/inbox/comments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message":{"type":"string","readOnly":true},"created_time":{"type":"string","format":"date-time","readOnly":true},"permalink_url":{"type":"string","format":"uri","readOnly":true},"full_picture":{"type":"string","format":"uri","readOnly":true},"comment_count":{"type":"integer","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/comments":{"get":{"operationId":"facebookCommentsList","summary":"Facebook Page: List Comments","tags":["Focus · Facebook Page"],"description":"Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement, pages_read_user_content. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"object_id","required":true,"description":"Post / photo / video / comment id"},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["toplevel","stream"],"default":"toplevel"},"in":"query","name":"filter","required":false},{"schema":{"type":"string","enum":["chronological","reverse_chronological"],"default":"reverse_chronological"},"in":"query","name":"order","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":8000},"author":{"type":"string","readOnly":true},"author_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"post_id":{"type":["null","string"],"readOnly":true},"is_hidden":{"type":"boolean","readOnly":true},"can_hide":{"type":["null","boolean"],"readOnly":true},"can_remove":{"type":["null","boolean"],"readOnly":true},"can_reply_privately":{"type":["null","boolean"],"readOnly":true},"liked_by_page":{"type":"boolean","readOnly":true},"from_page":{"type":"boolean","readOnly":true},"attachment":{"type":["null","object"],"properties":{},"readOnly":true},"permalink_url":{"type":["null","string"],"format":"uri","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookCommentsCreate","summary":"Facebook Page: Create a Comments item","tags":["Focus · Facebook Page"],"description":"Comment on an object (top-level) or reply to a comment (object_id = comment id). Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"object_id":{"type":"string"},"message":{"type":"string","maxLength":8000},"attachmentUrl":{"type":"string","format":"uri","description":"Photo / GIF comment"},"attachmentShareUrl":{"type":"string","format":"uri"}},"required":["object_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}","POST /v1/inbox/comments/{postId}/{commentId}/hide","POST /v1/inbox/comments/{postId}/{commentId}/like","POST /v1/inbox/comments/{postId}/{commentId}/private-reply"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":8000},"author":{"type":"string","readOnly":true},"author_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"post_id":{"type":["null","string"],"readOnly":true},"is_hidden":{"type":"boolean","readOnly":true},"can_hide":{"type":["null","boolean"],"readOnly":true},"can_remove":{"type":["null","boolean"],"readOnly":true},"can_reply_privately":{"type":["null","boolean"],"readOnly":true},"liked_by_page":{"type":"boolean","readOnly":true},"from_page":{"type":"boolean","readOnly":true},"attachment":{"type":["null","object"],"properties":{},"readOnly":true},"permalink_url":{"type":["null","string"],"format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/comments/{itemId}":{"get":{"operationId":"facebookCommentsGet","summary":"Facebook Page: Get a Comments item","tags":["Focus · Facebook Page"],"description":"Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-get","x-zernio":["GET /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":8000},"author":{"type":"string","readOnly":true},"author_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"post_id":{"type":["null","string"],"readOnly":true},"is_hidden":{"type":"boolean","readOnly":true},"can_hide":{"type":["null","boolean"],"readOnly":true},"can_remove":{"type":["null","boolean"],"readOnly":true},"can_reply_privately":{"type":["null","boolean"],"readOnly":true},"liked_by_page":{"type":"boolean","readOnly":true},"from_page":{"type":"boolean","readOnly":true},"attachment":{"type":["null","object"],"properties":{},"readOnly":true},"permalink_url":{"type":["null","string"],"format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookCommentsUpdate","summary":"Facebook Page: Update a Comments item","tags":["Focus · Facebook Page"],"description":"Edit a comment the Page wrote. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":8000}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":8000},"author":{"type":"string","readOnly":true},"author_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"post_id":{"type":["null","string"],"readOnly":true},"is_hidden":{"type":"boolean","readOnly":true},"can_hide":{"type":["null","boolean"],"readOnly":true},"can_remove":{"type":["null","boolean"],"readOnly":true},"can_reply_privately":{"type":["null","boolean"],"readOnly":true},"liked_by_page":{"type":"boolean","readOnly":true},"from_page":{"type":"boolean","readOnly":true},"attachment":{"type":["null","object"],"properties":{},"readOnly":true},"permalink_url":{"type":["null","string"],"format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookCommentsDelete","summary":"Facebook Page: Delete a Comments item","tags":["Focus · Facebook Page"],"description":"Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-delete","x-zernio":["DELETE /v1/inbox/comments/{postId}","DELETE /v1/inbox/comments/{postId}/{commentId}/hide","DELETE /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/comments/{itemId}/reply":{"post":{"operationId":"facebookCommentsReply","summary":"Facebook Page: Reply (Comments)","tags":["Focus · Facebook Page"],"description":"Reply. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":8000},"attachmentUrl":{"type":"string","format":"uri"}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/comments/{itemId}/hide":{"post":{"operationId":"facebookCommentsHide","summary":"Facebook Page: Hide (Comments)","tags":["Focus · Facebook Page"],"description":"Hide. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/comments/{itemId}/unhide":{"post":{"operationId":"facebookCommentsUnhide","summary":"Facebook Page: Unhide (Comments)","tags":["Focus · Facebook Page"],"description":"Unhide. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-unhide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/comments/{itemId}/like":{"post":{"operationId":"facebookCommentsLike","summary":"Facebook Page: Like (Comments)","tags":["Focus · Facebook Page"],"description":"Like. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/comments/{itemId}/unlike":{"post":{"operationId":"facebookCommentsUnlike","summary":"Facebook Page: Unlike (Comments)","tags":["Focus · Facebook Page"],"description":"Unlike. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/comments/{itemId}/replies":{"post":{"operationId":"facebookCommentsReplies","summary":"Facebook Page: Replies (Comments)","tags":["Focus · Facebook Page"],"description":"Replies. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-replies","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/comments/{itemId}/private-reply":{"post":{"operationId":"facebookCommentsPrivateReply","summary":"Facebook Page: Reply privately (Messenger) (Comments)","tags":["Focus · Facebook Page"],"description":"One message within 7 days of the comment. Comments on a post, photo, video, Reel or live video (object_id), or replies to a comment. Reply, edit, hide, delete, like, private reply. Requires scopes: pages_read_engagement, pages_read_user_content, pages_messaging. Network docs: https://developers.facebook.com/docs/graph-api/reference/object/comments/ Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":2000},"quickReplies":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"payload":{"type":"string"}}},"maxItems":13},"buttons":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["url","postback","phone"]},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"payload":{"type":"string"},"phone":{"type":"string"}}},"maxItems":3}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-comments-private-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/mentions":{"get":{"operationId":"facebookMentionsList","summary":"Facebook Page: List Mentions","tags":["Focus · Facebook Page"],"description":"Posts that tag the Page. Real-time mentions in comments arrive via the `mention` webhook. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_user_content. Generic route: `/v1/accounts/{accountId}/focus/mentions`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-mentions-list","x-zernio":["GET /v1/inbox/mentions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/mentions/{itemId}/reply":{"post":{"operationId":"facebookMentionsReply","summary":"Facebook Page: Reply (Mentions)","tags":["Focus · Facebook Page"],"description":"Reply. Posts that tag the Page. Real-time mentions in comments arrive via the `mention` webhook. Requires scopes: pages_read_user_content, pages_manage_engagement. Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":8000}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-mentions-reply","x-idempotent":true,"x-zernio":["POST /v1/inbox/mentions/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reviews":{"get":{"operationId":"facebookReviewsList","summary":"Facebook Page: List Recommendations","tags":["Focus · Facebook Page"],"description":"Ratings & recommendations (positive / negative). Reply as the Page or delete the reply. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_user_content. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ratings/ Generic route: `/v1/accounts/{accountId}/focus/reviews`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"integer"},"in":"query","name":"minRating","required":false},{"schema":{"type":"integer"},"in":"query","name":"maxRating","required":false},{"schema":{"type":"boolean"},"in":"query","name":"hasReply","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reviews-list","x-zernio":["GET /v1/inbox/reviews"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"open_graph_story id","readOnly":true},"rating":{"type":["null","integer"],"minimum":1,"maximum":5,"readOnly":true},"recommendation_type":{"type":["null","string"],"enum":["positive","negative",null],"readOnly":true},"text":{"type":"string","readOnly":true},"author":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"reply":{"type":["null","string"],"readOnly":true},"reply_id":{"type":["null","string"],"readOnly":true},"replied_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reviews/{itemId}/reply":{"post":{"operationId":"facebookReviewsReply","summary":"Facebook Page: Reply (Recommendations)","tags":["Focus · Facebook Page"],"description":"Reply. Ratings & recommendations (positive / negative). Reply as the Page or delete the reply. Requires scopes: pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ratings/ Generic route: `/v1/accounts/{accountId}/focus/reviews`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":8000}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reviews-reply","x-idempotent":true,"x-zernio":["POST /v1/inbox/reviews/{reviewId}/reply","DELETE /v1/inbox/reviews/{reviewId}/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reviews/{itemId}/delete-reply":{"post":{"operationId":"facebookReviewsDeleteReply","summary":"Facebook Page: Delete reply (Recommendations)","tags":["Focus · Facebook Page"],"description":"Delete reply. Ratings & recommendations (positive / negative). Reply as the Page or delete the reply. Destructive. Requires scopes: pages_read_user_content, pages_manage_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ratings/ Generic route: `/v1/accounts/{accountId}/focus/reviews`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reviews-delete-reply","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reactions":{"get":{"operationId":"facebookReactionsList","summary":"Facebook Page: List Reactions","tags":["Focus · Facebook Page"],"description":"Reaction breakdown for a post (object_id); `people` lists who reacted. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement. Generic route: `/v1/accounts/{accountId}/focus/reactions`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"object_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reactions-list","x-zernio":["GET /v1/accounts/{accountId}/facebook-post-reactions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["LIKE","LOVE","WOW","HAHA","SAD","ANGRY","CARE"],"readOnly":true},"count":{"type":"integer","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reactions/people":{"post":{"operationId":"facebookReactionsPeople","summary":"Facebook Page: People who reacted (Reactions)","tags":["Focus · Facebook Page"],"description":"People who reacted. Reaction breakdown for a post (object_id); `people` lists who reacted. Requires scopes: pages_read_engagement, pages_read_user_content. Generic route: `/v1/accounts/{accountId}/focus/reactions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"object_id":{"type":"string"},"type":{"type":"string","enum":["LIKE","LOVE","WOW","HAHA","SAD","ANGRY","CARE"]},"cursor":{"type":"string","description":"Opaque cursor from next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25}},"required":["object_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reactions-people","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/blocked-users":{"get":{"operationId":"facebookBlockedUsersList","summary":"Facebook Page: List Blocked people","tags":["Focus · Facebook Page"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/blocked/ Generic route: `/v1/accounts/{accountId}/focus/blocked-users`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-blocked-users-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookBlockedUsersCreate","summary":"Facebook Page: Create a Blocked people item","tags":["Focus · Facebook Page"],"description":"Block people from the Page (Messenger PSIDs, ASIDs or user ids). Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/blocked/ Generic route: `/v1/accounts/{accountId}/focus/blocked-users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"},"minItems":1},"idType":{"type":"string","enum":["psid","asid","user"],"default":"psid"}},"required":["ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-blocked-users-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/blocked-users/{itemId}":{"delete":{"operationId":"facebookBlockedUsersDelete","summary":"Facebook Page: Delete a Blocked people item","tags":["Focus · Facebook Page"],"description":"Unblock. id may be prefixed with psid: / asid: / user: (default user, as returned by the list). Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/blocked/ Generic route: `/v1/accounts/{accountId}/focus/blocked-users`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-blocked-users-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations":{"get":{"operationId":"facebookConversationsList","summary":"Facebook Page: List Conversations","tags":["Focus · Facebook Page"],"description":"Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["inbox","pending","other","page_done","spam","requests"]},"in":"query","name":"folder","required":false},{"schema":{"type":"string"},"in":"query","name":"userId","required":false,"description":"PSID"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-list","x-zernio":["GET /v1/inbox/conversations","GET /v1/inbox/conversations/{conversationId}/messages"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true},"unread_count":{"type":"integer","readOnly":true},"last_message":{"type":"string","readOnly":true},"customer_id":{"type":"string","description":"PSID","readOnly":true},"customer_name":{"type":"string","readOnly":true},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"readOnly":true},"message_count":{"type":["null","integer"],"readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"link":{"type":["null","string"],"format":"uri","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}":{"get":{"operationId":"facebookConversationsGet","summary":"Facebook Page: Get a Conversations item","tags":["Focus · Facebook Page"],"description":"Conversation + latest messages + messaging window. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-get","x-zernio":["GET /v1/inbox/conversations/{conversationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true},"unread_count":{"type":"integer","readOnly":true},"last_message":{"type":"string","readOnly":true},"customer_id":{"type":"string","description":"PSID","readOnly":true},"customer_name":{"type":"string","readOnly":true},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"readOnly":true},"message_count":{"type":["null","integer"],"readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"link":{"type":["null","string"],"format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}/messages":{"post":{"operationId":"facebookConversationsMessages","summary":"Facebook Page: Messages (Conversations)","tags":["Focus · Facebook Page"],"description":"Messages. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-messages","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/messages","POST /v1/inbox/conversations/{conversationId}/typing","POST /v1/inbox/conversations/{conversationId}/read","POST /v1/inbox/conversations/{conversationId}/thread-control","POST /v1/inbox/conversations/{conversationId}/accept","POST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions","DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}/send":{"post":{"operationId":"facebookConversationsSend","summary":"Facebook Page: Send message (Conversations)","tags":["Focus · Facebook Page"],"description":"Send message. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":2000},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":"string","format":"uri"},"attachmentId":{"type":"string"}}},"description":"Multiple images allowed per message"},"quickReplies":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","maxLength":20},"payload":{"type":"string"},"imageUrl":{"type":"string","format":"uri"},"type":{"type":"string","enum":["text","user_email","user_phone_number"]}}},"maxItems":13},"buttons":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["url","postback","phone"]},"title":{"type":"string","maxLength":20},"url":{"type":"string","format":"uri"},"payload":{"type":"string"},"phone":{"type":"string"}}},"maxItems":3,"description":"Sent as a button template (text ≤640 chars)"},"elements":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","maxLength":80},"subtitle":{"type":"string","maxLength":80},"imageUrl":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri"},"buttons":{"type":"array","items":{"type":"object","properties":{}},"maxItems":3}}},"maxItems":10,"description":"Generic template (carousel)"},"imageAspectRatio":{"type":"string","enum":["horizontal","square"]},"template":{"type":"object","properties":{},"description":"Raw template payload (template_type …)"},"replyTo":{"type":"string","description":"mid of the message to reply to"},"messagingType":{"type":"string","enum":["RESPONSE","UPDATE","MESSAGE_TAG"],"default":"RESPONSE"},"tag":{"type":"string","enum":["HUMAN_AGENT"],"description":"Human replies 24 h-7 d after the last user message (Human Agent feature)"},"personaId":{"type":"string"},"notificationType":{"type":"string","enum":["REGULAR","SILENT_PUSH","NO_PUSH"]},"recipientId":{"type":"string","description":"PSID (defaults to the conversation customer)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-send","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}/typing":{"post":{"operationId":"facebookConversationsTyping","summary":"Facebook Page: Typing indicator (Conversations)","tags":["Focus · Facebook Page"],"description":"Typing indicator. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipientId":{"type":"string"},"on":{"type":"boolean","default":true}},"required":["recipientId"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-typing","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}/mark-seen":{"post":{"operationId":"facebookConversationsMarkSeen","summary":"Facebook Page: Mark seen (Conversations)","tags":["Focus · Facebook Page"],"description":"Mark seen. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipientId":{"type":"string"}},"required":["recipientId"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-mark-seen","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}/react":{"post":{"operationId":"facebookConversationsReact","summary":"Facebook Page: React to message (Conversations)","tags":["Focus · Facebook Page"],"description":"React to message. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipientId":{"type":"string"},"messageId":{"type":"string"},"emoji":{"type":"string"}},"required":["recipientId","messageId","emoji"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-react","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}/unreact":{"post":{"operationId":"facebookConversationsUnreact","summary":"Facebook Page: Remove reaction (Conversations)","tags":["Focus · Facebook Page"],"description":"Remove reaction. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipientId":{"type":"string"},"messageId":{"type":"string"}},"required":["recipientId","messageId"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-unreact","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}/accept":{"post":{"operationId":"facebookConversationsAccept","summary":"Facebook Page: Accept request (Conversations)","tags":["Focus · Facebook Page"],"description":"Accept request. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipientId":{"type":"string"},"message":{"type":"string","maxLength":2000}},"required":["recipientId","message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-accept","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}/thread-control":{"post":{"operationId":"facebookConversationsThreadControl","summary":"Facebook Page: Handover (Conversations)","tags":["Focus · Facebook Page"],"description":"pass / take / request / release thread control. Page Inbox app id: 263902037430900. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipientId":{"type":"string"},"action":{"type":"string","enum":["pass","take","request","release"]},"targetAppId":{"type":"string"},"metadata":{"type":"string"}},"required":["recipientId","action"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-thread-control","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}/thread-owner":{"post":{"operationId":"facebookConversationsThreadOwner","summary":"Facebook Page: Thread owner (Conversations)","tags":["Focus · Facebook Page"],"description":"Thread owner. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipientId":{"type":"string"}},"required":["recipientId"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-thread-owner","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/{itemId}/profile":{"post":{"operationId":"facebookConversationsProfile","summary":"Facebook Page: Customer profile (Conversations)","tags":["Focus · Facebook Page"],"description":"Customer profile. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipientId":{"type":"string"}},"required":["recipientId"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-profile","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/conversations/upload-attachment":{"post":{"operationId":"facebookConversationsUploadAttachment","summary":"Facebook Page: Upload reusable attachment (Conversations)","tags":["Focus · Facebook Page"],"description":"Upload reusable attachment. Messenger inbox. Reply within 24 h (HUMAN_AGENT tag up to 7 days), typing, seen, reactions, handover. Requires scopes: pages_messaging, pages_read_engagement. Network docs: https://developers.facebook.com/docs/messenger-platform/conversations Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":"string","format":"uri"}},"required":["url"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-conversations-upload-attachment","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/handover-apps":{"get":{"operationId":"facebookHandoverAppsList","summary":"Facebook Page: List Handover apps","tags":["Focus · Facebook Page"],"description":"Secondary receivers for the handover protocol (Conversation Routing may disable these APIs). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/conversation-routing Generic route: `/v1/accounts/{accountId}/focus/handover-apps`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-handover-apps-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/messenger-greeting":{"get":{"operationId":"facebookMessengerGreetingGet","summary":"Facebook Page: Get Greeting","tags":["Focus · Facebook Page"],"description":"Welcome-screen greeting per locale (≤160 chars; a \"default\" locale is required). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-greeting`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-greeting-get","x-zernio":["GET /v1/accounts/{accountId}/messenger-greeting"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"text":{"type":"string","maxLength":160,"description":"Supports {{user_first_name}}, {{user_last_name}}, {{user_full_name}}"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookMessengerGreetingUpdate","summary":"Facebook Page: Update Greeting","tags":["Focus · Facebook Page"],"description":"Welcome-screen greeting per locale (≤160 chars; a \"default\" locale is required). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-greeting`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"greeting":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"text":{"type":"string","maxLength":160,"description":"Supports {{user_first_name}}, {{user_last_name}}, {{user_full_name}}"}}},"minItems":1}},"required":["greeting"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-greeting-update","x-zernio":["PUT /v1/accounts/{accountId}/messenger-greeting"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"text":{"type":"string","maxLength":160,"description":"Supports {{user_first_name}}, {{user_last_name}}, {{user_full_name}}"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookMessengerGreetingDelete","summary":"Facebook Page: Delete Greeting","tags":["Focus · Facebook Page"],"description":"Welcome-screen greeting per locale (≤160 chars; a \"default\" locale is required). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-greeting`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-greeting-delete","x-zernio":["DELETE /v1/accounts/{accountId}/messenger-greeting"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/messenger-get-started":{"get":{"operationId":"facebookMessengerGetStartedGet","summary":"Facebook Page: Get Get Started button","tags":["Focus · Facebook Page"],"description":"Postback payload sent when a user taps Get Started. Required by the persistent menu. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-get-started`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-get-started-get","x-zernio":["GET /v1/accounts/{accountId}/messenger-get-started"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":["null","object"],"properties":{"payload":{"type":"string"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookMessengerGetStartedUpdate","summary":"Facebook Page: Update Get Started button","tags":["Focus · Facebook Page"],"description":"Postback payload sent when a user taps Get Started. Required by the persistent menu. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-get-started`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"payload":{"type":"string","maxLength":1000}},"required":["payload"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-get-started-update","x-zernio":["PUT /v1/accounts/{accountId}/messenger-get-started"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":["null","object"],"properties":{"payload":{"type":"string"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookMessengerGetStartedDelete","summary":"Facebook Page: Delete Get Started button","tags":["Focus · Facebook Page"],"description":"Postback payload sent when a user taps Get Started. Required by the persistent menu. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-get-started`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-get-started-delete","x-zernio":["DELETE /v1/accounts/{accountId}/messenger-get-started"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/messenger-ice-breakers":{"get":{"operationId":"facebookMessengerIceBreakersGet","summary":"Facebook Page: Get Ice breakers","tags":["Focus · Facebook Page"],"description":"Up to 4 FAQ questions per locale shown when a conversation starts. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-ice-breakers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-ice-breakers-get","x-zernio":["GET /v1/accounts/{accountId}/messenger-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string","maxLength":80},"payload":{"type":"string"}}},"minItems":1,"maxItems":4}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookMessengerIceBreakersUpdate","summary":"Facebook Page: Update Ice breakers","tags":["Focus · Facebook Page"],"description":"Up to 4 FAQ questions per locale shown when a conversation starts. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-ice-breakers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ice_breakers":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string","maxLength":80},"payload":{"type":"string"}}},"minItems":1,"maxItems":4}}},"minItems":1}},"required":["ice_breakers"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-ice-breakers-update","x-zernio":["PUT /v1/accounts/{accountId}/messenger-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string","maxLength":80},"payload":{"type":"string"}}},"minItems":1,"maxItems":4}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookMessengerIceBreakersDelete","summary":"Facebook Page: Delete Ice breakers","tags":["Focus · Facebook Page"],"description":"Up to 4 FAQ questions per locale shown when a conversation starts. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-ice-breakers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-ice-breakers-delete","x-zernio":["DELETE /v1/accounts/{accountId}/messenger-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/messenger-menu":{"get":{"operationId":"facebookMessengerMenuGet","summary":"Facebook Page: Get Persistent menu","tags":["Focus · Facebook Page"],"description":"Always-on menu (≤20 items per locale). Needs a Get Started button first. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-menu`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-menu-get","x-zernio":["GET /v1/accounts/{accountId}/messenger-menu"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"composer_input_disabled":{"type":"boolean","default":false},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["postback","web_url","nested"]},"title":{"type":"string","maxLength":30},"payload":{"type":"string"},"url":{"type":"string","format":"uri"},"webview_height_ratio":{"type":"string","enum":["compact","tall","full"]},"call_to_actions":{"type":"array","items":{"type":"object","properties":{}},"description":"Nested items (legacy)"}}},"minItems":1,"maxItems":20}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookMessengerMenuUpdate","summary":"Facebook Page: Update Persistent menu","tags":["Focus · Facebook Page"],"description":"Always-on menu (≤20 items per locale). Needs a Get Started button first. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-menu`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"persistent_menu":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"composer_input_disabled":{"type":"boolean","default":false},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["postback","web_url","nested"]},"title":{"type":"string","maxLength":30},"payload":{"type":"string"},"url":{"type":"string","format":"uri"},"webview_height_ratio":{"type":"string","enum":["compact","tall","full"]},"call_to_actions":{"type":"array","items":{"type":"object","properties":{}},"description":"Nested items (legacy)"}}},"minItems":1,"maxItems":20}}},"minItems":1}},"required":["persistent_menu"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-menu-update","x-zernio":["PUT /v1/accounts/{accountId}/messenger-menu"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"composer_input_disabled":{"type":"boolean","default":false},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["postback","web_url","nested"]},"title":{"type":"string","maxLength":30},"payload":{"type":"string"},"url":{"type":"string","format":"uri"},"webview_height_ratio":{"type":"string","enum":["compact","tall","full"]},"call_to_actions":{"type":"array","items":{"type":"object","properties":{}},"description":"Nested items (legacy)"}}},"minItems":1,"maxItems":20}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookMessengerMenuDelete","summary":"Facebook Page: Delete Persistent menu","tags":["Focus · Facebook Page"],"description":"Always-on menu (≤20 items per locale). Needs a Get Started button first. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-menu`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-menu-delete","x-zernio":["DELETE /v1/accounts/{accountId}/messenger-menu"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/messenger-domains":{"get":{"operationId":"facebookMessengerDomainsGet","summary":"Facebook Page: Get Whitelisted domains","tags":["Focus · Facebook Page"],"description":"Domains allowed in webviews and URL buttons (https, ≤50). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-domains`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-domains-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"string","format":"uri"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookMessengerDomainsUpdate","summary":"Facebook Page: Update Whitelisted domains","tags":["Focus · Facebook Page"],"description":"Domains allowed in webviews and URL buttons (https, ≤50). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-domains`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"whitelisted_domains":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":50}},"required":["whitelisted_domains"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-domains-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"string","format":"uri"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookMessengerDomainsDelete","summary":"Facebook Page: Delete Whitelisted domains","tags":["Focus · Facebook Page"],"description":"Domains allowed in webviews and URL buttons (https, ≤50). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/reference/messenger-profile-api Generic route: `/v1/accounts/{accountId}/focus/messenger-domains`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-messenger-domains-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/personas":{"get":{"operationId":"facebookPersonasList","summary":"Facebook Page: List Personas","tags":["Focus · Facebook Page"],"description":"Agent name + avatar shown on replies (send with personaId). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/personas Generic route: `/v1/accounts/{accountId}/focus/personas`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-personas-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"profile_picture_url":{"type":"string","format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookPersonasCreate","summary":"Facebook Page: Create a Personas item","tags":["Focus · Facebook Page"],"description":"Agent name + avatar shown on replies (send with personaId). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/personas Generic route: `/v1/accounts/{accountId}/focus/personas`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"profilePictureUrl":{"type":"string","format":"uri"}},"required":["name","profilePictureUrl"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-personas-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"profile_picture_url":{"type":"string","format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/personas/{itemId}":{"get":{"operationId":"facebookPersonasGet","summary":"Facebook Page: Get a Personas item","tags":["Focus · Facebook Page"],"description":"Agent name + avatar shown on replies (send with personaId). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/personas Generic route: `/v1/accounts/{accountId}/focus/personas`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-personas-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"profile_picture_url":{"type":"string","format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookPersonasDelete","summary":"Facebook Page: Delete a Personas item","tags":["Focus · Facebook Page"],"description":"Agent name + avatar shown on replies (send with personaId). Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/personas Generic route: `/v1/accounts/{accountId}/focus/personas`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-personas-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/labels":{"get":{"operationId":"facebookLabelsList","summary":"Facebook Page: List Inbox labels","tags":["Focus · Facebook Page"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: `/v1/accounts/{accountId}/focus/labels`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-labels-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"page_label_name":{"type":"string"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookLabelsCreate","summary":"Facebook Page: Create a Inbox labels item","tags":["Focus · Facebook Page"],"description":"Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: `/v1/accounts/{accountId}/focus/labels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"page_label_name":{"type":"string"}},"required":["page_label_name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-labels-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"page_label_name":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/labels/{itemId}":{"delete":{"operationId":"facebookLabelsDelete","summary":"Facebook Page: Delete a Inbox labels item","tags":["Focus · Facebook Page"],"description":"Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: `/v1/accounts/{accountId}/focus/labels`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-labels-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/labels/{itemId}/assign":{"post":{"operationId":"facebookLabelsAssign","summary":"Facebook Page: Assign to person (Inbox labels)","tags":["Focus · Facebook Page"],"description":"Assign to person. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: `/v1/accounts/{accountId}/focus/labels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"psid":{"type":"string"}},"required":["psid"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-labels-assign","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/labels/{itemId}/unassign":{"post":{"operationId":"facebookLabelsUnassign","summary":"Facebook Page: Remove from person (Inbox labels)","tags":["Focus · Facebook Page"],"description":"Remove from person. Requires scopes: pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/identity/custom-labels Generic route: `/v1/accounts/{accountId}/focus/labels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"psid":{"type":"string"}},"required":["psid"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-labels-unassign","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/message-templates":{"get":{"operationId":"facebookMessageTemplatesList","summary":"Facebook Page: List Utility templates","tags":["Focus · Facebook Page"],"description":"Transactional utility templates for messages outside the 24 h window (no promotions). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_utility_messaging, pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/utility-messages Generic route: `/v1/accounts/{accountId}/focus/message-templates`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-message-templates-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","pattern":"^[a-z0-9_]+$"},"language":{"type":"string","default":"en_US"},"category":{"type":"string","enum":["UTILITY"]},"status":{"type":"string","readOnly":true},"components":{"type":"array","items":{"type":"object","properties":{}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookMessageTemplatesCreate","summary":"Facebook Page: Create a Utility templates item","tags":["Focus · Facebook Page"],"description":"Transactional utility templates for messages outside the 24 h window (no promotions). Requires scopes: pages_utility_messaging, pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/utility-messages Generic route: `/v1/accounts/{accountId}/focus/message-templates`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"language":{"type":"string"},"category":{"type":"string","enum":["UTILITY"]},"components":{"type":"array","items":{"type":"object","properties":{}},"minItems":1}},"required":["name","components"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-message-templates-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","pattern":"^[a-z0-9_]+$"},"language":{"type":"string","default":"en_US"},"category":{"type":"string","enum":["UTILITY"]},"status":{"type":"string","readOnly":true},"components":{"type":"array","items":{"type":"object","properties":{}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/message-templates/{itemId}":{"delete":{"operationId":"facebookMessageTemplatesDelete","summary":"Facebook Page: Delete a Utility templates item","tags":["Focus · Facebook Page"],"description":"Transactional utility templates for messages outside the 24 h window (no promotions). Requires scopes: pages_utility_messaging, pages_messaging. Network docs: https://developers.facebook.com/docs/messenger-platform/send-messages/utility-messages Generic route: `/v1/accounts/{accountId}/focus/message-templates`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-message-templates-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/page-insights":{"get":{"operationId":"facebookPageInsightsList","summary":"Facebook Page: List Overview","tags":["Focus · Facebook Page"],"description":"Daily Page views, viewers, engagement, follows, profile views, video views and actions. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: `/v1/accounts/{accountId}/focus/page-insights`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 30 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-insights-list","x-zernio":["GET /v1/analytics/facebook/page-insights"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","readOnly":true},"impressions":{"type":"number","description":"Views (page_media_view)","readOnly":true},"reach":{"type":"number","description":"Viewers (page_total_media_view_unique)","readOnly":true},"engagements":{"type":"number","readOnly":true},"profile_views":{"type":"number","readOnly":true},"followers":{"type":"number","readOnly":true},"follower_change":{"type":"number","readOnly":true},"views":{"type":"number","description":"Video views","readOnly":true},"watch_time_seconds":{"type":"number","readOnly":true},"clicks":{"type":"number","description":"CTA + contact clicks","readOnly":true},"likes":{"type":"number","description":"Reactions","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/page-insights/raw":{"post":{"operationId":"facebookPageInsightsRaw","summary":"Facebook Page: Raw metrics (Zernio page-insights) (Overview)","tags":["Focus · Facebook Page"],"description":"Raw metrics (Zernio page-insights). Daily Page views, viewers, engagement, follows, profile views, video views and actions. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: `/v1/accounts/{accountId}/focus/page-insights`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","description":"YYYY-MM-DD (default: 30 days ago)"},"until":{"type":"string","format":"date","description":"YYYY-MM-DD (default: today)"},"metrics":{"type":"array","items":{"type":"string"},"description":"Default: page_media_view, page_views_total, page_post_engagements, page_video_views, page_video_view_time, page_follows; also followers_gained, followers_lost, content_monetization_earnings, monetization_approximate_earnings, creator_monetization_qualified_views"},"metricType":{"type":"string","enum":["time_series","total_value"],"default":"time_series"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-insights-raw","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/post-insights":{"get":{"operationId":"facebookPostInsightsList","summary":"Facebook Page: List Post performance","tags":["Focus · Facebook Page"],"description":"Views, viewers, reactions, comments, shares, clicks and video metrics for recent posts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: `/v1/accounts/{accountId}/focus/post-insights`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-post-insights-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message":{"type":"string","readOnly":true},"created_time":{"type":"string","format":"date-time","readOnly":true},"impressions":{"type":"number","readOnly":true},"reach":{"type":"number","readOnly":true},"likes":{"type":"number","readOnly":true},"comments":{"type":"number","readOnly":true},"shares":{"type":"number","readOnly":true},"clicks":{"type":"number","readOnly":true},"views":{"type":"number","readOnly":true},"engagements":{"type":"number","readOnly":true},"engagement_rate":{"type":"number","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/post-insights/{itemId}":{"get":{"operationId":"facebookPostInsightsGet","summary":"Facebook Page: Get a Post performance item","tags":["Focus · Facebook Page"],"description":"Views, viewers, reactions, comments, shares, clicks and video metrics for recent posts. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: `/v1/accounts/{accountId}/focus/post-insights`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-post-insights-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message":{"type":"string","readOnly":true},"created_time":{"type":"string","format":"date-time","readOnly":true},"impressions":{"type":"number","readOnly":true},"reach":{"type":"number","readOnly":true},"likes":{"type":"number","readOnly":true},"comments":{"type":"number","readOnly":true},"shares":{"type":"number","readOnly":true},"clicks":{"type":"number","readOnly":true},"views":{"type":"number","readOnly":true},"engagements":{"type":"number","readOnly":true},"engagement_rate":{"type":"number","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/video-insights":{"get":{"operationId":"facebookVideoInsightsList","summary":"Facebook Page: List Video & Reels","tags":["Focus · Facebook Page"],"description":"Daily Page video metrics; `get` a video / Reel id for lifetime video_insights (retention, avg watch time). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/video/video_insights/ Generic route: `/v1/accounts/{accountId}/focus/video-insights`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 30 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-video-insights-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","readOnly":true},"page_video_views":{"type":"number","readOnly":true},"page_video_views_paid":{"type":"number","readOnly":true},"page_video_views_organic":{"type":"number","readOnly":true},"page_video_views_autoplayed":{"type":"number","readOnly":true},"page_video_views_click_to_play":{"type":"number","readOnly":true},"page_video_repeat_views":{"type":"number","readOnly":true},"page_video_complete_views_30s":{"type":"number","readOnly":true},"page_video_view_time":{"type":"number","description":"ms","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/video-insights/{itemId}":{"get":{"operationId":"facebookVideoInsightsGet","summary":"Facebook Page: Get a Video & Reels item","tags":["Focus · Facebook Page"],"description":"Daily Page video metrics; `get` a video / Reel id for lifetime video_insights (retention, avg watch time). Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/video/video_insights/ Generic route: `/v1/accounts/{accountId}/focus/video-insights`.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"reel","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-video-insights-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","format":"date","readOnly":true},"page_video_views":{"type":"number","readOnly":true},"page_video_views_paid":{"type":"number","readOnly":true},"page_video_views_organic":{"type":"number","readOnly":true},"page_video_views_autoplayed":{"type":"number","readOnly":true},"page_video_views_click_to_play":{"type":"number","readOnly":true},"page_video_repeat_views":{"type":"number","readOnly":true},"page_video_complete_views_30s":{"type":"number","readOnly":true},"page_video_view_time":{"type":"number","description":"ms","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/reaction-insights":{"get":{"operationId":"facebookReactionInsightsList","summary":"Facebook Page: List Reactions by type","tags":["Focus · Facebook Page"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: `/v1/accounts/{accountId}/focus/reaction-insights`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 30 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-reaction-insights-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","readOnly":true},"LIKE":{"type":"number","readOnly":true},"LOVE":{"type":"number","readOnly":true},"WOW":{"type":"number","readOnly":true},"HAHA":{"type":"number","readOnly":true},"SAD":{"type":"number","readOnly":true},"ANGRY":{"type":"number","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/demographics":{"get":{"operationId":"facebookDemographicsList","summary":"Facebook Page: List Audience","tags":["Focus · Facebook Page"],"description":"Followers by country and city (Meta removed age/gender in Nov 2025). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: `/v1/accounts/{accountId}/focus/demographics`.","parameters":[{"schema":{"type":"string","default":"country,city"},"in":"query","name":"breakdown","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-demographics-list","x-zernio":["GET /v1/analytics/facebook/demographics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string","enum":["country","city"],"readOnly":true},"key":{"type":"string","readOnly":true},"value":{"type":"number","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/monetization":{"get":{"operationId":"facebookMonetizationList","summary":"Facebook Page: List Monetization","tags":["Focus · Facebook Page"],"description":"Content monetization earnings (monetized Pages only). `get` a post/video id for lifetime post earnings. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: `/v1/accounts/{accountId}/focus/monetization`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 30 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-monetization-list","x-zernio":["GET /v1/analytics/facebook/post-earnings"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","readOnly":true},"content_monetization_earnings":{"type":"number","readOnly":true},"monetization_approximate_earnings":{"type":"number","readOnly":true},"creator_monetization_qualified_views":{"type":"number","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/monetization/{itemId}":{"get":{"operationId":"facebookMonetizationGet","summary":"Facebook Page: Get a Monetization item","tags":["Focus · Facebook Page"],"description":"Content monetization earnings (monetized Pages only). `get` a post/video id for lifetime post earnings. Requires scopes: read_insights, pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/insights Generic route: `/v1/accounts/{accountId}/focus/monetization`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"metrics","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-monetization-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","format":"date","readOnly":true},"content_monetization_earnings":{"type":"number","readOnly":true},"monetization_approximate_earnings":{"type":"number","readOnly":true},"creator_monetization_qualified_views":{"type":"number","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/page-profile":{"get":{"operationId":"facebookPageProfileGet","summary":"Facebook Page: Get Page info","tags":["Focus · Facebook Page"],"description":"About, description, contact details, hours, categories, cover and profile picture. Name/username changes are not available via the API. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ Generic route: `/v1/accounts/{accountId}/focus/page-profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"username":{"type":["null","string"],"readOnly":true},"about":{"type":"string","maxLength":255},"description":{"type":"string"},"category":{"type":"string","readOnly":true},"category_list":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"maxItems":3,"description":"Up to 3 category ids"},"phone":{"type":"string"},"emails":{"type":"array","items":{"type":"string","format":"email"}},"website":{"type":"string","format":"uri"},"hours":{"type":"object","properties":{},"additionalProperties":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"description":"Keys like mon_1_open / mon_1_close … sun_2_close, values HH:MM"},"is_always_open":{"type":"boolean"},"temporary_status":{"type":"string","enum":["differently_open","temporarily_closed","operating_as_usual","no_data"]},"location":{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"},"country":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"}}},"single_line_address":{"type":"string","readOnly":true},"price_range":{"type":"string","enum":["$","$$","$$$","$$$$","Unspecified"]},"picture_url":{"type":"string","format":"uri","readOnly":true},"cover_url":{"type":"string","format":"uri","readOnly":true},"followers_count":{"type":"integer","readOnly":true},"fan_count":{"type":"integer","readOnly":true},"link":{"type":"string","format":"uri","readOnly":true},"verification_status":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"facebookPageProfileUpdate","summary":"Facebook Page: Update Page info","tags":["Focus · Facebook Page"],"description":"About, description, contact details, hours, categories, cover and profile picture. Name/username changes are not available via the API. Requires scopes: pages_read_engagement, pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ Generic route: `/v1/accounts/{accountId}/focus/page-profile`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"about":{"type":"string","maxLength":255},"description":{"type":"string"},"phone":{"type":"string"},"emails":{"type":"array","items":{"type":"string","format":"email"}},"website":{"type":"string","format":"uri"},"hours":{"type":"object","properties":{},"additionalProperties":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"description":"Keys like mon_1_open / mon_1_close … sun_2_close, values HH:MM"},"isAlwaysOpen":{"type":"boolean"},"temporaryStatus":{"type":"string","enum":["differently_open","temporarily_closed","operating_as_usual","no_data"]},"location":{"type":"object","properties":{}},"priceRange":{"type":"string"},"categoryList":{"type":"array","items":{"type":"string"},"maxItems":3},"impressum":{"type":"string"},"mission":{"type":"string"},"companyOverview":{"type":"string"},"generalInfo":{"type":"string"},"isPermanentlyClosed":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-profile-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"username":{"type":["null","string"],"readOnly":true},"about":{"type":"string","maxLength":255},"description":{"type":"string"},"category":{"type":"string","readOnly":true},"category_list":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"maxItems":3,"description":"Up to 3 category ids"},"phone":{"type":"string"},"emails":{"type":"array","items":{"type":"string","format":"email"}},"website":{"type":"string","format":"uri"},"hours":{"type":"object","properties":{},"additionalProperties":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"description":"Keys like mon_1_open / mon_1_close … sun_2_close, values HH:MM"},"is_always_open":{"type":"boolean"},"temporary_status":{"type":"string","enum":["differently_open","temporarily_closed","operating_as_usual","no_data"]},"location":{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"},"country":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"}}},"single_line_address":{"type":"string","readOnly":true},"price_range":{"type":"string","enum":["$","$$","$$$","$$$$","Unspecified"]},"picture_url":{"type":"string","format":"uri","readOnly":true},"cover_url":{"type":"string","format":"uri","readOnly":true},"followers_count":{"type":"integer","readOnly":true},"fan_count":{"type":"integer","readOnly":true},"link":{"type":"string","format":"uri","readOnly":true},"verification_status":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/page-profile/set-cover":{"post":{"operationId":"facebookPageProfileSetCover","summary":"Facebook Page: Change cover photo (Page info)","tags":["Focus · Facebook Page"],"description":"Change cover photo. About, description, contact details, hours, categories, cover and profile picture. Name/username changes are not available via the API. Requires scopes: pages_read_engagement, pages_manage_metadata, business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ Generic route: `/v1/accounts/{accountId}/focus/page-profile`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mediaId":{"type":"string"},"url":{"type":"string","format":"uri"},"photoId":{"type":"string"},"offsetY":{"type":"integer","minimum":0,"maximum":100}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-profile-set-cover","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/page-profile/set-picture":{"post":{"operationId":"facebookPageProfileSetPicture","summary":"Facebook Page: Change profile picture (Page info)","tags":["Focus · Facebook Page"],"description":"Change profile picture. About, description, contact details, hours, categories, cover and profile picture. Name/username changes are not available via the API. Requires scopes: pages_read_engagement, pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/ Generic route: `/v1/accounts/{accountId}/focus/page-profile`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mediaId":{"type":"string"},"url":{"type":"string","format":"uri"},"photoId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-profile-set-picture","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/page-settings":{"get":{"operationId":"facebookPageSettingsList","summary":"Facebook Page: List Settings","tags":["Focus · Facebook Page"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/settings/ Generic route: `/v1/accounts/{accountId}/focus/page-settings`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-settings-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"setting":{"type":"string","readOnly":true},"value":{"type":"string"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/page-settings/{itemId}":{"patch":{"operationId":"facebookPageSettingsUpdate","summary":"Facebook Page: Update a Settings item","tags":["Focus · Facebook Page"],"description":"Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/settings/ Generic route: `/v1/accounts/{accountId}/focus/page-settings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}},"required":["value"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-settings-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"setting":{"type":"string","readOnly":true},"value":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/call-to-action":{"get":{"operationId":"facebookCallToActionList","summary":"Facebook Page: List Action button","tags":["Focus · Facebook Page"],"description":"Page CTA button. Reading needs Page Public Content Access; Meta marks updates deprecated (verify in a test app). Creating is not supported. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement. Network docs: https://developers.facebook.com/docs/graph-api/reference/page-call-to-action/ Generic route: `/v1/accounts/{accountId}/focus/call-to-action`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-call-to-action-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["BOOK_NOW","CALL_NOW","CONTACT_US","MESSAGE","SHOP_NOW","SIGN_UP","LEARN_MORE","ORDER_FOOD","VIEW_MENU","EMAIL","GET_DIRECTIONS","WATCH_VIDEO","PLAY_NOW","USE_APP","DONATE","GET_QUOTE","APPLY_NOW","SEND_MESSAGE"]},"status":{"type":"string","readOnly":true},"web_url":{"type":"string","format":"uri"},"email_address":{"type":"string","format":"email"},"intl_number_with_plus":{"type":"string"},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/call-to-action/{itemId}":{"patch":{"operationId":"facebookCallToActionUpdate","summary":"Facebook Page: Update a Action button item","tags":["Focus · Facebook Page"],"description":"Page CTA button. Reading needs Page Public Content Access; Meta marks updates deprecated (verify in a test app). Creating is not supported. Requires scopes: pages_read_engagement, pages_manage_cta. Network docs: https://developers.facebook.com/docs/graph-api/reference/page-call-to-action/ Generic route: `/v1/accounts/{accountId}/focus/call-to-action`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["BOOK_NOW","CALL_NOW","CONTACT_US","MESSAGE","SHOP_NOW","SIGN_UP","LEARN_MORE","ORDER_FOOD","VIEW_MENU","EMAIL","GET_DIRECTIONS","WATCH_VIDEO","PLAY_NOW","USE_APP","DONATE","GET_QUOTE","APPLY_NOW","SEND_MESSAGE"]},"webUrl":{"type":"string","format":"uri"},"emailAddress":{"type":"string"},"phone":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-call-to-action-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["BOOK_NOW","CALL_NOW","CONTACT_US","MESSAGE","SHOP_NOW","SIGN_UP","LEARN_MORE","ORDER_FOOD","VIEW_MENU","EMAIL","GET_DIRECTIONS","WATCH_VIDEO","PLAY_NOW","USE_APP","DONATE","GET_QUOTE","APPLY_NOW","SEND_MESSAGE"]},"status":{"type":"string","readOnly":true},"web_url":{"type":"string","format":"uri"},"email_address":{"type":"string","format":"email"},"intl_number_with_plus":{"type":"string"},"created_time":{"type":"string","format":"date-time","readOnly":true},"updated_time":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookCallToActionDelete","summary":"Facebook Page: Delete a Action button item","tags":["Focus · Facebook Page"],"description":"Page CTA button. Reading needs Page Public Content Access; Meta marks updates deprecated (verify in a test app). Creating is not supported. Requires scopes: pages_read_engagement, pages_manage_cta. Network docs: https://developers.facebook.com/docs/graph-api/reference/page-call-to-action/ Generic route: `/v1/accounts/{accountId}/focus/call-to-action`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-call-to-action-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/webhook-subscription":{"get":{"operationId":"facebookWebhookSubscriptionGet","summary":"Facebook Page: Get Real-time updates","tags":["Focus · Facebook Page"],"description":"Whether Socialit receives this Page’s webhooks (feed, mentions, ratings, Messenger). Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/webhooks/reference/page Generic route: `/v1/accounts/{accountId}/focus/webhook-subscription`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-webhook-subscription-get","x-zernio":["GET /v1/accounts/{accountId}/webhook-subscription"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"pageId":{"type":"string","readOnly":true},"appSubscribed":{"type":"boolean","readOnly":true},"subscribedFields":{"type":"array","items":{"type":"string"},"readOnly":true},"missingFields":{"type":"array","items":{"type":"string"},"readOnly":true},"warning":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/webhook-subscription/subscribe":{"post":{"operationId":"facebookWebhookSubscriptionSubscribe","summary":"Facebook Page: Re-subscribe (Real-time updates)","tags":["Focus · Facebook Page"],"description":"Re-subscribe. Whether Socialit receives this Page’s webhooks (feed, mentions, ratings, Messenger). Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/webhooks/reference/page Generic route: `/v1/accounts/{accountId}/focus/webhook-subscription`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scopeSet":{"type":"string","enum":["core","focus"],"default":"core"},"fields":{"type":"array","items":{"type":"string","enum":["feed","mention","ratings","messages","message_echoes","message_edits","message_reactions","message_reads","message_deliveries","messaging_postbacks","messaging_referrals","messaging_optins","live_videos","videos","messaging_handovers","standby","messaging_policy_enforcement","message_template_status_update","inbox_labels","business_integrity","calls","call_permission_reply","call_settings_update","group_feed","page_change_proposal","page_upcoming_change","name","picture","category","description","website","phone","email","hours","location"]}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-webhook-subscription-subscribe","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/webhook-subscription"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/webhook-subscription/unsubscribe":{"post":{"operationId":"facebookWebhookSubscriptionUnsubscribe","summary":"Facebook Page: Unsubscribe (Real-time updates)","tags":["Focus · Facebook Page"],"description":"Unsubscribe. Whether Socialit receives this Page’s webhooks (feed, mentions, ratings, Messenger). Destructive. Requires scopes: pages_manage_metadata. Network docs: https://developers.facebook.com/docs/graph-api/webhooks/reference/page Generic route: `/v1/accounts/{accountId}/focus/webhook-subscription`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_facebook","x-mcp-tool":"facebook-webhook-subscription-unsubscribe","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/locations":{"get":{"operationId":"facebookLocationsList","summary":"Facebook Page: List Locations","tags":["Focus · Facebook Page"],"description":"Child location Pages of a multi-location brand. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_read_engagement, business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/locations/ Generic route: `/v1/accounts/{accountId}/focus/locations`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-locations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"location":{"type":"object","properties":{},"readOnly":true},"link":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/pages":{"get":{"operationId":"facebookPagesList","summary":"Facebook Page: List Pages","tags":["Focus · Facebook Page"],"description":"Pages available to the connecting user; switch this account to another Page. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pages_show_list. Network docs: https://developers.facebook.com/docs/graph-api/reference/user/accounts/ Generic route: `/v1/accounts/{accountId}/focus/pages`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-pages-list","x-zernio":["GET /v1/accounts/{accountId}/facebook-page","GET /v1/connect/facebook/select-page"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"username":{"type":["null","string"],"readOnly":true},"category":{"type":"string","readOnly":true},"picture":{"type":"string","format":"uri","readOnly":true},"tasks":{"type":"array","items":{"type":"string","enum":["MANAGE","CREATE_CONTENT","MODERATE","MESSAGING","ADVERTISE","ANALYZE","MODERATE_COMMUNITY","MANAGE_JOBS","PAGES_MESSAGING","PAGES_MESSAGING_SUBSCRIPTIONS","READ_PAGE_MAILBOXES","VIEW_MONETIZATION_INSIGHTS"]},"readOnly":true},"can_publish":{"type":"boolean","readOnly":true},"can_message":{"type":"boolean","readOnly":true},"can_analyze":{"type":"boolean","readOnly":true},"selected":{"type":"boolean","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/pages/{itemId}/select":{"post":{"operationId":"facebookPagesSelect","summary":"Facebook Page: Use this Page (Pages)","tags":["Focus · Facebook Page"],"description":"Returns the new Page target (externalId + Page token) for the API layer to persist. Pages available to the connecting user; switch this account to another Page. Requires scopes: pages_show_list. Network docs: https://developers.facebook.com/docs/graph-api/reference/user/accounts/ Generic route: `/v1/accounts/{accountId}/focus/pages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_facebook","x-mcp-tool":"facebook-pages-select","x-idempotent":true,"x-zernio":["PUT /v1/accounts/{accountId}/facebook-page","POST /v1/connect/facebook/select-page"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/business-partners":{"get":{"operationId":"facebookBusinessPartnersList","summary":"Facebook Page: List Partners","tags":["Focus · Facebook Page"],"description":"Business portfolios (agencies) this Page is shared with. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/agencies/ Generic route: `/v1/accounts/{accountId}/focus/business-partners`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-business-partners-list","x-zernio":["GET /v1/accounts/{accountId}/business-partners"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"permittedTasks":{"type":["null","array"],"items":{"type":"string"},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookBusinessPartnersCreate","summary":"Facebook Page: Create a Partners item","tags":["Focus · Facebook Page"],"description":"Business portfolios (agencies) this Page is shared with. Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/agencies/ Generic route: `/v1/accounts/{accountId}/focus/business-partners`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"businessId":{"type":"string","pattern":"^\\d+$"},"permittedTasks":{"type":"array","items":{"type":"string","enum":["MANAGE","CREATE_CONTENT","MODERATE","MESSAGING","ADVERTISE","ANALYZE","MODERATE_COMMUNITY","MANAGE_JOBS","PAGES_MESSAGING","PAGES_MESSAGING_SUBSCRIPTIONS","READ_PAGE_MAILBOXES","VIEW_MONETIZATION_INSIGHTS"]},"default":["ADVERTISE","ANALYZE"]}},"required":["businessId"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-business-partners-create","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/business-partners"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"permittedTasks":{"type":["null","array"],"items":{"type":"string"},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/business-partners/{itemId}":{"delete":{"operationId":"facebookBusinessPartnersDelete","summary":"Facebook Page: Delete a Partners item","tags":["Focus · Facebook Page"],"description":"Business portfolios (agencies) this Page is shared with. Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/agencies/ Generic route: `/v1/accounts/{accountId}/focus/business-partners`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-business-partners-delete","x-zernio":["DELETE /v1/accounts/{accountId}/business-partners"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/page-roles":{"get":{"operationId":"facebookPageRolesList","summary":"Facebook Page: List People & tasks","tags":["Focus · Facebook Page"],"description":"Business users with tasks on the Page (business-portfolio Pages). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/assigned_users/ Generic route: `/v1/accounts/{accountId}/focus/page-roles`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"businessId","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-roles-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"tasks":{"type":"array","items":{"type":"string","enum":["MANAGE","CREATE_CONTENT","MODERATE","MESSAGING","ADVERTISE","ANALYZE","MODERATE_COMMUNITY","MANAGE_JOBS","PAGES_MESSAGING","PAGES_MESSAGING_SUBSCRIPTIONS","READ_PAGE_MAILBOXES","VIEW_MONETIZATION_INSIGHTS"]}},"user_type":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"facebookPageRolesCreate","summary":"Facebook Page: Create a People & tasks item","tags":["Focus · Facebook Page"],"description":"Business users with tasks on the Page (business-portfolio Pages). Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/assigned_users/ Generic route: `/v1/accounts/{accountId}/focus/page-roles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"tasks":{"type":"array","items":{"type":"string","enum":["MANAGE","CREATE_CONTENT","MODERATE","MESSAGING","ADVERTISE","ANALYZE","MODERATE_COMMUNITY","MANAGE_JOBS","PAGES_MESSAGING","PAGES_MESSAGING_SUBSCRIPTIONS","READ_PAGE_MAILBOXES","VIEW_MONETIZATION_INSIGHTS"]},"minItems":1},"businessId":{"type":"string"}},"required":["userId","tasks"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-roles-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"tasks":{"type":"array","items":{"type":"string","enum":["MANAGE","CREATE_CONTENT","MODERATE","MESSAGING","ADVERTISE","ANALYZE","MODERATE_COMMUNITY","MANAGE_JOBS","PAGES_MESSAGING","PAGES_MESSAGING_SUBSCRIPTIONS","READ_PAGE_MAILBOXES","VIEW_MONETIZATION_INSIGHTS"]}},"user_type":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/facebook/page-roles/{itemId}":{"patch":{"operationId":"facebookPageRolesUpdate","summary":"Facebook Page: Update a People & tasks item","tags":["Focus · Facebook Page"],"description":"Business users with tasks on the Page (business-portfolio Pages). Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/assigned_users/ Generic route: `/v1/accounts/{accountId}/focus/page-roles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tasks":{"type":"array","items":{"type":"string","enum":["MANAGE","CREATE_CONTENT","MODERATE","MESSAGING","ADVERTISE","ANALYZE","MODERATE_COMMUNITY","MANAGE_JOBS","PAGES_MESSAGING","PAGES_MESSAGING_SUBSCRIPTIONS","READ_PAGE_MAILBOXES","VIEW_MONETIZATION_INSIGHTS"]},"minItems":1},"businessId":{"type":"string"}},"required":["tasks"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-roles-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"tasks":{"type":"array","items":{"type":"string","enum":["MANAGE","CREATE_CONTENT","MODERATE","MESSAGING","ADVERTISE","ANALYZE","MODERATE_COMMUNITY","MANAGE_JOBS","PAGES_MESSAGING","PAGES_MESSAGING_SUBSCRIPTIONS","READ_PAGE_MAILBOXES","VIEW_MONETIZATION_INSIGHTS"]}},"user_type":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"facebookPageRolesDelete","summary":"Facebook Page: Delete a People & tasks item","tags":["Focus · Facebook Page"],"description":"Business users with tasks on the Page (business-portfolio Pages). Requires scopes: business_management. Network docs: https://developers.facebook.com/docs/graph-api/reference/page/assigned_users/ Generic route: `/v1/accounts/{accountId}/focus/page-roles`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_facebook","x-mcp-tool":"facebook-page-roles-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/locations":{"get":{"operationId":"googleBusinessLocationsList","summary":"Google Business Profile: List Locations","tags":["Focus · Google Business Profile"],"description":"List locations across accounts. Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: `/v1/accounts/{accountId}/focus/locations`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"search","required":false,"description":"Business-name substring"},{"schema":{"type":"string"},"in":"query","name":"filter","required":false,"description":"Raw Google filter, e.g. storeCode=\"12\" (takes precedence)"},{"schema":{"type":"string"},"in":"query","name":"googleAccountId","required":false},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-locations-list","x-zernio":["GET /v1/accounts/{accountId}/gmb-locations","GET /v1/connect/googlebusiness/locations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"locationId":{"type":"string","readOnly":true},"externalId":{"type":"string","readOnly":true},"title":{"type":"string"},"accountId":{"type":"string","readOnly":true},"accountName":{"type":"string","readOnly":true},"accountType":{"type":"string","enum":["PERSONAL","LOCATION_GROUP","USER_GROUP","ORGANIZATION"],"readOnly":true},"address":{"type":"string","readOnly":true},"category":{"type":"string","readOnly":true},"storeCode":{"type":"string"},"phone":{"type":"string","readOnly":true},"websiteUri":{"type":"string","format":"uri","readOnly":true},"openStatus":{"type":"string","enum":["OPEN","CLOSED_TEMPORARILY","CLOSED_PERMANENTLY"],"readOnly":true},"isVerified":{"type":"boolean","readOnly":true},"hasPendingEdits":{"type":"boolean","readOnly":true},"hasGoogleUpdated":{"type":"boolean","readOnly":true},"placeId":{"type":"string","readOnly":true},"mapsUri":{"type":"string","format":"uri","readOnly":true},"reviewUrl":{"type":"string","format":"uri","readOnly":true},"selected":{"type":"boolean","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"googleBusinessLocationsCreate","summary":"Google Business Profile: Create a Locations item","tags":["Focus · Google Business Profile"],"description":"Create a location (300/day; needs verification afterwards). Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: `/v1/accounts/{accountId}/focus/locations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"googleAccountId":{"type":"string"},"requestId":{"type":"string"},"validateOnly":{"type":"boolean"},"location":{"type":"object","properties":{"title":{"type":"string","description":"Business name as on the storefront","maxLength":100},"storeCode":{"type":"string","maxLength":64},"languageCode":{"type":"string"},"categories":{"type":"object","properties":{"primaryCategory":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"additionalCategories":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"maxItems":9}}},"phoneNumbers":{"type":"object","properties":{"primaryPhone":{"type":"string"},"additionalPhones":{"type":"array","items":{"type":"string"},"maxItems":2}}},"websiteUri":{"type":"string","format":"uri"},"storefrontAddress":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}},"description":"Changing the address can trigger re-verification"},"latlng":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"openInfo":{"type":"object","properties":{"status":{"type":"string","enum":["OPEN","CLOSED_TEMPORARILY","CLOSED_PERMANENTLY"]},"canReopen":{"type":"boolean","readOnly":true},"openingDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"}}},"profile":{"type":"object","properties":{"description":{"type":"string","maxLength":750}}},"labels":{"type":"array","items":{"type":"string","maxLength":50},"maxItems":10},"adWordsLocationExtensions":{"type":"object","properties":{"adPhone":{"type":"string"}}}}}},"required":["location"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_google_business","x-mcp-tool":"google-business-locations-create","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-locations/assign"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"locationId":{"type":"string","readOnly":true},"externalId":{"type":"string","readOnly":true},"title":{"type":"string"},"accountId":{"type":"string","readOnly":true},"accountName":{"type":"string","readOnly":true},"accountType":{"type":"string","enum":["PERSONAL","LOCATION_GROUP","USER_GROUP","ORGANIZATION"],"readOnly":true},"address":{"type":"string","readOnly":true},"category":{"type":"string","readOnly":true},"storeCode":{"type":"string"},"phone":{"type":"string","readOnly":true},"websiteUri":{"type":"string","format":"uri","readOnly":true},"openStatus":{"type":"string","enum":["OPEN","CLOSED_TEMPORARILY","CLOSED_PERMANENTLY"],"readOnly":true},"isVerified":{"type":"boolean","readOnly":true},"hasPendingEdits":{"type":"boolean","readOnly":true},"hasGoogleUpdated":{"type":"boolean","readOnly":true},"placeId":{"type":"string","readOnly":true},"mapsUri":{"type":"string","format":"uri","readOnly":true},"reviewUrl":{"type":"string","format":"uri","readOnly":true},"selected":{"type":"boolean","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/locations/{itemId}":{"get":{"operationId":"googleBusinessLocationsGet","summary":"Google Business Profile: Get a Locations item","tags":["Focus · Google Business Profile"],"description":"Location details. Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: `/v1/accounts/{accountId}/focus/locations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-locations-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"locationId":{"type":"string","readOnly":true},"externalId":{"type":"string","readOnly":true},"title":{"type":"string"},"accountId":{"type":"string","readOnly":true},"accountName":{"type":"string","readOnly":true},"accountType":{"type":"string","enum":["PERSONAL","LOCATION_GROUP","USER_GROUP","ORGANIZATION"],"readOnly":true},"address":{"type":"string","readOnly":true},"category":{"type":"string","readOnly":true},"storeCode":{"type":"string"},"phone":{"type":"string","readOnly":true},"websiteUri":{"type":"string","format":"uri","readOnly":true},"openStatus":{"type":"string","enum":["OPEN","CLOSED_TEMPORARILY","CLOSED_PERMANENTLY"],"readOnly":true},"isVerified":{"type":"boolean","readOnly":true},"hasPendingEdits":{"type":"boolean","readOnly":true},"hasGoogleUpdated":{"type":"boolean","readOnly":true},"placeId":{"type":"string","readOnly":true},"mapsUri":{"type":"string","format":"uri","readOnly":true},"reviewUrl":{"type":"string","format":"uri","readOnly":true},"selected":{"type":"boolean","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"googleBusinessLocationsDelete","summary":"Google Business Profile: Delete a Locations item","tags":["Focus · Google Business Profile"],"description":"Delete a location from Business Profile. Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: `/v1/accounts/{accountId}/focus/locations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_google_business","x-mcp-tool":"google-business-locations-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/locations/{itemId}/select":{"post":{"operationId":"googleBusinessLocationsSelect","summary":"Google Business Profile: Make default location (Locations)","tags":["Focus · Google Business Profile"],"description":"Switch this connection to another location (Zernio PUT gmb-locations). Returns the account patch to persist. Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: `/v1/accounts/{accountId}/focus/locations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"googleAccountId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-locations-select","x-idempotent":true,"x-zernio":["PUT /v1/accounts/{accountId}/gmb-locations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/locations/{itemId}/assign":{"post":{"operationId":"googleBusinessLocationsAssign","summary":"Google Business Profile: Assign to another profile (Locations)","tags":["Focus · Google Business Profile"],"description":"Clone the grant into a new account on another Socialit profile (Zernio POST gmb-locations/assign). Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: `/v1/accounts/{accountId}/focus/locations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profileId":{"type":"string"},"googleAccountId":{"type":"string"}},"required":["profileId"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-locations-assign","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/locations/{itemId}/transfer":{"post":{"operationId":"googleBusinessLocationsTransfer","summary":"Google Business Profile: Transfer to another account (Locations)","tags":["Focus · Google Business Profile"],"description":"Move the location to another Business Profile account you manage. Notify the client within 48 h. Every location this Google login owns or manages (multi-location accounts and location groups). Select the default location, assign one to another profile, or transfer it. Destructive. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list Generic route: `/v1/accounts/{accountId}/focus/locations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"destinationAccount":{"type":"string","description":"accounts/{id}"}},"required":["destinationAccount"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_google_business","x-mcp-tool":"google-business-locations-transfer","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/business-info":{"get":{"operationId":"googleBusinessBusinessInfoGet","summary":"Google Business Profile: Get Business information","tags":["Focus · Google Business Profile"],"description":"Name, categories, phone, website, address, opening date/status, description, labels. Edits are moderated by Google; changing the name, address or primary category may trigger re-verification. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: `/v1/accounts/{accountId}/focus/business-info`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false,"description":"Another location this connection manages (\"locations/{id}\" or \"accounts/{a}/locations/{l}\")"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-business-info-get","x-zernio":["GET /v1/accounts/{accountId}/gmb-location-details"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"title":{"type":"string","description":"Business name as on the storefront","maxLength":100},"storeCode":{"type":"string","maxLength":64},"languageCode":{"type":"string"},"categories":{"type":"object","properties":{"primaryCategory":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"additionalCategories":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"maxItems":9}}},"phoneNumbers":{"type":"object","properties":{"primaryPhone":{"type":"string"},"additionalPhones":{"type":"array","items":{"type":"string"},"maxItems":2}}},"websiteUri":{"type":"string","format":"uri"},"storefrontAddress":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}},"description":"Changing the address can trigger re-verification"},"latlng":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"openInfo":{"type":"object","properties":{"status":{"type":"string","enum":["OPEN","CLOSED_TEMPORARILY","CLOSED_PERMANENTLY"]},"canReopen":{"type":"boolean","readOnly":true},"openingDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"}}},"profile":{"type":"object","properties":{"description":{"type":"string","maxLength":750}}},"labels":{"type":"array","items":{"type":"string","maxLength":50},"maxItems":10},"adWordsLocationExtensions":{"type":"object","properties":{"adPhone":{"type":"string"}}},"metadata":{"type":"object","properties":{"placeId":{"type":"string"},"mapsUri":{"type":"string","format":"uri"},"newReviewUri":{"type":"string","format":"uri"},"hasVoiceOfMerchant":{"type":"boolean"},"hasPendingEdits":{"type":"boolean"},"hasGoogleUpdated":{"type":"boolean"},"canHaveFoodMenus":{"type":"boolean"},"canOperateLodgingData":{"type":"boolean"},"canOperateLocalPost":{"type":"boolean"},"canModifyServiceList":{"type":"boolean"},"canDelete":{"type":"boolean"},"duplicateLocation":{"type":"string"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"googleBusinessBusinessInfoUpdate","summary":"Google Business Profile: Update Business information","tags":["Focus · Google Business Profile"],"description":"PATCH with updateMask (inferred from the fields sent). validateOnly checks without saving. Name, categories, phone, website, address, opening date/status, description, labels. Edits are moderated by Google; changing the name, address or primary category may trigger re-verification. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: `/v1/accounts/{accountId}/focus/business-info`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"Business name as on the storefront","maxLength":100},"storeCode":{"type":"string","maxLength":64},"languageCode":{"type":"string"},"categories":{"type":"object","properties":{"primaryCategory":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"additionalCategories":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"maxItems":9}}},"phoneNumbers":{"type":"object","properties":{"primaryPhone":{"type":"string"},"additionalPhones":{"type":"array","items":{"type":"string"},"maxItems":2}}},"websiteUri":{"type":"string","format":"uri"},"storefrontAddress":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}},"description":"Changing the address can trigger re-verification"},"latlng":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"openInfo":{"type":"object","properties":{"status":{"type":"string","enum":["OPEN","CLOSED_TEMPORARILY","CLOSED_PERMANENTLY"]},"canReopen":{"type":"boolean","readOnly":true},"openingDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"}}},"profile":{"type":"object","properties":{"description":{"type":"string","maxLength":750}}},"labels":{"type":"array","items":{"type":"string","maxLength":50},"maxItems":10},"adWordsLocationExtensions":{"type":"object","properties":{"adPhone":{"type":"string"}}},"updateMask":{"type":"string","description":"Comma-separated, e.g. profile.description,websiteUri"},"validateOnly":{"type":"boolean"},"locationId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-business-info-update","x-zernio":["PUT /v1/accounts/{accountId}/gmb-location-details"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"title":{"type":"string","description":"Business name as on the storefront","maxLength":100},"storeCode":{"type":"string","maxLength":64},"languageCode":{"type":"string"},"categories":{"type":"object","properties":{"primaryCategory":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"additionalCategories":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"maxItems":9}}},"phoneNumbers":{"type":"object","properties":{"primaryPhone":{"type":"string"},"additionalPhones":{"type":"array","items":{"type":"string"},"maxItems":2}}},"websiteUri":{"type":"string","format":"uri"},"storefrontAddress":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}},"description":"Changing the address can trigger re-verification"},"latlng":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"openInfo":{"type":"object","properties":{"status":{"type":"string","enum":["OPEN","CLOSED_TEMPORARILY","CLOSED_PERMANENTLY"]},"canReopen":{"type":"boolean","readOnly":true},"openingDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"}}},"profile":{"type":"object","properties":{"description":{"type":"string","maxLength":750}}},"labels":{"type":"array","items":{"type":"string","maxLength":50},"maxItems":10},"adWordsLocationExtensions":{"type":"object","properties":{"adPhone":{"type":"string"}}},"metadata":{"type":"object","properties":{"placeId":{"type":"string"},"mapsUri":{"type":"string","format":"uri"},"newReviewUri":{"type":"string","format":"uri"},"hasVoiceOfMerchant":{"type":"boolean"},"hasPendingEdits":{"type":"boolean"},"hasGoogleUpdated":{"type":"boolean"},"canHaveFoodMenus":{"type":"boolean"},"canOperateLodgingData":{"type":"boolean"},"canOperateLocalPost":{"type":"boolean"},"canModifyServiceList":{"type":"boolean"},"canDelete":{"type":"boolean"},"duplicateLocation":{"type":"string"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/business-info/search-categories":{"post":{"operationId":"googleBusinessBusinessInfoSearchCategories","summary":"Google Business Profile: Search categories (Business information)","tags":["Focus · Google Business Profile"],"description":"Category lookup for the primary/additional category pickers. Name, categories, phone, website, address, opening date/status, description, labels. Edits are moderated by Google; changing the name, address or primary category may trigger re-verification. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: `/v1/accounts/{accountId}/focus/business-info`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"search":{"type":"string"},"regionCode":{"type":"string","default":"US"},"languageCode":{"type":"string","default":"en"}},"required":["search"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-business-info-search-categories","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/hours":{"get":{"operationId":"googleBusinessHoursGet","summary":"Google Business Profile: Get Hours","tags":["Focus · Google Business Profile"],"description":"Regular hours, special (holiday) hours and more hours (delivery, drive-through, …) offered by the primary category. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: `/v1/accounts/{accountId}/focus/hours`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false,"description":"Another location this connection manages (\"locations/{id}\" or \"accounts/{a}/locations/{l}\")"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-hours-get","x-zernio":["GET /v1/accounts/{accountId}/gmb-location-details"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"regularHours":{"type":"object","properties":{"periods":{"type":"array","items":{"type":"object","properties":{"openDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"openTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closeDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"closeTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"}}}}},"description":"Regular opening hours"},"specialHours":{"type":"object","properties":{"specialHourPeriods":{"type":"array","items":{"type":"object","properties":{"startDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"endDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"openTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closeTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closed":{"type":"boolean"}}}}},"description":"Holiday / exceptional hours"},"moreHours":{"type":"array","items":{"type":"object","properties":{"hoursTypeId":{"type":"string","description":"From the primary category moreHoursTypes, e.g. DELIVERY, DRIVE_THROUGH"},"periods":{"type":"array","items":{"type":"object","properties":{"openDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"openTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closeDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"closeTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"}}}}}}},"availableMoreHoursTypes":{"type":"array","items":{"type":"object","properties":{"hoursTypeId":{"type":"string"},"displayName":{"type":"string"},"localizedDisplayName":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"googleBusinessHoursUpdate","summary":"Google Business Profile: Update Hours","tags":["Focus · Google Business Profile"],"description":"Regular hours, special (holiday) hours and more hours (delivery, drive-through, …) offered by the primary category. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: `/v1/accounts/{accountId}/focus/hours`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"regularHours":{"type":"object","properties":{"periods":{"type":"array","items":{"type":"object","properties":{"openDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"openTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closeDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"closeTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"}}}}},"description":"Regular opening hours"},"specialHours":{"type":"object","properties":{"specialHourPeriods":{"type":"array","items":{"type":"object","properties":{"startDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"endDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"openTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closeTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closed":{"type":"boolean"}}}}},"description":"Holiday / exceptional hours"},"moreHours":{"type":"array","items":{"type":"object","properties":{"hoursTypeId":{"type":"string","description":"From the primary category moreHoursTypes, e.g. DELIVERY, DRIVE_THROUGH"},"periods":{"type":"array","items":{"type":"object","properties":{"openDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"openTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closeDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"closeTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"}}}}}}},"locationId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-hours-update","x-zernio":["PUT /v1/accounts/{accountId}/gmb-location-details"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"regularHours":{"type":"object","properties":{"periods":{"type":"array","items":{"type":"object","properties":{"openDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"openTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closeDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"closeTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"}}}}},"description":"Regular opening hours"},"specialHours":{"type":"object","properties":{"specialHourPeriods":{"type":"array","items":{"type":"object","properties":{"startDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"endDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"openTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closeTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closed":{"type":"boolean"}}}}},"description":"Holiday / exceptional hours"},"moreHours":{"type":"array","items":{"type":"object","properties":{"hoursTypeId":{"type":"string","description":"From the primary category moreHoursTypes, e.g. DELIVERY, DRIVE_THROUGH"},"periods":{"type":"array","items":{"type":"object","properties":{"openDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"openTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"closeDay":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"closeTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"}}}}}}},"availableMoreHoursTypes":{"type":"array","items":{"type":"object","properties":{"hoursTypeId":{"type":"string"},"displayName":{"type":"string"},"localizedDisplayName":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/service-area":{"get":{"operationId":"googleBusinessServiceAreaGet","summary":"Google Business Profile: Get Service area","tags":["Focus · Google Business Profile"],"description":"For service-area businesses: the regions/places you serve and whether customers can visit. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: `/v1/accounts/{accountId}/focus/service-area`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false,"description":"Another location this connection manages (\"locations/{id}\" or \"accounts/{a}/locations/{l}\")"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-service-area-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"serviceArea":{"type":"object","properties":{"businessType":{"type":"string","enum":["CUSTOMER_LOCATION_ONLY","CUSTOMER_AND_BUSINESS_LOCATION"]},"regionCode":{"type":"string"},"places":{"type":"object","properties":{"placeInfos":{"type":"array","items":{"type":"object","properties":{"placeName":{"type":"string"},"placeId":{"type":"string"}}},"maxItems":20}}}}},"storefrontAddress":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}},"description":"Changing the address can trigger re-verification"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"googleBusinessServiceAreaUpdate","summary":"Google Business Profile: Update Service area","tags":["Focus · Google Business Profile"],"description":"For service-area businesses: the regions/places you serve and whether customers can visit. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations Generic route: `/v1/accounts/{accountId}/focus/service-area`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"serviceArea":{"type":"object","properties":{"businessType":{"type":"string","enum":["CUSTOMER_LOCATION_ONLY","CUSTOMER_AND_BUSINESS_LOCATION"]},"regionCode":{"type":"string"},"places":{"type":"object","properties":{"placeInfos":{"type":"array","items":{"type":"object","properties":{"placeName":{"type":"string"},"placeId":{"type":"string"}}},"maxItems":20}}}}},"locationId":{"type":"string"}},"required":["serviceArea"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-service-area-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"serviceArea":{"type":"object","properties":{"businessType":{"type":"string","enum":["CUSTOMER_LOCATION_ONLY","CUSTOMER_AND_BUSINESS_LOCATION"]},"regionCode":{"type":"string"},"places":{"type":"object","properties":{"placeInfos":{"type":"array","items":{"type":"object","properties":{"placeName":{"type":"string"},"placeId":{"type":"string"}}},"maxItems":20}}}}},"storefrontAddress":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}},"description":"Changing the address can trigger re-verification"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/attributes":{"get":{"operationId":"googleBusinessAttributesList","summary":"Google Business Profile: List Attributes","tags":["Focus · Google Business Profile"],"description":"Amenities and highlights (Wi-Fi, outdoor seating, accessibility, payments, women-led, online appointments, menu/reservation URLs) available for the primary category. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/updateAttributes Generic route: `/v1/accounts/{accountId}/focus/attributes`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"includeUnset","required":false,"description":"Also list attributes available but not set"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-attributes-list","x-zernio":["GET /v1/accounts/{accountId}/gmb-attributes","GET /v1/accounts/{accountId}/gmb-attribute-metadata"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","description":"attributes/{attribute_id}"},"displayName":{"type":"string","readOnly":true},"groupDisplayName":{"type":"string","readOnly":true},"valueType":{"type":"string","enum":["BOOL","ENUM","URL","REPEATED_ENUM"],"readOnly":true},"values":{"type":"array","items":{}},"repeatedEnumValue":{"type":"object","properties":{"setValues":{"type":"array","items":{"type":"string"}},"unsetValues":{"type":"array","items":{"type":"string"}}}},"uriValues":{"type":"array","items":{"type":"object","properties":{"uri":{"type":"string","format":"uri"}}}},"valueMetadata":{"type":"array","items":{"type":"object","properties":{"value":{},"displayName":{"type":"string"}}},"readOnly":true},"repeatable":{"type":"boolean","readOnly":true},"deprecated":{"type":"boolean","readOnly":true},"set":{"type":"boolean","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/attributes/{itemId}":{"patch":{"operationId":"googleBusinessAttributesUpdate","summary":"Google Business Profile: Update a Attributes item","tags":["Focus · Google Business Profile"],"description":"Set one attribute. Amenities and highlights (Wi-Fi, outdoor seating, accessibility, payments, women-led, online appointments, menu/reservation URLs) available for the primary category. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/updateAttributes Generic route: `/v1/accounts/{accountId}/focus/attributes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"values":{"type":"array","items":{}},"repeatedEnumValue":{"type":"object","properties":{"setValues":{"type":"array","items":{"type":"string"}},"unsetValues":{"type":"array","items":{"type":"string"}}}},"uriValues":{"type":"array","items":{"type":"string"}},"locationId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-attributes-update","x-zernio":["PUT /v1/accounts/{accountId}/gmb-attributes"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","description":"attributes/{attribute_id}"},"displayName":{"type":"string","readOnly":true},"groupDisplayName":{"type":"string","readOnly":true},"valueType":{"type":"string","enum":["BOOL","ENUM","URL","REPEATED_ENUM"],"readOnly":true},"values":{"type":"array","items":{}},"repeatedEnumValue":{"type":"object","properties":{"setValues":{"type":"array","items":{"type":"string"}},"unsetValues":{"type":"array","items":{"type":"string"}}}},"uriValues":{"type":"array","items":{"type":"object","properties":{"uri":{"type":"string","format":"uri"}}}},"valueMetadata":{"type":"array","items":{"type":"object","properties":{"value":{},"displayName":{"type":"string"}}},"readOnly":true},"repeatable":{"type":"boolean","readOnly":true},"deprecated":{"type":"boolean","readOnly":true},"set":{"type":"boolean","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"googleBusinessAttributesDelete","summary":"Google Business Profile: Delete a Attributes item","tags":["Focus · Google Business Profile"],"description":"Clear one attribute (masked but absent → unset). Amenities and highlights (Wi-Fi, outdoor seating, accessibility, payments, women-led, online appointments, menu/reservation URLs) available for the primary category. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/updateAttributes Generic route: `/v1/accounts/{accountId}/focus/attributes`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_google_business","x-mcp-tool":"google-business-attributes-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/attributes/bulk-update":{"post":{"operationId":"googleBusinessAttributesBulkUpdate","summary":"Google Business Profile: Update attributes (Attributes)","tags":["Focus · Google Business Profile"],"description":"Zernio PUT gmb-attributes: attributes[] + attributeMask. Amenities and highlights (Wi-Fi, outdoor seating, accessibility, payments, women-led, online appointments, menu/reservation URLs) available for the primary category. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/updateAttributes Generic route: `/v1/accounts/{accountId}/focus/attributes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"attributes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{}},"repeatedEnumValue":{"type":"object","properties":{}},"uriValues":{"type":"array","items":{}}}}},"attributeMask":{"type":"array","items":{"type":"string"}},"locationId":{"type":"string"}},"required":["attributes"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-attributes-bulk-update","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/google-updates":{"get":{"operationId":"googleBusinessGoogleUpdatesGet","summary":"Google Business Profile: Get Google updates","tags":["Focus · Google Business Profile"],"description":"Edits suggested by Google or users that differ from your data (diffMask) and edits still pending review (pendingMask). Accept Google's value or keep yours. Never revert Google-updated values automatically: show the diff and let the user choose. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/getGoogleUpdated Generic route: `/v1/accounts/{accountId}/focus/google-updates`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false,"description":"Another location this connection manages (\"locations/{id}\" or \"accounts/{a}/locations/{l}\")"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-google-updates-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"location":{"type":"object","properties":{"title":{"type":"string","description":"Business name as on the storefront","maxLength":100},"storeCode":{"type":"string","maxLength":64},"languageCode":{"type":"string"},"categories":{"type":"object","properties":{"primaryCategory":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"additionalCategories":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"maxItems":9}}},"phoneNumbers":{"type":"object","properties":{"primaryPhone":{"type":"string"},"additionalPhones":{"type":"array","items":{"type":"string"},"maxItems":2}}},"websiteUri":{"type":"string","format":"uri"},"storefrontAddress":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}},"description":"Changing the address can trigger re-verification"},"latlng":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"openInfo":{"type":"object","properties":{"status":{"type":"string","enum":["OPEN","CLOSED_TEMPORARILY","CLOSED_PERMANENTLY"]},"canReopen":{"type":"boolean","readOnly":true},"openingDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"}}},"profile":{"type":"object","properties":{"description":{"type":"string","maxLength":750}}},"labels":{"type":"array","items":{"type":"string","maxLength":50},"maxItems":10},"adWordsLocationExtensions":{"type":"object","properties":{"adPhone":{"type":"string"}}}},"description":"Google-updated values"},"diffMask":{"type":"string"},"pendingMask":{"type":"string"},"diffFields":{"type":"array","items":{"type":"string"}},"pendingFields":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/google-updates/accept":{"post":{"operationId":"googleBusinessGoogleUpdatesAccept","summary":"Google Business Profile: Accept Google's values (Google updates)","tags":["Focus · Google Business Profile"],"description":"User-initiated only; never automate. Edits suggested by Google or users that differ from your data (diffMask) and edits still pending review (pendingMask). Accept Google's value or keep yours. Never revert Google-updated values automatically: show the diff and let the user choose. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/getGoogleUpdated Generic route: `/v1/accounts/{accountId}/focus/google-updates`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"type":"array","items":{"type":"string"},"description":"Default: every field in diffMask"},"locationId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-google-updates-accept","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/google-updates/reject":{"post":{"operationId":"googleBusinessGoogleUpdatesReject","summary":"Google Business Profile: Keep my values (Google updates)","tags":["Focus · Google Business Profile"],"description":"Re-submit your values for these fields. User-initiated only; never automate. Edits suggested by Google or users that differ from your data (diffMask) and edits still pending review (pendingMask). Accept Google's value or keep yours. Never revert Google-updated values automatically: show the diff and let the user choose. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations/getGoogleUpdated Generic route: `/v1/accounts/{accountId}/focus/google-updates`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"type":"array","items":{"type":"string"}},"locationId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-google-updates-reject","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/categories":{"get":{"operationId":"googleBusinessCategoriesList","summary":"Google Business Profile: List Categories","tags":["Focus · Google Business Profile"],"description":"Search Google business categories (primary + up to 9 additional). FULL view adds service types and more-hours types. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/categories/list Generic route: `/v1/accounts/{accountId}/focus/categories`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"search","required":false},{"schema":{"type":"string","default":"US"},"in":"query","name":"regionCode","required":false},{"schema":{"type":"string","default":"en"},"in":"query","name":"languageCode","required":false},{"schema":{"type":"string","enum":["BASIC","FULL"]},"in":"query","name":"view","required":false},{"schema":{"type":"integer","maximum":100},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string"},"in":"query","name":"pageToken","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-categories-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"displayName":{"type":"string"},"serviceTypes":{"type":"array","items":{"type":"object","properties":{"serviceTypeId":{"type":"string"},"displayName":{"type":"string"}}}},"moreHoursTypes":{"type":"array","items":{"type":"object","properties":{"hoursTypeId":{"type":"string"},"displayName":{"type":"string"},"localizedDisplayName":{"type":"string"}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/categories/{itemId}":{"get":{"operationId":"googleBusinessCategoriesGet","summary":"Google Business Profile: Get a Categories item","tags":["Focus · Google Business Profile"],"description":"Search Google business categories (primary + up to 9 additional). FULL view adds service types and more-hours types. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/categories/list Generic route: `/v1/accounts/{accountId}/focus/categories`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"regionCode","required":false},{"schema":{"type":"string"},"in":"query","name":"languageCode","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-categories-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"displayName":{"type":"string"},"serviceTypes":{"type":"array","items":{"type":"object","properties":{"serviceTypeId":{"type":"string"},"displayName":{"type":"string"}}}},"moreHoursTypes":{"type":"array","items":{"type":"object","properties":{"hoursTypeId":{"type":"string"},"displayName":{"type":"string"},"localizedDisplayName":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/categories/current-categories":{"post":{"operationId":"googleBusinessCategoriesCurrentCategories","summary":"Google Business Profile: Current categories (Categories)","tags":["Focus · Google Business Profile"],"description":"Current categories. Search Google business categories (primary + up to 9 additional). FULL view adds service types and more-hours types. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/categories/list Generic route: `/v1/accounts/{accountId}/focus/categories`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locationId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-categories-current-categories","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/attribute-metadata":{"get":{"operationId":"googleBusinessAttributeMetadataList","summary":"Google Business Profile: List Attribute catalog","tags":["Focus · Google Business Profile"],"description":"Attributes available for this location, or for a category and region. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/attributes/list Generic route: `/v1/accounts/{accountId}/focus/attribute-metadata`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string"},"in":"query","name":"categoryName","required":false},{"schema":{"type":"string"},"in":"query","name":"regionCode","required":false},{"schema":{"type":"string"},"in":"query","name":"languageCode","required":false},{"schema":{"type":"boolean"},"in":"query","name":"showAll","required":false},{"schema":{"type":"integer"},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string"},"in":"query","name":"pageToken","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-attribute-metadata-list","x-zernio":["GET /v1/accounts/{accountId}/gmb-attribute-metadata"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"parent":{"type":"string"},"displayName":{"type":"string"},"groupDisplayName":{"type":"string"},"valueType":{"type":"string","enum":["BOOL","ENUM","URL","REPEATED_ENUM"]},"repeatable":{"type":"boolean"},"deprecated":{"type":"boolean"},"valueMetadata":{"type":"array","items":{"type":"object","properties":{"value":{},"displayName":{"type":"string"}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/chains":{"get":{"operationId":"googleBusinessChainsList","summary":"Google Business Profile: List Chains","tags":["Focus · Google Business Profile"],"description":"Look up a brand/chain to associate locations with (relationshipData.parentChain). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/chains/search Generic route: `/v1/accounts/{accountId}/focus/chains`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"chainName","required":true},{"schema":{"type":"integer","maximum":500},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-chains-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"chainNames":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string"},"languageCode":{"type":"string"}}}},"websites":{"type":"array","items":{"type":"object","properties":{"uri":{"type":"string","format":"uri"}}}},"locationCount":{"type":"integer"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/chains/{itemId}":{"get":{"operationId":"googleBusinessChainsGet","summary":"Google Business Profile: Get a Chains item","tags":["Focus · Google Business Profile"],"description":"Look up a brand/chain to associate locations with (relationshipData.parentChain). Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/chains/search Generic route: `/v1/accounts/{accountId}/focus/chains`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-chains-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"chainNames":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string"},"languageCode":{"type":"string"}}}},"websites":{"type":"array","items":{"type":"object","properties":{"uri":{"type":"string","format":"uri"}}}},"locationCount":{"type":"integer"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/google-locations":{"get":{"operationId":"googleBusinessGoogleLocationsList","summary":"Google Business Profile: List Find a Google listing","tags":["Focus · Google Business Profile"],"description":"Search existing Google listings to claim or request access (300/day). googleLocations:search only for merchants you already have a relationship with. Lead generation leads to revocation. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/googleLocations/search Generic route: `/v1/accounts/{accountId}/focus/google-locations`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"query","required":true,"description":"Business name and address"},{"schema":{"type":"integer","maximum":10},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-google-locations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"location":{"type":"object","properties":{"title":{"type":"string","description":"Business name as on the storefront","maxLength":100},"storeCode":{"type":"string","maxLength":64},"languageCode":{"type":"string"},"categories":{"type":"object","properties":{"primaryCategory":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"additionalCategories":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"categories/gcid:…"},"displayName":{"type":"string","readOnly":true}}},"maxItems":9}}},"phoneNumbers":{"type":"object","properties":{"primaryPhone":{"type":"string"},"additionalPhones":{"type":"array","items":{"type":"string"},"maxItems":2}}},"websiteUri":{"type":"string","format":"uri"},"storefrontAddress":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}},"description":"Changing the address can trigger re-verification"},"latlng":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"openInfo":{"type":"object","properties":{"status":{"type":"string","enum":["OPEN","CLOSED_TEMPORARILY","CLOSED_PERMANENTLY"]},"canReopen":{"type":"boolean","readOnly":true},"openingDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"}}},"profile":{"type":"object","properties":{"description":{"type":"string","maxLength":750}}},"labels":{"type":"array","items":{"type":"string","maxLength":50},"maxItems":10},"adWordsLocationExtensions":{"type":"object","properties":{"adPhone":{"type":"string"}}}}},"requestAdminRightsUri":{"type":"string","format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/posts":{"get":{"operationId":"googleBusinessPostsList","summary":"Google Business Profile: List Posts","tags":["Focus · Google Business Profile"],"description":"Updates, events and offers shown on Search and Maps. CTA buttons: Book, Order, Shop, Learn more, Sign up, Call. One photo or video per post (public URL). Product and Alert posts cannot be created via the API; posts have no insights. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"integer","maximum":100},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string"},"in":"query","name":"pageToken","required":false},{"schema":{"type":"string","enum":["STANDARD","EVENT","OFFER","ALERT"]},"in":"query","name":"topicType","required":false},{"schema":{"type":"string"},"in":"query","name":"state","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"topicType":{"type":"string","enum":["STANDARD","EVENT","OFFER"]},"summary":{"type":"string","maxLength":1500},"languageCode":{"type":"string"},"state":{"type":"string","enum":["LIVE","PROCESSING","SCHEDULED","RECURRING","REJECTED"],"readOnly":true},"searchUrl":{"type":"string","format":"uri","readOnly":true},"createTime":{"type":"string","format":"date-time","readOnly":true},"updateTime":{"type":"string","format":"date-time","readOnly":true},"scheduledTime":{"type":"string","format":"date-time","description":"Google-native scheduling"},"callToAction":{"type":"object","properties":{"actionType":{"type":"string","enum":["BOOK","ORDER","SHOP","LEARN_MORE","SIGN_UP","CALL"]},"url":{"type":"string","format":"uri"}}},"event":{"type":"object","properties":{"title":{"type":"string"},"schedule":{"type":"object","properties":{"startDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"startTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"endDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"endTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"}}},"recurrenceInfo":{"type":"object","properties":{"seriesEndTime":{"type":"string","format":"date-time"},"dailyPattern":{"type":"object","properties":{}},"weeklyPattern":{"type":"object","properties":{"daysOfWeek":{"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}}}},"monthlyPattern":{"type":"object","properties":{"dayOfMonth":{"type":"integer","minimum":1,"maximum":31},"dayOfWeekOccurrence":{"type":"string","enum":["FIRST","SECOND","THIRD","FOURTH","LAST"]}}}}}}},"offer":{"type":"object","properties":{"couponCode":{"type":"string"},"redeemOnlineUrl":{"type":"string","format":"uri"},"termsConditions":{"type":"string"}}},"media":{"type":"array","items":{"type":"object","properties":{"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"sourceUrl":{"type":"string","format":"uri"},"googleUrl":{"type":"string","format":"uri","readOnly":true}}},"maxItems":1},"alertType":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"googleBusinessPostsCreate","summary":"Google Business Profile: Create a Posts item","tags":["Focus · Google Business Profile"],"description":"Publish now (or hand scheduling to Google via options.scheduledTime). Updates, events and offers shown on Search and Maps. CTA buttons: Book, Order, Shop, Learn more, Sign up, Call. One photo or video per post (public URL). Product and Alert posts cannot be created via the API; posts have no insights. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string","maxLength":1500},"mediaUrl":{"type":"string","format":"uri","description":"Public photo/video URL (sourceUrl)"},"mediaType":{"type":"string","enum":["image","video"]},"media":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"options":{"title":"Post options","type":"object","additionalProperties":false,"properties":{"topicType":{"type":"string","enum":["STANDARD","EVENT","OFFER"],"default":"STANDARD","description":"Post type. EVENT needs `event`; OFFER needs `event` (validity) and usually `offer`."},"locationId":{"type":"string","description":"Target another location the connection manages: \"locations/{id}\" or \"accounts/{a}/locations/{l}\". Default: the account's selected location. Repeat the platform entry with different locationIds to fan out."},"googleAccountId":{"type":"string","description":"\"accounts/{id}\" owning `locationId`, when it differs from the connection's account."},"languageCode":{"type":"string","description":"BCP 47 language of the post (metadata only, no translation). Default: the location language or \"en\"."},"callToAction":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["BOOK","ORDER","SHOP","LEARN_MORE","SIGN_UP","CALL"],"description":"Button type (Zernio name)."},"actionType":{"type":"string","enum":["BOOK","ORDER","SHOP","LEARN_MORE","SIGN_UP","CALL"],"description":"Button type (Google name; alias of `type`)."},"url":{"type":"string","format":"uri","description":"HTTPS destination. Required except for CALL (which dials the profile phone)."}}},"event":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","description":"Heading shown in Search/Maps."},"schedule":{"type":"object","additionalProperties":false,"properties":{"startDate":{"description":"{year, month, day} or \"YYYY-MM-DD\" (an ISO datetime is also accepted; its time part fills the matching *Time)","oneOf":[{"type":"object","properties":{"year":{"type":"integer"},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["year","month","day"]},{"type":"string"}]},"startTime":{"description":"{hours, minutes} (24 h) or \"HH:MM\"","oneOf":[{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":23},"minutes":{"type":"integer","minimum":0,"maximum":59}}},{"type":"string"}]},"endDate":{"description":"{year, month, day} or \"YYYY-MM-DD\" (an ISO datetime is also accepted; its time part fills the matching *Time)","oneOf":[{"type":"object","properties":{"year":{"type":"integer"},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["year","month","day"]},{"type":"string"}]},"endTime":{"description":"{hours, minutes} (24 h) or \"HH:MM\"","oneOf":[{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":23},"minutes":{"type":"integer","minimum":0,"maximum":59}}},{"type":"string"}]}},"required":["startDate","endDate"]},"startDateTime":{"type":"string","format":"date-time","description":"Shorthand for schedule.startDate + startTime."},"endDateTime":{"type":"string","format":"date-time","description":"Shorthand for schedule.endDate + endTime."},"recurrenceInfo":{"type":"object","description":"Recurring post (2026-04). Exactly one pattern.","additionalProperties":false,"properties":{"seriesEndTime":{"type":"string","format":"date-time"},"dailyPattern":{"type":"object"},"weeklyPattern":{"type":"object","properties":{"daysOfWeek":{"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}}}},"monthlyPattern":{"type":"object","properties":{"dayOfMonth":{"type":"integer","minimum":1,"maximum":31},"dayOfWeekOccurrence":{"type":"string","enum":["FIRST","SECOND","THIRD","FOURTH","LAST"]}}}}}}},"offer":{"type":"object","additionalProperties":false,"properties":{"couponCode":{"type":"string"},"redeemOnlineUrl":{"type":"string","format":"uri"},"termsConditions":{"type":"string"}}},"scheduledTime":{"type":"string","format":"date-time","description":"Google-native scheduling: the post stays SCHEDULED until this time. Socialit normally schedules itself; use this only to hand scheduling to Google."}}}},"description":"Post text + options (topicType, callToAction, event, offer, scheduledTime, locationId)"}}},"description":"Post text + options (topicType, callToAction, event, offer, scheduledTime, locationId)"},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_google_business","x-mcp-tool":"google-business-posts-create","x-idempotent":true,"x-zernio":["POST /v1/posts","POST /v1/posts/{postId}/edit","POST /v1/posts/{postId}/unpublish"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"topicType":{"type":"string","enum":["STANDARD","EVENT","OFFER"]},"summary":{"type":"string","maxLength":1500},"languageCode":{"type":"string"},"state":{"type":"string","enum":["LIVE","PROCESSING","SCHEDULED","RECURRING","REJECTED"],"readOnly":true},"searchUrl":{"type":"string","format":"uri","readOnly":true},"createTime":{"type":"string","format":"date-time","readOnly":true},"updateTime":{"type":"string","format":"date-time","readOnly":true},"scheduledTime":{"type":"string","format":"date-time","description":"Google-native scheduling"},"callToAction":{"type":"object","properties":{"actionType":{"type":"string","enum":["BOOK","ORDER","SHOP","LEARN_MORE","SIGN_UP","CALL"]},"url":{"type":"string","format":"uri"}}},"event":{"type":"object","properties":{"title":{"type":"string"},"schedule":{"type":"object","properties":{"startDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"startTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"endDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"endTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"}}},"recurrenceInfo":{"type":"object","properties":{"seriesEndTime":{"type":"string","format":"date-time"},"dailyPattern":{"type":"object","properties":{}},"weeklyPattern":{"type":"object","properties":{"daysOfWeek":{"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}}}},"monthlyPattern":{"type":"object","properties":{"dayOfMonth":{"type":"integer","minimum":1,"maximum":31},"dayOfWeekOccurrence":{"type":"string","enum":["FIRST","SECOND","THIRD","FOURTH","LAST"]}}}}}}},"offer":{"type":"object","properties":{"couponCode":{"type":"string"},"redeemOnlineUrl":{"type":"string","format":"uri"},"termsConditions":{"type":"string"}}},"media":{"type":"array","items":{"type":"object","properties":{"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"sourceUrl":{"type":"string","format":"uri"},"googleUrl":{"type":"string","format":"uri","readOnly":true}}},"maxItems":1},"alertType":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/posts/{itemId}":{"get":{"operationId":"googleBusinessPostsGet","summary":"Google Business Profile: Get a Posts item","tags":["Focus · Google Business Profile"],"description":"Updates, events and offers shown on Search and Maps. CTA buttons: Book, Order, Shop, Learn more, Sign up, Call. One photo or video per post (public URL). Product and Alert posts cannot be created via the API; posts have no insights. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-posts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"topicType":{"type":"string","enum":["STANDARD","EVENT","OFFER"]},"summary":{"type":"string","maxLength":1500},"languageCode":{"type":"string"},"state":{"type":"string","enum":["LIVE","PROCESSING","SCHEDULED","RECURRING","REJECTED"],"readOnly":true},"searchUrl":{"type":"string","format":"uri","readOnly":true},"createTime":{"type":"string","format":"date-time","readOnly":true},"updateTime":{"type":"string","format":"date-time","readOnly":true},"scheduledTime":{"type":"string","format":"date-time","description":"Google-native scheduling"},"callToAction":{"type":"object","properties":{"actionType":{"type":"string","enum":["BOOK","ORDER","SHOP","LEARN_MORE","SIGN_UP","CALL"]},"url":{"type":"string","format":"uri"}}},"event":{"type":"object","properties":{"title":{"type":"string"},"schedule":{"type":"object","properties":{"startDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"startTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"endDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"endTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"}}},"recurrenceInfo":{"type":"object","properties":{"seriesEndTime":{"type":"string","format":"date-time"},"dailyPattern":{"type":"object","properties":{}},"weeklyPattern":{"type":"object","properties":{"daysOfWeek":{"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}}}},"monthlyPattern":{"type":"object","properties":{"dayOfMonth":{"type":"integer","minimum":1,"maximum":31},"dayOfWeekOccurrence":{"type":"string","enum":["FIRST","SECOND","THIRD","FOURTH","LAST"]}}}}}}},"offer":{"type":"object","properties":{"couponCode":{"type":"string"},"redeemOnlineUrl":{"type":"string","format":"uri"},"termsConditions":{"type":"string"}}},"media":{"type":"array","items":{"type":"object","properties":{"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"sourceUrl":{"type":"string","format":"uri"},"googleUrl":{"type":"string","format":"uri","readOnly":true}}},"maxItems":1},"alertType":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"googleBusinessPostsUpdate","summary":"Google Business Profile: Update a Posts item","tags":["Focus · Google Business Profile"],"description":"Edit text, CTA, event, offer, media or scheduled time (topic type is immutable). Updates, events and offers shown on Search and Maps. CTA buttons: Book, Order, Shop, Learn more, Sign up, Call. One photo or video per post (public URL). Product and Alert posts cannot be created via the API; posts have no insights. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string","maxLength":1500},"mediaUrl":{"type":"string","format":"uri","description":"Public photo/video URL (sourceUrl)"},"mediaType":{"type":"string","enum":["image","video"]},"media":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"options":{"title":"Post options","type":"object","additionalProperties":false,"properties":{"topicType":{"type":"string","enum":["STANDARD","EVENT","OFFER"],"default":"STANDARD","description":"Post type. EVENT needs `event`; OFFER needs `event` (validity) and usually `offer`."},"locationId":{"type":"string","description":"Target another location the connection manages: \"locations/{id}\" or \"accounts/{a}/locations/{l}\". Default: the account's selected location. Repeat the platform entry with different locationIds to fan out."},"googleAccountId":{"type":"string","description":"\"accounts/{id}\" owning `locationId`, when it differs from the connection's account."},"languageCode":{"type":"string","description":"BCP 47 language of the post (metadata only, no translation). Default: the location language or \"en\"."},"callToAction":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["BOOK","ORDER","SHOP","LEARN_MORE","SIGN_UP","CALL"],"description":"Button type (Zernio name)."},"actionType":{"type":"string","enum":["BOOK","ORDER","SHOP","LEARN_MORE","SIGN_UP","CALL"],"description":"Button type (Google name; alias of `type`)."},"url":{"type":"string","format":"uri","description":"HTTPS destination. Required except for CALL (which dials the profile phone)."}}},"event":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","description":"Heading shown in Search/Maps."},"schedule":{"type":"object","additionalProperties":false,"properties":{"startDate":{"description":"{year, month, day} or \"YYYY-MM-DD\" (an ISO datetime is also accepted; its time part fills the matching *Time)","oneOf":[{"type":"object","properties":{"year":{"type":"integer"},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["year","month","day"]},{"type":"string"}]},"startTime":{"description":"{hours, minutes} (24 h) or \"HH:MM\"","oneOf":[{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":23},"minutes":{"type":"integer","minimum":0,"maximum":59}}},{"type":"string"}]},"endDate":{"description":"{year, month, day} or \"YYYY-MM-DD\" (an ISO datetime is also accepted; its time part fills the matching *Time)","oneOf":[{"type":"object","properties":{"year":{"type":"integer"},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"required":["year","month","day"]},{"type":"string"}]},"endTime":{"description":"{hours, minutes} (24 h) or \"HH:MM\"","oneOf":[{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":23},"minutes":{"type":"integer","minimum":0,"maximum":59}}},{"type":"string"}]}},"required":["startDate","endDate"]},"startDateTime":{"type":"string","format":"date-time","description":"Shorthand for schedule.startDate + startTime."},"endDateTime":{"type":"string","format":"date-time","description":"Shorthand for schedule.endDate + endTime."},"recurrenceInfo":{"type":"object","description":"Recurring post (2026-04). Exactly one pattern.","additionalProperties":false,"properties":{"seriesEndTime":{"type":"string","format":"date-time"},"dailyPattern":{"type":"object"},"weeklyPattern":{"type":"object","properties":{"daysOfWeek":{"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}}}},"monthlyPattern":{"type":"object","properties":{"dayOfMonth":{"type":"integer","minimum":1,"maximum":31},"dayOfWeekOccurrence":{"type":"string","enum":["FIRST","SECOND","THIRD","FOURTH","LAST"]}}}}}}},"offer":{"type":"object","additionalProperties":false,"properties":{"couponCode":{"type":"string"},"redeemOnlineUrl":{"type":"string","format":"uri"},"termsConditions":{"type":"string"}}},"scheduledTime":{"type":"string","format":"date-time","description":"Google-native scheduling: the post stays SCHEDULED until this time. Socialit normally schedules itself; use this only to hand scheduling to Google."}}}},"description":"Post text + options (topicType, callToAction, event, offer, scheduledTime, locationId)"}}},"description":"Post text + options (topicType, callToAction, event, offer, scheduledTime, locationId)"},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-posts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"topicType":{"type":"string","enum":["STANDARD","EVENT","OFFER"]},"summary":{"type":"string","maxLength":1500},"languageCode":{"type":"string"},"state":{"type":"string","enum":["LIVE","PROCESSING","SCHEDULED","RECURRING","REJECTED"],"readOnly":true},"searchUrl":{"type":"string","format":"uri","readOnly":true},"createTime":{"type":"string","format":"date-time","readOnly":true},"updateTime":{"type":"string","format":"date-time","readOnly":true},"scheduledTime":{"type":"string","format":"date-time","description":"Google-native scheduling"},"callToAction":{"type":"object","properties":{"actionType":{"type":"string","enum":["BOOK","ORDER","SHOP","LEARN_MORE","SIGN_UP","CALL"]},"url":{"type":"string","format":"uri"}}},"event":{"type":"object","properties":{"title":{"type":"string"},"schedule":{"type":"object","properties":{"startDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"startTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"},"endDate":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31}},"description":"Calendar date"},"endTime":{"type":"object","properties":{"hours":{"type":"integer","minimum":0,"maximum":24},"minutes":{"type":"integer","minimum":0,"maximum":59}},"description":"24 h time (hours 24 = midnight end of day)"}}},"recurrenceInfo":{"type":"object","properties":{"seriesEndTime":{"type":"string","format":"date-time"},"dailyPattern":{"type":"object","properties":{}},"weeklyPattern":{"type":"object","properties":{"daysOfWeek":{"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}}}},"monthlyPattern":{"type":"object","properties":{"dayOfMonth":{"type":"integer","minimum":1,"maximum":31},"dayOfWeekOccurrence":{"type":"string","enum":["FIRST","SECOND","THIRD","FOURTH","LAST"]}}}}}}},"offer":{"type":"object","properties":{"couponCode":{"type":"string"},"redeemOnlineUrl":{"type":"string","format":"uri"},"termsConditions":{"type":"string"}}},"media":{"type":"array","items":{"type":"object","properties":{"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"sourceUrl":{"type":"string","format":"uri"},"googleUrl":{"type":"string","format":"uri","readOnly":true}}},"maxItems":1},"alertType":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"googleBusinessPostsDelete","summary":"Google Business Profile: Delete a Posts item","tags":["Focus · Google Business Profile"],"description":"Updates, events and offers shown on Search and Maps. CTA buttons: Book, Order, Shop, Learn more, Sign up, Call. One photo or video per post (public URL). Product and Alert posts cannot be created via the API; posts have no insights. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_google_business","x-mcp-tool":"google-business-posts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/media":{"get":{"operationId":"googleBusinessMediaList","summary":"Google Business Profile: List Photos & videos","tags":["Focus · Google Business Profile"],"description":"Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: `/v1/accounts/{accountId}/focus/media`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"integer","maximum":2500},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string"},"in":"query","name":"pageToken","required":false},{"schema":{"type":"string","enum":["COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL","CATEGORY_UNSPECIFIED"]},"in":"query","name":"category","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-media-list","x-zernio":["GET /v1/accounts/{accountId}/gmb-media"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"sourceUrl":{"type":"string","format":"uri","description":"Public URL Google fetches (immutable)"},"googleUrl":{"type":"string","format":"uri","readOnly":true},"thumbnailUrl":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","description":"Create only; not allowed on COVER"},"createTime":{"type":"string","format":"date-time","readOnly":true},"locationAssociation":{"type":"object","properties":{"category":{"type":"string","enum":["COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL","CATEGORY_UNSPECIFIED"]},"priceListItemId":{"type":"string"}}},"dimensions":{"type":"object","properties":{"widthPixels":{"type":"integer"},"heightPixels":{"type":"integer"}},"readOnly":true},"attribution":{"type":"object","properties":{"profileName":{"type":"string"},"profilePhotoUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"},"takedownUrl":{"type":"string","format":"uri"}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"googleBusinessMediaCreate","summary":"Google Business Profile: Create a Photos & videos item","tags":["Focus · Google Business Profile"],"description":"Add a photo/video from a public URL (Zernio POST gmb-media). Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceUrl":{"type":"string","format":"uri"},"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"category":{"type":"string","enum":["COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL","CATEGORY_UNSPECIFIED"]},"description":{"type":"string"},"locationId":{"type":"string"}},"required":["sourceUrl"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_google_business","x-mcp-tool":"google-business-media-create","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-media"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"sourceUrl":{"type":"string","format":"uri","description":"Public URL Google fetches (immutable)"},"googleUrl":{"type":"string","format":"uri","readOnly":true},"thumbnailUrl":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","description":"Create only; not allowed on COVER"},"createTime":{"type":"string","format":"date-time","readOnly":true},"locationAssociation":{"type":"object","properties":{"category":{"type":"string","enum":["COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL","CATEGORY_UNSPECIFIED"]},"priceListItemId":{"type":"string"}}},"dimensions":{"type":"object","properties":{"widthPixels":{"type":"integer"},"heightPixels":{"type":"integer"}},"readOnly":true},"attribution":{"type":"object","properties":{"profileName":{"type":"string"},"profilePhotoUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"},"takedownUrl":{"type":"string","format":"uri"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/media/{itemId}":{"get":{"operationId":"googleBusinessMediaGet","summary":"Google Business Profile: Get a Photos & videos item","tags":["Focus · Google Business Profile"],"description":"Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: `/v1/accounts/{accountId}/focus/media`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-media-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"sourceUrl":{"type":"string","format":"uri","description":"Public URL Google fetches (immutable)"},"googleUrl":{"type":"string","format":"uri","readOnly":true},"thumbnailUrl":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","description":"Create only; not allowed on COVER"},"createTime":{"type":"string","format":"date-time","readOnly":true},"locationAssociation":{"type":"object","properties":{"category":{"type":"string","enum":["COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL","CATEGORY_UNSPECIFIED"]},"priceListItemId":{"type":"string"}}},"dimensions":{"type":"object","properties":{"widthPixels":{"type":"integer"},"heightPixels":{"type":"integer"}},"readOnly":true},"attribution":{"type":"object","properties":{"profileName":{"type":"string"},"profilePhotoUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"},"takedownUrl":{"type":"string","format":"uri"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"googleBusinessMediaUpdate","summary":"Google Business Profile: Update a Photos & videos item","tags":["Focus · Google Business Profile"],"description":"Change category or description. Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL","CATEGORY_UNSPECIFIED"]},"description":{"type":"string"},"priceListItemId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-media-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"sourceUrl":{"type":"string","format":"uri","description":"Public URL Google fetches (immutable)"},"googleUrl":{"type":"string","format":"uri","readOnly":true},"thumbnailUrl":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","description":"Create only; not allowed on COVER"},"createTime":{"type":"string","format":"date-time","readOnly":true},"locationAssociation":{"type":"object","properties":{"category":{"type":"string","enum":["COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL","CATEGORY_UNSPECIFIED"]},"priceListItemId":{"type":"string"}}},"dimensions":{"type":"object","properties":{"widthPixels":{"type":"integer"},"heightPixels":{"type":"integer"}},"readOnly":true},"attribution":{"type":"object","properties":{"profileName":{"type":"string"},"profilePhotoUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"},"takedownUrl":{"type":"string","format":"uri"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"googleBusinessMediaDelete","summary":"Google Business Profile: Delete a Photos & videos item","tags":["Focus · Google Business Profile"],"description":"Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: `/v1/accounts/{accountId}/focus/media`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_google_business","x-mcp-tool":"google-business-media-delete","x-zernio":["DELETE /v1/accounts/{accountId}/gmb-media"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/media/upload-file":{"post":{"operationId":"googleBusinessMediaUploadFile","summary":"Google Business Profile: Upload file (Photos & videos)","tags":["Focus · Google Business Profile"],"description":"Upload bytes of a Socialit media item (3-step startUpload flow), for files without a public URL. Profile media by category (cover, logo, exterior, interior, product, team, food & drink, menu, rooms, …). Photos: JPG/PNG 10 KB–5 MB, ≥ 250×250. Videos: ≤ 30 s, ≤ 75 MB, ≥ 720p. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string"},"category":{"type":"string","enum":["COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL","CATEGORY_UNSPECIFIED"]},"description":{"type":"string"},"locationId":{"type":"string"}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-media-upload-file","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/customer-media":{"get":{"operationId":"googleBusinessCustomerMediaList","summary":"Google Business Profile: List Customer photos","tags":["Focus · Google Business Profile"],"description":"Photos and videos added by Google Maps users (read-only; new ones arrive via the NEW_CUSTOMER_MEDIA notification). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media.customers Generic route: `/v1/accounts/{accountId}/focus/customer-media`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"integer"},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string"},"in":"query","name":"pageToken","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-customer-media-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"sourceUrl":{"type":"string","format":"uri","description":"Public URL Google fetches (immutable)"},"googleUrl":{"type":"string","format":"uri","readOnly":true},"thumbnailUrl":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","description":"Create only; not allowed on COVER"},"createTime":{"type":"string","format":"date-time","readOnly":true},"locationAssociation":{"type":"object","properties":{"category":{"type":"string","enum":["COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL","CATEGORY_UNSPECIFIED"]},"priceListItemId":{"type":"string"}}},"dimensions":{"type":"object","properties":{"widthPixels":{"type":"integer"},"heightPixels":{"type":"integer"}},"readOnly":true},"attribution":{"type":"object","properties":{"profileName":{"type":"string"},"profilePhotoUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"},"takedownUrl":{"type":"string","format":"uri"}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/customer-media/{itemId}":{"get":{"operationId":"googleBusinessCustomerMediaGet","summary":"Google Business Profile: Get a Customer photos item","tags":["Focus · Google Business Profile"],"description":"Photos and videos added by Google Maps users (read-only; new ones arrive via the NEW_CUSTOMER_MEDIA notification). Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.media.customers Generic route: `/v1/accounts/{accountId}/focus/customer-media`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-customer-media-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"mediaFormat":{"type":"string","enum":["PHOTO","VIDEO"]},"sourceUrl":{"type":"string","format":"uri","description":"Public URL Google fetches (immutable)"},"googleUrl":{"type":"string","format":"uri","readOnly":true},"thumbnailUrl":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","description":"Create only; not allowed on COVER"},"createTime":{"type":"string","format":"date-time","readOnly":true},"locationAssociation":{"type":"object","properties":{"category":{"type":"string","enum":["COVER","PROFILE","LOGO","EXTERIOR","INTERIOR","PRODUCT","AT_WORK","FOOD_AND_DRINK","MENU","COMMON_AREA","ROOMS","TEAMS","ADDITIONAL","CATEGORY_UNSPECIFIED"]},"priceListItemId":{"type":"string"}}},"dimensions":{"type":"object","properties":{"widthPixels":{"type":"integer"},"heightPixels":{"type":"integer"}},"readOnly":true},"attribution":{"type":"object","properties":{"profileName":{"type":"string"},"profilePhotoUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"},"takedownUrl":{"type":"string","format":"uri"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/reviews":{"get":{"operationId":"googleBusinessReviewsList","summary":"Google Business Profile: List Reviews","tags":["Focus · Google Business Profile"],"description":"Customer reviews with filters (rating range, unreplied). One owner reply per review: replying again overwrites it. The location must be verified to reply. Reviews cannot be deleted via the API. Automated or AI review replies need the user's prior, specific and express opt-in, per location, with an audit log. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews Generic route: `/v1/accounts/{accountId}/focus/reviews`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"integer","minimum":1,"maximum":5},"in":"query","name":"minRating","required":false},{"schema":{"type":"integer","minimum":1,"maximum":5},"in":"query","name":"maxRating","required":false},{"schema":{"type":"boolean"},"in":"query","name":"hasReply","required":false,"description":"false = unreplied only"},{"schema":{"type":"string","enum":["date","rating"]},"in":"query","name":"sortBy","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"sortOrder","required":false},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-reviews-list","x-zernio":["GET /v1/accounts/{accountId}/gmb-reviews","GET /v1/inbox/reviews"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"rating":{"type":"integer","minimum":1,"maximum":5,"readOnly":true},"starRating":{"type":"string","enum":["ONE","TWO","THREE","FOUR","FIVE"],"readOnly":true},"text":{"type":"string","readOnly":true},"text_translated":{"type":"string","readOnly":true},"text_original":{"type":"string","readOnly":true},"author":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"author_is_anonymous":{"type":"boolean","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true},"reply":{"type":"string","description":"Owner reply (≤ 4096 bytes)"},"has_reply":{"type":"boolean","readOnly":true},"reply_updated_at":{"type":"string","format":"date-time","readOnly":true},"reply_state":{"type":"string","enum":["PENDING","APPROVED","REJECTED"],"readOnly":true},"reply_policy_violation":{"type":"object","properties":{},"readOnly":true},"reply_url":{"type":"string","format":"uri","readOnly":true},"has_photos":{"type":"boolean","readOnly":true},"photo_count":{"type":"integer","readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"thumbnail_url":{"type":"string","format":"uri"}}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/reviews/{itemId}":{"get":{"operationId":"googleBusinessReviewsGet","summary":"Google Business Profile: Get a Reviews item","tags":["Focus · Google Business Profile"],"description":"Customer reviews with filters (rating range, unreplied). One owner reply per review: replying again overwrites it. The location must be verified to reply. Reviews cannot be deleted via the API. Automated or AI review replies need the user's prior, specific and express opt-in, per location, with an audit log. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews Generic route: `/v1/accounts/{accountId}/focus/reviews`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-reviews-get","x-zernio":["GET /v1/accounts/{accountId}/gmb-reviews/{reviewId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"rating":{"type":"integer","minimum":1,"maximum":5,"readOnly":true},"starRating":{"type":"string","enum":["ONE","TWO","THREE","FOUR","FIVE"],"readOnly":true},"text":{"type":"string","readOnly":true},"text_translated":{"type":"string","readOnly":true},"text_original":{"type":"string","readOnly":true},"author":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"author_is_anonymous":{"type":"boolean","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true},"reply":{"type":"string","description":"Owner reply (≤ 4096 bytes)"},"has_reply":{"type":"boolean","readOnly":true},"reply_updated_at":{"type":"string","format":"date-time","readOnly":true},"reply_state":{"type":"string","enum":["PENDING","APPROVED","REJECTED"],"readOnly":true},"reply_policy_violation":{"type":"object","properties":{},"readOnly":true},"reply_url":{"type":"string","format":"uri","readOnly":true},"has_photos":{"type":"boolean","readOnly":true},"photo_count":{"type":"integer","readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"thumbnail_url":{"type":"string","format":"uri"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/reviews/{itemId}/reply":{"post":{"operationId":"googleBusinessReviewsReply","summary":"Google Business Profile: Reply (Reviews)","tags":["Focus · Google Business Profile"],"description":"Create or overwrite the owner reply (≤ 4096 bytes). Automated replies require `automated: true` + `userOptIn: true`. Customer reviews with filters (rating range, unreplied). One owner reply per review: replying again overwrites it. The location must be verified to reply. Reviews cannot be deleted via the API. Automated or AI review replies need the user's prior, specific and express opt-in, per location, with an audit log. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews Generic route: `/v1/accounts/{accountId}/focus/reviews`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","maxLength":4096},"automated":{"type":"boolean","description":"Set by automation / AI flows"},"userOptIn":{"type":"boolean","description":"The user opted in to automated replies for this location"},"locationId":{"type":"string"}},"required":["comment"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-reviews-reply","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-reviews/batch","POST /v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply","DELETE /v1/accounts/{accountId}/gmb-reviews/{reviewId}/reply","POST /v1/inbox/reviews/{reviewId}/reply","DELETE /v1/inbox/reviews/{reviewId}/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/reviews/{itemId}/delete-reply":{"post":{"operationId":"googleBusinessReviewsDeleteReply","summary":"Google Business Profile: Delete reply (Reviews)","tags":["Focus · Google Business Profile"],"description":"Delete reply. Customer reviews with filters (rating range, unreplied). One owner reply per review: replying again overwrites it. The location must be verified to reply. Reviews cannot be deleted via the API. Automated or AI review replies need the user's prior, specific and express opt-in, per location, with an audit log. Destructive. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews Generic route: `/v1/accounts/{accountId}/focus/reviews`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locationId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_google_business","x-mcp-tool":"google-business-reviews-delete-reply","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/reviews/batch":{"post":{"operationId":"googleBusinessReviewsBatch","summary":"Google Business Profile: Reviews across locations (Reviews)","tags":["Focus · Google Business Profile"],"description":"Up to 50 locations of one Google account (Zernio POST gmb-reviews/batch). Customer reviews with filters (rating range, unreplied). One owner reply per review: replying again overwrites it. The location must be verified to reply. Reviews cannot be deleted via the API. Automated or AI review replies need the user's prior, specific and express opt-in, per location, with an audit log. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations.reviews Generic route: `/v1/accounts/{accountId}/focus/reviews`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locationNames":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":50},"googleAccountId":{"type":"string"},"pageSize":{"type":"integer","maximum":50},"pageToken":{"type":"string"},"orderBy":{"type":"string","enum":["updateTime desc","rating","rating desc"]},"ignoreRatingOnlyReviews":{"type":"boolean"}},"required":["locationNames"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-reviews-batch","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/performance":{"get":{"operationId":"googleBusinessPerformanceList","summary":"Google Business Profile: List Performance","tags":["Focus · Google Business Profile"],"description":"Daily impressions (Search/Maps × desktop/mobile), calls, website clicks, direction requests, bookings and menu clicks. Unique users per day; ~18 months of history; 2-3 day delay. BUSINESS_CONVERSATIONS and BUSINESS_FOOD_ORDERS are deprecated. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/performance/rest/v1/locations/fetchMultiDailyMetricsTimeSeries Generic route: `/v1/accounts/{accountId}/focus/performance`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"fromDate","required":false,"description":"Default: 30 days ago"},{"schema":{"type":"string","format":"date"},"in":"query","name":"toDate","required":false,"description":"Default: today (data lags 2-3 days)"},{"schema":{"type":"array","items":{"type":"string","enum":["BUSINESS_IMPRESSIONS_DESKTOP_MAPS","BUSINESS_IMPRESSIONS_DESKTOP_SEARCH","BUSINESS_IMPRESSIONS_MOBILE_MAPS","BUSINESS_IMPRESSIONS_MOBILE_SEARCH","BUSINESS_DIRECTION_REQUESTS","CALL_CLICKS","WEBSITE_CLICKS","BUSINESS_BOOKINGS","BUSINESS_FOOD_MENU_CLICKS","BUSINESS_CONVERSATIONS","BUSINESS_FOOD_ORDERS"]},"default":["BUSINESS_IMPRESSIONS_DESKTOP_MAPS","BUSINESS_IMPRESSIONS_DESKTOP_SEARCH","BUSINESS_IMPRESSIONS_MOBILE_MAPS","BUSINESS_IMPRESSIONS_MOBILE_SEARCH","BUSINESS_DIRECTION_REQUESTS","CALL_CLICKS","WEBSITE_CLICKS","BUSINESS_BOOKINGS","BUSINESS_FOOD_MENU_CLICKS"]},"in":"query","name":"metrics","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-performance-list","x-zernio":["GET /v1/analytics/googlebusiness/performance"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"date":{"type":"string","format":"date"},"BUSINESS_IMPRESSIONS_DESKTOP_MAPS":{"type":"integer"},"BUSINESS_IMPRESSIONS_DESKTOP_SEARCH":{"type":"integer"},"BUSINESS_IMPRESSIONS_MOBILE_MAPS":{"type":"integer"},"BUSINESS_IMPRESSIONS_MOBILE_SEARCH":{"type":"integer"},"BUSINESS_DIRECTION_REQUESTS":{"type":"integer"},"CALL_CLICKS":{"type":"integer"},"WEBSITE_CLICKS":{"type":"integer"},"BUSINESS_BOOKINGS":{"type":"integer"},"BUSINESS_FOOD_MENU_CLICKS":{"type":"integer"},"BUSINESS_CONVERSATIONS":{"type":"integer"},"BUSINESS_FOOD_ORDERS":{"type":"integer"},"impressions":{"type":"integer","description":"Σ impressions (maps + search, desktop + mobile)"},"interactions":{"type":"integer","description":"calls + website + directions + bookings + menu clicks"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/search-keywords":{"get":{"operationId":"googleBusinessSearchKeywordsList","summary":"Google Business Profile: List Search keywords","tags":["Focus · Google Business Profile"],"description":"Monthly search terms that showed this profile (unique users). Low-volume terms come back as thresholds (\"< N\"). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/performance/rest/v1/locations.searchkeywords.impressions.monthly/list Generic route: `/v1/accounts/{accountId}/focus/search-keywords`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string"},"in":"query","name":"startMonth","required":false,"description":"YYYY-MM (default: 3 months ago)"},{"schema":{"type":"string"},"in":"query","name":"endMonth","required":false,"description":"YYYY-MM (default: last month)"},{"schema":{"type":"string"},"in":"query","name":"pageToken","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-search-keywords-list","x-zernio":["GET /v1/analytics/googlebusiness/search-keywords"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"impressions":{"type":"integer"},"threshold":{"type":"boolean","description":"impressions is an upper bound"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/metric-breakdown":{"get":{"operationId":"googleBusinessMetricBreakdownList","summary":"Google Business Profile: List Metric breakdown","tags":["Focus · Google Business Profile"],"description":"One daily metric, optionally for a single weekday or hour of the day. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/performance/rest/v1/locations/getDailyMetricsTimeSeries Generic route: `/v1/accounts/{accountId}/focus/metric-breakdown`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"fromDate","required":false,"description":"Default: 30 days ago"},{"schema":{"type":"string","format":"date"},"in":"query","name":"toDate","required":false,"description":"Default: today (data lags 2-3 days)"},{"schema":{"type":"string","enum":["BUSINESS_IMPRESSIONS_DESKTOP_MAPS","BUSINESS_IMPRESSIONS_DESKTOP_SEARCH","BUSINESS_IMPRESSIONS_MOBILE_MAPS","BUSINESS_IMPRESSIONS_MOBILE_SEARCH","BUSINESS_DIRECTION_REQUESTS","CALL_CLICKS","WEBSITE_CLICKS","BUSINESS_BOOKINGS","BUSINESS_FOOD_MENU_CLICKS","BUSINESS_CONVERSATIONS","BUSINESS_FOOD_ORDERS"]},"in":"query","name":"metric","required":true},{"schema":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"in":"query","name":"dayOfWeek","required":false},{"schema":{"type":"integer","minimum":0,"maximum":23},"in":"query","name":"hour","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-metric-breakdown-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"value":{"type":"integer"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/food-menus":{"get":{"operationId":"googleBusinessFoodMenusGet","summary":"Google Business Profile: Get Menu","tags":["Focus · Google Business Profile"],"description":"Structured food menus (sections, items, prices, dietary restrictions, allergens, spiciness). Only for menu-capable locations (metadata.canHaveFoodMenus). Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations/getFoodMenus Generic route: `/v1/accounts/{accountId}/focus/food-menus`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-food-menus-get","x-zernio":["GET /v1/accounts/{accountId}/gmb-food-menus"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"menus":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"sourceUrl":{"type":"string","format":"uri"},"cuisines":{"type":"array","items":{"type":"string"}},"sections":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"items":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"attributes":{"type":"object","properties":{"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}},"spiciness":{"type":"string","enum":["MILD","MEDIUM","HOT"]},"allergen":{"type":"array","items":{"type":"string","enum":["DAIRY","EGG","FISH","PEANUT","SHELLFISH","SOY","TREE_NUT","WHEAT"]}},"dietaryRestriction":{"type":"array","items":{"type":"string","enum":["DAIRY_FREE","GLUTEN_FREE","HALAL","KOSHER","ORGANIC","VEGAN","VEGETARIAN"]}},"servesNumPeople":{"type":"integer","minimum":1},"preparationMethods":{"type":"array","items":{"type":"string"}},"mediaKeys":{"type":"array","items":{"type":"string"}},"nutritionFacts":{"type":"object","properties":{}},"ingredients":{"type":"array","items":{"type":"object","properties":{}}},"portionSize":{"type":"object","properties":{}}}},"options":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"attributes":{"type":"object","properties":{"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}},"spiciness":{"type":"string","enum":["MILD","MEDIUM","HOT"]},"allergen":{"type":"array","items":{"type":"string","enum":["DAIRY","EGG","FISH","PEANUT","SHELLFISH","SOY","TREE_NUT","WHEAT"]}},"dietaryRestriction":{"type":"array","items":{"type":"string","enum":["DAIRY_FREE","GLUTEN_FREE","HALAL","KOSHER","ORGANIC","VEGAN","VEGETARIAN"]}},"servesNumPeople":{"type":"integer","minimum":1},"preparationMethods":{"type":"array","items":{"type":"string"}},"mediaKeys":{"type":"array","items":{"type":"string"}},"nutritionFacts":{"type":"object","properties":{}},"ingredients":{"type":"array","items":{"type":"object","properties":{}}},"portionSize":{"type":"object","properties":{}}}}}}}}}}}}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"googleBusinessFoodMenusUpdate","summary":"Google Business Profile: Update Menu","tags":["Focus · Google Business Profile"],"description":"Structured food menus (sections, items, prices, dietary restrictions, allergens, spiciness). Only for menu-capable locations (metadata.canHaveFoodMenus). Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/rest/v4/accounts.locations/getFoodMenus Generic route: `/v1/accounts/{accountId}/focus/food-menus`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"menus":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"sourceUrl":{"type":"string","format":"uri"},"cuisines":{"type":"array","items":{"type":"string"}},"sections":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"items":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"attributes":{"type":"object","properties":{"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}},"spiciness":{"type":"string","enum":["MILD","MEDIUM","HOT"]},"allergen":{"type":"array","items":{"type":"string","enum":["DAIRY","EGG","FISH","PEANUT","SHELLFISH","SOY","TREE_NUT","WHEAT"]}},"dietaryRestriction":{"type":"array","items":{"type":"string","enum":["DAIRY_FREE","GLUTEN_FREE","HALAL","KOSHER","ORGANIC","VEGAN","VEGETARIAN"]}},"servesNumPeople":{"type":"integer","minimum":1},"preparationMethods":{"type":"array","items":{"type":"string"}},"mediaKeys":{"type":"array","items":{"type":"string"}},"nutritionFacts":{"type":"object","properties":{}},"ingredients":{"type":"array","items":{"type":"object","properties":{}}},"portionSize":{"type":"object","properties":{}}}},"options":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"attributes":{"type":"object","properties":{"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}},"spiciness":{"type":"string","enum":["MILD","MEDIUM","HOT"]},"allergen":{"type":"array","items":{"type":"string","enum":["DAIRY","EGG","FISH","PEANUT","SHELLFISH","SOY","TREE_NUT","WHEAT"]}},"dietaryRestriction":{"type":"array","items":{"type":"string","enum":["DAIRY_FREE","GLUTEN_FREE","HALAL","KOSHER","ORGANIC","VEGAN","VEGETARIAN"]}},"servesNumPeople":{"type":"integer","minimum":1},"preparationMethods":{"type":"array","items":{"type":"string"}},"mediaKeys":{"type":"array","items":{"type":"string"}},"nutritionFacts":{"type":"object","properties":{}},"ingredients":{"type":"array","items":{"type":"object","properties":{}}},"portionSize":{"type":"object","properties":{}}}}}}}}}}}}}}}},"updateMask":{"type":"string","default":"menus"},"locationId":{"type":"string"}},"required":["menus"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-food-menus-update","x-zernio":["PUT /v1/accounts/{accountId}/gmb-food-menus"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"menus":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"sourceUrl":{"type":"string","format":"uri"},"cuisines":{"type":"array","items":{"type":"string"}},"sections":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"items":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"attributes":{"type":"object","properties":{"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}},"spiciness":{"type":"string","enum":["MILD","MEDIUM","HOT"]},"allergen":{"type":"array","items":{"type":"string","enum":["DAIRY","EGG","FISH","PEANUT","SHELLFISH","SOY","TREE_NUT","WHEAT"]}},"dietaryRestriction":{"type":"array","items":{"type":"string","enum":["DAIRY_FREE","GLUTEN_FREE","HALAL","KOSHER","ORGANIC","VEGAN","VEGETARIAN"]}},"servesNumPeople":{"type":"integer","minimum":1},"preparationMethods":{"type":"array","items":{"type":"string"}},"mediaKeys":{"type":"array","items":{"type":"string"}},"nutritionFacts":{"type":"object","properties":{}},"ingredients":{"type":"array","items":{"type":"object","properties":{}}},"portionSize":{"type":"object","properties":{}}}},"options":{"type":"array","items":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":1000},"languageCode":{"type":"string"}}}},"attributes":{"type":"object","properties":{"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}},"spiciness":{"type":"string","enum":["MILD","MEDIUM","HOT"]},"allergen":{"type":"array","items":{"type":"string","enum":["DAIRY","EGG","FISH","PEANUT","SHELLFISH","SOY","TREE_NUT","WHEAT"]}},"dietaryRestriction":{"type":"array","items":{"type":"string","enum":["DAIRY_FREE","GLUTEN_FREE","HALAL","KOSHER","ORGANIC","VEGAN","VEGETARIAN"]}},"servesNumPeople":{"type":"integer","minimum":1},"preparationMethods":{"type":"array","items":{"type":"string"}},"mediaKeys":{"type":"array","items":{"type":"string"}},"nutritionFacts":{"type":"object","properties":{}},"ingredients":{"type":"array","items":{"type":"object","properties":{}}},"portionSize":{"type":"object","properties":{}}}}}}}}}}}}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/services":{"get":{"operationId":"googleBusinessServicesList","summary":"Google Business Profile: List Services","tags":["Focus · Google Business Profile"],"description":"Services offered: structured (Google service types of your categories) or free-form, with optional price. Google stores them as one list: every change replaces the whole list. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#ServiceItem Generic route: `/v1/accounts/{accountId}/focus/services`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-services-list","x-zernio":["GET /v1/accounts/{accountId}/gmb-services"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"structuredServiceItem":{"type":"object","properties":{"serviceTypeId":{"type":"string"},"description":{"type":"string","maxLength":300}}},"freeFormServiceItem":{"type":"object","properties":{"category":{"type":"string","description":"categories/gcid:…"},"label":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":250},"languageCode":{"type":"string"}}}}},"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"googleBusinessServicesCreate","summary":"Google Business Profile: Create a Services item","tags":["Focus · Google Business Profile"],"description":"Append a service. Services offered: structured (Google service types of your categories) or free-form, with optional price. Google stores them as one list: every change replaces the whole list. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#ServiceItem Generic route: `/v1/accounts/{accountId}/focus/services`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"structuredServiceItem":{"type":"object","properties":{"serviceTypeId":{"type":"string"},"description":{"type":"string","maxLength":300}}},"freeFormServiceItem":{"type":"object","properties":{"category":{"type":"string","description":"categories/gcid:…"},"label":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":250},"languageCode":{"type":"string"}}}}},"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_google_business","x-mcp-tool":"google-business-services-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"structuredServiceItem":{"type":"object","properties":{"serviceTypeId":{"type":"string"},"description":{"type":"string","maxLength":300}}},"freeFormServiceItem":{"type":"object","properties":{"category":{"type":"string","description":"categories/gcid:…"},"label":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":250},"languageCode":{"type":"string"}}}}},"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/services/{itemId}":{"patch":{"operationId":"googleBusinessServicesUpdate","summary":"Google Business Profile: Update a Services item","tags":["Focus · Google Business Profile"],"description":"Services offered: structured (Google service types of your categories) or free-form, with optional price. Google stores them as one list: every change replaces the whole list. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#ServiceItem Generic route: `/v1/accounts/{accountId}/focus/services`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"structuredServiceItem":{"type":"object","properties":{"serviceTypeId":{"type":"string"},"description":{"type":"string","maxLength":300}}},"freeFormServiceItem":{"type":"object","properties":{"category":{"type":"string","description":"categories/gcid:…"},"label":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":250},"languageCode":{"type":"string"}}}}},"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-services-update","x-zernio":["PUT /v1/accounts/{accountId}/gmb-services"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"structuredServiceItem":{"type":"object","properties":{"serviceTypeId":{"type":"string"},"description":{"type":"string","maxLength":300}}},"freeFormServiceItem":{"type":"object","properties":{"category":{"type":"string","description":"categories/gcid:…"},"label":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":250},"languageCode":{"type":"string"}}}}},"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"googleBusinessServicesDelete","summary":"Google Business Profile: Delete a Services item","tags":["Focus · Google Business Profile"],"description":"Services offered: structured (Google service types of your categories) or free-form, with optional price. Google stores them as one list: every change replaces the whole list. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#ServiceItem Generic route: `/v1/accounts/{accountId}/focus/services`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_google_business","x-mcp-tool":"google-business-services-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/services/replace":{"post":{"operationId":"googleBusinessServicesReplace","summary":"Google Business Profile: Replace all services (Services)","tags":["Focus · Google Business Profile"],"description":"Zernio PUT gmb-services (full-list replace). Services offered: structured (Google service types of your categories) or free-form, with optional price. Google stores them as one list: every change replaces the whole list. Destructive. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#ServiceItem Generic route: `/v1/accounts/{accountId}/focus/services`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"serviceItems":{"type":"array","items":{"type":"object","properties":{"structuredServiceItem":{"type":"object","properties":{"serviceTypeId":{"type":"string"},"description":{"type":"string","maxLength":300}}},"freeFormServiceItem":{"type":"object","properties":{"category":{"type":"string","description":"categories/gcid:…"},"label":{"type":"object","properties":{"displayName":{"type":"string","maxLength":140},"description":{"type":"string","maxLength":250},"languageCode":{"type":"string"}}}}},"price":{"type":"object","properties":{"currencyCode":{"type":"string","maxLength":3},"units":{"type":"string"},"nanos":{"type":"integer"}}}}}},"locationId":{"type":"string"}},"required":["serviceItems"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_google_business","x-mcp-tool":"google-business-services-replace","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/place-action-links":{"get":{"operationId":"googleBusinessPlaceActionLinksList","summary":"Google Business Profile: List Action links","tags":["Focus · Google Business Profile"],"description":"Booking, ordering, reservation and shop links on the profile. Links from third-party providers are read-only. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/locations.placeActionLinks Generic route: `/v1/accounts/{accountId}/focus/place-action-links`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string","enum":["APPOINTMENT","ONLINE_APPOINTMENT","DINING_RESERVATION","FOOD_ORDERING","FOOD_DELIVERY","FOOD_TAKEOUT","SHOP_ONLINE","SOLOPRENEUR_APPOINTMENT"]},"in":"query","name":"placeActionType","required":false},{"schema":{"type":"integer"},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string"},"in":"query","name":"pageToken","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-place-action-links-list","x-zernio":["GET /v1/accounts/{accountId}/gmb-place-actions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"placeActionType":{"type":"string","enum":["APPOINTMENT","ONLINE_APPOINTMENT","DINING_RESERVATION","FOOD_ORDERING","FOOD_DELIVERY","FOOD_TAKEOUT","SHOP_ONLINE","SOLOPRENEUR_APPOINTMENT"]},"isPreferred":{"type":"boolean"},"isEditable":{"type":"boolean","readOnly":true},"providerType":{"type":"string","enum":["MERCHANT","AGGREGATOR_3P"],"readOnly":true},"createTime":{"type":"string","format":"date-time","readOnly":true},"updateTime":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"googleBusinessPlaceActionLinksCreate","summary":"Google Business Profile: Create a Action links item","tags":["Focus · Google Business Profile"],"description":"Booking, ordering, reservation and shop links on the profile. Links from third-party providers are read-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/locations.placeActionLinks Generic route: `/v1/accounts/{accountId}/focus/place-action-links`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string","format":"uri"},"placeActionType":{"type":"string","enum":["APPOINTMENT","ONLINE_APPOINTMENT","DINING_RESERVATION","FOOD_ORDERING","FOOD_DELIVERY","FOOD_TAKEOUT","SHOP_ONLINE","SOLOPRENEUR_APPOINTMENT"]},"isPreferred":{"type":"boolean"},"locationId":{"type":"string"}},"required":["uri","placeActionType"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_google_business","x-mcp-tool":"google-business-place-action-links-create","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-place-actions"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"placeActionType":{"type":"string","enum":["APPOINTMENT","ONLINE_APPOINTMENT","DINING_RESERVATION","FOOD_ORDERING","FOOD_DELIVERY","FOOD_TAKEOUT","SHOP_ONLINE","SOLOPRENEUR_APPOINTMENT"]},"isPreferred":{"type":"boolean"},"isEditable":{"type":"boolean","readOnly":true},"providerType":{"type":"string","enum":["MERCHANT","AGGREGATOR_3P"],"readOnly":true},"createTime":{"type":"string","format":"date-time","readOnly":true},"updateTime":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/place-action-links/{itemId}":{"get":{"operationId":"googleBusinessPlaceActionLinksGet","summary":"Google Business Profile: Get a Action links item","tags":["Focus · Google Business Profile"],"description":"Booking, ordering, reservation and shop links on the profile. Links from third-party providers are read-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/locations.placeActionLinks Generic route: `/v1/accounts/{accountId}/focus/place-action-links`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-place-action-links-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"placeActionType":{"type":"string","enum":["APPOINTMENT","ONLINE_APPOINTMENT","DINING_RESERVATION","FOOD_ORDERING","FOOD_DELIVERY","FOOD_TAKEOUT","SHOP_ONLINE","SOLOPRENEUR_APPOINTMENT"]},"isPreferred":{"type":"boolean"},"isEditable":{"type":"boolean","readOnly":true},"providerType":{"type":"string","enum":["MERCHANT","AGGREGATOR_3P"],"readOnly":true},"createTime":{"type":"string","format":"date-time","readOnly":true},"updateTime":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"googleBusinessPlaceActionLinksUpdate","summary":"Google Business Profile: Update a Action links item","tags":["Focus · Google Business Profile"],"description":"Booking, ordering, reservation and shop links on the profile. Links from third-party providers are read-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/locations.placeActionLinks Generic route: `/v1/accounts/{accountId}/focus/place-action-links`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uri":{"type":"string","format":"uri"},"placeActionType":{"type":"string","enum":["APPOINTMENT","ONLINE_APPOINTMENT","DINING_RESERVATION","FOOD_ORDERING","FOOD_DELIVERY","FOOD_TAKEOUT","SHOP_ONLINE","SOLOPRENEUR_APPOINTMENT"]},"isPreferred":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-place-action-links-update","x-zernio":["PATCH /v1/accounts/{accountId}/gmb-place-actions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"placeActionType":{"type":"string","enum":["APPOINTMENT","ONLINE_APPOINTMENT","DINING_RESERVATION","FOOD_ORDERING","FOOD_DELIVERY","FOOD_TAKEOUT","SHOP_ONLINE","SOLOPRENEUR_APPOINTMENT"]},"isPreferred":{"type":"boolean"},"isEditable":{"type":"boolean","readOnly":true},"providerType":{"type":"string","enum":["MERCHANT","AGGREGATOR_3P"],"readOnly":true},"createTime":{"type":"string","format":"date-time","readOnly":true},"updateTime":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"googleBusinessPlaceActionLinksDelete","summary":"Google Business Profile: Delete a Action links item","tags":["Focus · Google Business Profile"],"description":"Booking, ordering, reservation and shop links on the profile. Links from third-party providers are read-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/locations.placeActionLinks Generic route: `/v1/accounts/{accountId}/focus/place-action-links`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_google_business","x-mcp-tool":"google-business-place-action-links-delete","x-zernio":["DELETE /v1/accounts/{accountId}/gmb-place-actions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/place-action-types":{"get":{"operationId":"googleBusinessPlaceActionTypesList","summary":"Google Business Profile: List Action link types","tags":["Focus · Google Business Profile"],"description":"Action link types available for this location or a region. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/placeactions/rest/v1/placeActionTypeMetadata/list Generic route: `/v1/accounts/{accountId}/focus/place-action-types`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string"},"in":"query","name":"regionCode","required":false},{"schema":{"type":"string"},"in":"query","name":"languageCode","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-place-action-types-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"placeActionType":{"type":"string","enum":["APPOINTMENT","ONLINE_APPOINTMENT","DINING_RESERVATION","FOOD_ORDERING","FOOD_DELIVERY","FOOD_TAKEOUT","SHOP_ONLINE","SOLOPRENEUR_APPOINTMENT"]},"displayName":{"type":"string"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/lodging":{"get":{"operationId":"googleBusinessLodgingGet","summary":"Google Business Profile: Get Hotel details","tags":["Focus · Google Business Profile"],"description":"Lodging attributes for hotels (metadata.canOperateLodgingData): property, policies, pools, wellness, food & drink, accessibility, connectivity, guest units, sustainability, …. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/lodging/rest/v1/locations.lodging Generic route: `/v1/accounts/{accountId}/focus/lodging`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string","default":"*"},"in":"query","name":"readMask","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-lodging-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"property":{"type":"object","properties":{},"additionalProperties":true},"services":{"type":"object","properties":{},"additionalProperties":true},"policies":{"type":"object","properties":{},"additionalProperties":true},"foodAndDrink":{"type":"object","properties":{},"additionalProperties":true},"pools":{"type":"object","properties":{},"additionalProperties":true},"wellness":{"type":"object","properties":{},"additionalProperties":true},"activities":{"type":"object","properties":{},"additionalProperties":true},"transportation":{"type":"object","properties":{},"additionalProperties":true},"families":{"type":"object","properties":{},"additionalProperties":true},"connectivity":{"type":"object","properties":{},"additionalProperties":true},"business":{"type":"object","properties":{},"additionalProperties":true},"accessibility":{"type":"object","properties":{},"additionalProperties":true},"housekeeping":{"type":"object","properties":{},"additionalProperties":true},"healthAndSafety":{"type":"object","properties":{},"additionalProperties":true},"parking":{"type":"object","properties":{},"additionalProperties":true},"pets":{"type":"object","properties":{},"additionalProperties":true},"sustainability":{"type":"object","properties":{},"additionalProperties":true},"commonLivingArea":{"type":"object","properties":{},"additionalProperties":true},"guestUnits":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"allUnits":{"type":"object","properties":{},"additionalProperties":true,"readOnly":true},"someUnits":{"type":"object","properties":{},"additionalProperties":true,"readOnly":true},"metadata":{"type":"object","properties":{"updateTime":{"type":"string","format":"date-time"}},"readOnly":true},"name":{"type":"string","readOnly":true},"id":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"googleBusinessLodgingUpdate","summary":"Google Business Profile: Update Hotel details","tags":["Focus · Google Business Profile"],"description":"Lodging attributes for hotels (metadata.canOperateLodgingData): property, policies, pools, wellness, food & drink, accessibility, connectivity, guest units, sustainability, …. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/lodging/rest/v1/locations.lodging Generic route: `/v1/accounts/{accountId}/focus/lodging`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lodging":{"type":"object","properties":{},"additionalProperties":true},"updateMask":{"type":"string"},"locationId":{"type":"string"}},"required":["lodging"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-lodging-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"property":{"type":"object","properties":{},"additionalProperties":true},"services":{"type":"object","properties":{},"additionalProperties":true},"policies":{"type":"object","properties":{},"additionalProperties":true},"foodAndDrink":{"type":"object","properties":{},"additionalProperties":true},"pools":{"type":"object","properties":{},"additionalProperties":true},"wellness":{"type":"object","properties":{},"additionalProperties":true},"activities":{"type":"object","properties":{},"additionalProperties":true},"transportation":{"type":"object","properties":{},"additionalProperties":true},"families":{"type":"object","properties":{},"additionalProperties":true},"connectivity":{"type":"object","properties":{},"additionalProperties":true},"business":{"type":"object","properties":{},"additionalProperties":true},"accessibility":{"type":"object","properties":{},"additionalProperties":true},"housekeeping":{"type":"object","properties":{},"additionalProperties":true},"healthAndSafety":{"type":"object","properties":{},"additionalProperties":true},"parking":{"type":"object","properties":{},"additionalProperties":true},"pets":{"type":"object","properties":{},"additionalProperties":true},"sustainability":{"type":"object","properties":{},"additionalProperties":true},"commonLivingArea":{"type":"object","properties":{},"additionalProperties":true},"guestUnits":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"allUnits":{"type":"object","properties":{},"additionalProperties":true,"readOnly":true},"someUnits":{"type":"object","properties":{},"additionalProperties":true,"readOnly":true},"metadata":{"type":"object","properties":{"updateTime":{"type":"string","format":"date-time"}},"readOnly":true},"name":{"type":"string","readOnly":true},"id":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/lodging/google-updated":{"post":{"operationId":"googleBusinessLodgingGoogleUpdated","summary":"Google Business Profile: Google-updated values (Hotel details)","tags":["Focus · Google Business Profile"],"description":"Google-updated values. Lodging attributes for hotels (metadata.canOperateLodgingData): property, policies, pools, wellness, food & drink, accessibility, connectivity, guest units, sustainability, …. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/lodging/rest/v1/locations.lodging Generic route: `/v1/accounts/{accountId}/focus/lodging`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locationId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-lodging-google-updated","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/verifications":{"get":{"operationId":"googleBusinessVerificationsList","summary":"Google Business Profile: List Verifications","tags":["Focus · Google Business Profile"],"description":"Verify the location: fetch available methods, start (postcard, phone call, SMS, email, auto) and complete with the PIN. Service-area businesses must pass their address as context. Video verification is UI-only. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/verifications/rest Generic route: `/v1/accounts/{accountId}/focus/verifications`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"integer"},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string"},"in":"query","name":"pageToken","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-verifications-list","x-zernio":["GET /v1/accounts/{accountId}/gmb-verifications"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"method":{"type":"string","enum":["ADDRESS","EMAIL","PHONE_CALL","SMS","AUTO","TRUSTED_PARTNER"]},"state":{"type":"string","enum":["PENDING","COMPLETED","FAILED"]},"createTime":{"type":"string","format":"date-time"},"announcement":{"type":"string"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"googleBusinessVerificationsCreate","summary":"Google Business Profile: Create a Verifications item","tags":["Focus · Google Business Profile"],"description":"Start a verification. Verify the location: fetch available methods, start (postcard, phone call, SMS, email, auto) and complete with the PIN. Service-area businesses must pass their address as context. Video verification is UI-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/verifications/rest Generic route: `/v1/accounts/{accountId}/focus/verifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"method":{"type":"string","enum":["ADDRESS","EMAIL","PHONE_CALL","SMS","AUTO","TRUSTED_PARTNER"]},"languageCode":{"type":"string","default":"en"},"phoneNumber":{"type":"string","description":"PHONE_CALL / SMS"},"emailAddress":{"type":"string","description":"EMAIL"},"mailerContact":{"type":"string","description":"ADDRESS: name on the postcard"},"trustedPartnerToken":{"type":"string"},"context":{"type":"object","properties":{"address":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}}}}},"locationId":{"type":"string"}},"required":["method"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_google_business","x-mcp-tool":"google-business-verifications-create","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/gmb-verifications/options","POST /v1/accounts/{accountId}/gmb-verifications","POST /v1/accounts/{accountId}/gmb-verifications/{verificationId}/complete"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"method":{"type":"string","enum":["ADDRESS","EMAIL","PHONE_CALL","SMS","AUTO","TRUSTED_PARTNER"]},"state":{"type":"string","enum":["PENDING","COMPLETED","FAILED"]},"createTime":{"type":"string","format":"date-time"},"announcement":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/verifications/options":{"post":{"operationId":"googleBusinessVerificationsOptions","summary":"Google Business Profile: Available methods (Verifications)","tags":["Focus · Google Business Profile"],"description":"Available methods. Verify the location: fetch available methods, start (postcard, phone call, SMS, email, auto) and complete with the PIN. Service-area businesses must pass their address as context. Video verification is UI-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/verifications/rest Generic route: `/v1/accounts/{accountId}/focus/verifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"languageCode":{"type":"string","default":"en"},"context":{"type":"object","properties":{"address":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}}}}},"locationId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-verifications-options","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/verifications/{itemId}/complete":{"post":{"operationId":"googleBusinessVerificationsComplete","summary":"Google Business Profile: Enter PIN (Verifications)","tags":["Focus · Google Business Profile"],"description":"Enter PIN. Verify the location: fetch available methods, start (postcard, phone call, SMS, email, auto) and complete with the PIN. Service-area businesses must pass their address as context. Video verification is UI-only. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/verifications/rest Generic route: `/v1/accounts/{accountId}/focus/verifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pin":{"type":"string"},"locationId":{"type":"string"}},"required":["pin"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-verifications-complete","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/voice-of-merchant":{"get":{"operationId":"googleBusinessVoiceOfMerchantGet","summary":"Google Business Profile: Get Profile status","tags":["Focus · Google Business Profile"],"description":"Whether edits and posts go live (Voice of Merchant), and what to do otherwise: verify, wait, resolve an ownership conflict, or comply with guidelines (suspended/disabled). Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/verifications/rest/v1/locations/getVoiceOfMerchantState Generic route: `/v1/accounts/{accountId}/focus/voice-of-merchant`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-voice-of-merchant-get","x-zernio":["GET /v1/accounts/{accountId}/gmb-verifications"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"hasVoiceOfMerchant":{"type":"boolean"},"hasBusinessAuthority":{"type":"boolean"},"waitForVoiceOfMerchant":{"type":"object","properties":{}},"verify":{"type":"object","properties":{"hasPendingVerification":{"type":"boolean"}}},"resolveOwnershipConflict":{"type":"object","properties":{}},"complyWithGuidelines":{"type":"object","properties":{"recommendationReason":{"type":"string","enum":["BUSINESS_LOCATION_SUSPENDED","BUSINESS_LOCATION_DISABLED"]}}},"summary":{"type":"object","properties":{"status":{"type":"string","enum":["live","pending_verification","needs_verification","waiting","ownership_conflict","suspended","disabled","unknown"]},"canEdit":{"type":"boolean"},"message":{"type":"string"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/accounts":{"get":{"operationId":"googleBusinessAccountsList","summary":"Google Business Profile: List Business accounts","tags":["Focus · Google Business Profile"],"description":"Personal accounts, location groups and organizations this Google login can access. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts Generic route: `/v1/accounts/{accountId}/focus/accounts`.","parameters":[{"schema":{"type":"string","enum":["PERSONAL","LOCATION_GROUP","USER_GROUP","ORGANIZATION"]},"in":"query","name":"type","required":false},{"schema":{"type":"string"},"in":"query","name":"parentAccount","required":false},{"schema":{"type":"integer","maximum":20},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string"},"in":"query","name":"pageToken","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-accounts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"accountName":{"type":"string"},"type":{"type":"string","enum":["PERSONAL","LOCATION_GROUP","USER_GROUP","ORGANIZATION"]},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"],"readOnly":true},"verificationState":{"type":"string","enum":["VERIFIED","UNVERIFIED","VERIFICATION_REQUESTED"],"readOnly":true},"vettedState":{"type":"string","enum":["NOT_VETTED","VETTED","INVALID"],"readOnly":true},"permissionLevel":{"type":"string","enum":["OWNER_LEVEL","MEMBER_LEVEL"],"readOnly":true},"accountNumber":{"type":"string","readOnly":true},"primaryOwner":{"type":"string"},"organizationInfo":{"type":"object","properties":{"registeredDomain":{"type":"string"},"phoneNumber":{"type":"string"},"address":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}}}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"googleBusinessAccountsCreate","summary":"Google Business Profile: Create a Business accounts item","tags":["Focus · Google Business Profile"],"description":"Create a location group. Personal accounts, location groups and organizations this Google login can access. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountName":{"type":"string"},"primaryOwner":{"type":"string","description":"accounts/{id} of the owner"}},"required":["accountName"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_google_business","x-mcp-tool":"google-business-accounts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"accountName":{"type":"string"},"type":{"type":"string","enum":["PERSONAL","LOCATION_GROUP","USER_GROUP","ORGANIZATION"]},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"],"readOnly":true},"verificationState":{"type":"string","enum":["VERIFIED","UNVERIFIED","VERIFICATION_REQUESTED"],"readOnly":true},"vettedState":{"type":"string","enum":["NOT_VETTED","VETTED","INVALID"],"readOnly":true},"permissionLevel":{"type":"string","enum":["OWNER_LEVEL","MEMBER_LEVEL"],"readOnly":true},"accountNumber":{"type":"string","readOnly":true},"primaryOwner":{"type":"string"},"organizationInfo":{"type":"object","properties":{"registeredDomain":{"type":"string"},"phoneNumber":{"type":"string"},"address":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/accounts/{itemId}":{"get":{"operationId":"googleBusinessAccountsGet","summary":"Google Business Profile: Get a Business accounts item","tags":["Focus · Google Business Profile"],"description":"Personal accounts, location groups and organizations this Google login can access. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts Generic route: `/v1/accounts/{accountId}/focus/accounts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-accounts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"accountName":{"type":"string"},"type":{"type":"string","enum":["PERSONAL","LOCATION_GROUP","USER_GROUP","ORGANIZATION"]},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"],"readOnly":true},"verificationState":{"type":"string","enum":["VERIFIED","UNVERIFIED","VERIFICATION_REQUESTED"],"readOnly":true},"vettedState":{"type":"string","enum":["NOT_VETTED","VETTED","INVALID"],"readOnly":true},"permissionLevel":{"type":"string","enum":["OWNER_LEVEL","MEMBER_LEVEL"],"readOnly":true},"accountNumber":{"type":"string","readOnly":true},"primaryOwner":{"type":"string"},"organizationInfo":{"type":"object","properties":{"registeredDomain":{"type":"string"},"phoneNumber":{"type":"string"},"address":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"googleBusinessAccountsUpdate","summary":"Google Business Profile: Update a Business accounts item","tags":["Focus · Google Business Profile"],"description":"Rename (location groups). Personal accounts, location groups and organizations this Google login can access. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountName":{"type":"string"},"validateOnly":{"type":"boolean"}},"required":["accountName"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-accounts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"accountName":{"type":"string"},"type":{"type":"string","enum":["PERSONAL","LOCATION_GROUP","USER_GROUP","ORGANIZATION"]},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"],"readOnly":true},"verificationState":{"type":"string","enum":["VERIFIED","UNVERIFIED","VERIFICATION_REQUESTED"],"readOnly":true},"vettedState":{"type":"string","enum":["NOT_VETTED","VETTED","INVALID"],"readOnly":true},"permissionLevel":{"type":"string","enum":["OWNER_LEVEL","MEMBER_LEVEL"],"readOnly":true},"accountNumber":{"type":"string","readOnly":true},"primaryOwner":{"type":"string"},"organizationInfo":{"type":"object","properties":{"registeredDomain":{"type":"string"},"phoneNumber":{"type":"string"},"address":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/account-admins":{"get":{"operationId":"googleBusinessAccountAdminsList","summary":"Google Business Profile: List Account admins","tags":["Focus · Google Business Profile"],"description":"Owners and managers of a business account. Notify the end client within 48 h of admin/manager changes. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.admins Generic route: `/v1/accounts/{accountId}/focus/account-admins`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"googleAccountId","required":false,"description":"Default: the connection's account"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-account-admins-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"admin":{"type":"string","description":"Invitee email on create; display name afterwards"},"account":{"type":"string","readOnly":true},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"]},"pendingInvitation":{"type":"boolean","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"googleBusinessAccountAdminsCreate","summary":"Google Business Profile: Create a Account admins item","tags":["Focus · Google Business Profile"],"description":"Invite by email. Owners and managers of a business account. Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.admins Generic route: `/v1/accounts/{accountId}/focus/account-admins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"role":{"type":"string","enum":["OWNER","MANAGER"]},"googleAccountId":{"type":"string"}},"required":["email","role"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_google_business","x-mcp-tool":"google-business-account-admins-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"admin":{"type":"string","description":"Invitee email on create; display name afterwards"},"account":{"type":"string","readOnly":true},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"]},"pendingInvitation":{"type":"boolean","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/account-admins/{itemId}":{"patch":{"operationId":"googleBusinessAccountAdminsUpdate","summary":"Google Business Profile: Update a Account admins item","tags":["Focus · Google Business Profile"],"description":"Owners and managers of a business account. Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.admins Generic route: `/v1/accounts/{accountId}/focus/account-admins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"]}},"required":["role"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-account-admins-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"admin":{"type":"string","description":"Invitee email on create; display name afterwards"},"account":{"type":"string","readOnly":true},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"]},"pendingInvitation":{"type":"boolean","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"googleBusinessAccountAdminsDelete","summary":"Google Business Profile: Delete a Account admins item","tags":["Focus · Google Business Profile"],"description":"Owners and managers of a business account. Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.admins Generic route: `/v1/accounts/{accountId}/focus/account-admins`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_google_business","x-mcp-tool":"google-business-account-admins-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/location-admins":{"get":{"operationId":"googleBusinessLocationAdminsList","summary":"Google Business Profile: List Location managers","tags":["Focus · Google Business Profile"],"description":"People who can manage this location (owner, manager, site manager). Notify the end client within 48 h of admin/manager changes. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/locations.admins Generic route: `/v1/accounts/{accountId}/focus/location-admins`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"locationId","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-location-admins-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"admin":{"type":"string","description":"Invitee email on create; display name afterwards"},"account":{"type":"string","readOnly":true},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"]},"pendingInvitation":{"type":"boolean","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"googleBusinessLocationAdminsCreate","summary":"Google Business Profile: Create a Location managers item","tags":["Focus · Google Business Profile"],"description":"Invite by email. People who can manage this location (owner, manager, site manager). Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/locations.admins Generic route: `/v1/accounts/{accountId}/focus/location-admins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"role":{"type":"string","enum":["OWNER","MANAGER","SITE_MANAGER"]},"locationId":{"type":"string"}},"required":["email","role"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_google_business","x-mcp-tool":"google-business-location-admins-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"admin":{"type":"string","description":"Invitee email on create; display name afterwards"},"account":{"type":"string","readOnly":true},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"]},"pendingInvitation":{"type":"boolean","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/location-admins/{itemId}":{"patch":{"operationId":"googleBusinessLocationAdminsUpdate","summary":"Google Business Profile: Update a Location managers item","tags":["Focus · Google Business Profile"],"description":"People who can manage this location (owner, manager, site manager). Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/locations.admins Generic route: `/v1/accounts/{accountId}/focus/location-admins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"]}},"required":["role"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-location-admins-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"admin":{"type":"string","description":"Invitee email on create; display name afterwards"},"account":{"type":"string","readOnly":true},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"]},"pendingInvitation":{"type":"boolean","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"googleBusinessLocationAdminsDelete","summary":"Google Business Profile: Delete a Location managers item","tags":["Focus · Google Business Profile"],"description":"People who can manage this location (owner, manager, site manager). Notify the end client within 48 h of admin/manager changes. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/locations.admins Generic route: `/v1/accounts/{accountId}/focus/location-admins`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_google_business","x-mcp-tool":"google-business-location-admins-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/invitations":{"get":{"operationId":"googleBusinessInvitationsList","summary":"Google Business Profile: List Invitations","tags":["Focus · Google Business Profile"],"description":"Pending invitations for this Google login to manage accounts or locations. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.invitations Generic route: `/v1/accounts/{accountId}/focus/invitations`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"googleAccountId","required":false},{"schema":{"type":"string","enum":["ACCOUNTS_ONLY","LOCATIONS_ONLY"]},"in":"query","name":"targetType","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-invitations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"],"readOnly":true},"targetType":{"type":"string","enum":["ACCOUNTS_ONLY","LOCATIONS_ONLY"],"readOnly":true},"targetAccount":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"accountName":{"type":"string"},"type":{"type":"string","enum":["PERSONAL","LOCATION_GROUP","USER_GROUP","ORGANIZATION"]},"role":{"type":"string","enum":["PRIMARY_OWNER","OWNER","MANAGER","SITE_MANAGER"],"readOnly":true},"verificationState":{"type":"string","enum":["VERIFIED","UNVERIFIED","VERIFICATION_REQUESTED"],"readOnly":true},"vettedState":{"type":"string","enum":["NOT_VETTED","VETTED","INVALID"],"readOnly":true},"permissionLevel":{"type":"string","enum":["OWNER_LEVEL","MEMBER_LEVEL"],"readOnly":true},"accountNumber":{"type":"string","readOnly":true},"primaryOwner":{"type":"string"},"organizationInfo":{"type":"object","properties":{"registeredDomain":{"type":"string"},"phoneNumber":{"type":"string"},"address":{"type":"object","properties":{"regionCode":{"type":"string","description":"ISO 3166-1 alpha-2 country","maxLength":2},"languageCode":{"type":"string"},"postalCode":{"type":"string"},"administrativeArea":{"type":"string","description":"State / province"},"locality":{"type":"string","description":"City / town"},"sublocality":{"type":"string"},"addressLines":{"type":"array","items":{"type":"string"},"maxItems":5},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}}}},"readOnly":true}}},"targetLocation":{"type":"object","properties":{"locationName":{"type":"string"},"address":{"type":"string"},"placeId":{"type":"string"}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/invitations/{itemId}/accept":{"post":{"operationId":"googleBusinessInvitationsAccept","summary":"Google Business Profile: Accept (Invitations)","tags":["Focus · Google Business Profile"],"description":"Accept. Pending invitations for this Google login to manage accounts or locations. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.invitations Generic route: `/v1/accounts/{accountId}/focus/invitations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-invitations-accept","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/invitations/{itemId}/decline":{"post":{"operationId":"googleBusinessInvitationsDecline","summary":"Google Business Profile: Decline (Invitations)","tags":["Focus · Google Business Profile"],"description":"Decline. Pending invitations for this Google login to manage accounts or locations. Destructive. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts.invitations Generic route: `/v1/accounts/{accountId}/focus/invitations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_google_business","x-mcp-tool":"google-business-invitations-decline","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/notification-settings":{"get":{"operationId":"googleBusinessNotificationSettingsGet","summary":"Google Business Profile: Get Real-time notifications","tags":["Focus · Google Business Profile"],"description":"Pub/Sub topic and notification types for this business account (new/updated reviews, customer media, Google updates, duplicate location, Voice of Merchant changes). Q&A types are deprecated. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/notifications/rest/v1/NotificationSetting Generic route: `/v1/accounts/{accountId}/focus/notification-settings`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"googleAccountId","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_google_business","x-mcp-tool":"google-business-notification-settings-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","readOnly":true},"pubsubTopic":{"type":"string","description":"projects/{project}/topics/{topic}; empty disables"},"notificationTypes":{"type":"array","items":{"type":"string","enum":["GOOGLE_UPDATE","NEW_REVIEW","UPDATED_REVIEW","NEW_CUSTOMER_MEDIA","NEW_QUESTION","UPDATED_QUESTION","NEW_ANSWER","UPDATED_ANSWER","DUPLICATE_LOCATION","LOSS_OF_VOICE_OF_MERCHANT","VOICE_OF_MERCHANT_UPDATED"]}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"googleBusinessNotificationSettingsUpdate","summary":"Google Business Profile: Update Real-time notifications","tags":["Focus · Google Business Profile"],"description":"Pub/Sub topic and notification types for this business account (new/updated reviews, customer media, Google updates, duplicate location, Voice of Merchant changes). Q&A types are deprecated. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/notifications/rest/v1/NotificationSetting Generic route: `/v1/accounts/{accountId}/focus/notification-settings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pubsubTopic":{"type":"string"},"notificationTypes":{"type":"array","items":{"type":"string","enum":["GOOGLE_UPDATE","NEW_REVIEW","UPDATED_REVIEW","NEW_CUSTOMER_MEDIA","NEW_QUESTION","UPDATED_QUESTION","NEW_ANSWER","UPDATED_ANSWER","DUPLICATE_LOCATION","LOSS_OF_VOICE_OF_MERCHANT","VOICE_OF_MERCHANT_UPDATED"]}},"googleAccountId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_google_business","x-mcp-tool":"google-business-notification-settings-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","readOnly":true},"pubsubTopic":{"type":"string","description":"projects/{project}/topics/{topic}; empty disables"},"notificationTypes":{"type":"array","items":{"type":"string","enum":["GOOGLE_UPDATE","NEW_REVIEW","UPDATED_REVIEW","NEW_CUSTOMER_MEDIA","NEW_QUESTION","UPDATED_QUESTION","NEW_ANSWER","UPDATED_ANSWER","DUPLICATE_LOCATION","LOSS_OF_VOICE_OF_MERCHANT","VOICE_OF_MERCHANT_UPDATED"]}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/notification-settings/subscribe":{"post":{"operationId":"googleBusinessNotificationSettingsSubscribe","summary":"Google Business Profile: Enable Socialit notifications (Real-time notifications)","tags":["Focus · Google Business Profile"],"description":"Subscribe to NEW_REVIEW, UPDATED_REVIEW, NEW_CUSTOMER_MEDIA, GOOGLE_UPDATE, DUPLICATE_LOCATION, VOICE_OF_MERCHANT_UPDATED on the Socialit topic. Pub/Sub topic and notification types for this business account (new/updated reviews, customer media, Google updates, duplicate location, Voice of Merchant changes). Q&A types are deprecated. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/notifications/rest/v1/NotificationSetting Generic route: `/v1/accounts/{accountId}/focus/notification-settings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"googleAccountId":{"type":"string"},"pubsubTopic":{"type":"string"},"notificationTypes":{"type":"array","items":{"type":"string","enum":["GOOGLE_UPDATE","NEW_REVIEW","UPDATED_REVIEW","NEW_CUSTOMER_MEDIA","NEW_QUESTION","UPDATED_QUESTION","NEW_ANSWER","UPDATED_ANSWER","DUPLICATE_LOCATION","LOSS_OF_VOICE_OF_MERCHANT","VOICE_OF_MERCHANT_UPDATED"]}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_google_business","x-mcp-tool":"google-business-notification-settings-subscribe","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/google-business/notification-settings/disable":{"post":{"operationId":"googleBusinessNotificationSettingsDisable","summary":"Google Business Profile: Disable notifications (Real-time notifications)","tags":["Focus · Google Business Profile"],"description":"Disable notifications. Pub/Sub topic and notification types for this business account (new/updated reviews, customer media, Google updates, duplicate location, Voice of Merchant changes). Q&A types are deprecated. Destructive. Requires scopes: https://www.googleapis.com/auth/business.manage. Network docs: https://developers.google.com/my-business/reference/notifications/rest/v1/NotificationSetting Generic route: `/v1/accounts/{accountId}/focus/notification-settings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"googleAccountId":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_google_business","x-mcp-tool":"google-business-notification-settings-disable","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/profile":{"get":{"operationId":"instagramProfileGet","summary":"Instagram: Get Profile","tags":["Focus · Instagram"],"description":"Bio, website and counts. The Instagram API cannot edit the profile (bio, name, website, picture): use the Instagram app. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user Generic route: `/v1/accounts/{accountId}/focus/profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":["null","string"],"readOnly":true},"biography":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"profile_picture_url":{"type":["null","string"],"format":"uri","readOnly":true},"followers_count":{"type":["null","integer"],"readOnly":true},"follows_count":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true},"account_type":{"type":["null","string"],"enum":["BUSINESS","MEDIA_CREATOR",null],"readOnly":true},"login_type":{"type":"string","enum":["instagram_login","facebook_login"],"readOnly":true},"page_id":{"type":["null","string"],"readOnly":true,"description":"Linked Facebook Page (Facebook Login)"},"shopping_product_tag_eligibility":{"type":["null","boolean"],"readOnly":true},"profile_url":{"type":["null","string"],"format":"uri","readOnly":true},"editable":{"type":"boolean","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/webhook-subscriptions":{"get":{"operationId":"instagramWebhookSubscriptionsList","summary":"Instagram: List Webhook subscriptions","tags":["Focus · Instagram"],"description":"Real-time delivery of comments, mentions, DMs and story insights for this account. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: instagram_business_basic | pages_manage_metadata. Network docs: https://developers.facebook.com/documentation/instagram-platform/webhooks Generic route: `/v1/accounts/{accountId}/focus/webhook-subscriptions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-webhook-subscriptions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"subscribed_fields":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"instagramWebhookSubscriptionsCreate","summary":"Instagram: Create a Webhook subscriptions item","tags":["Focus · Instagram"],"description":"Real-time delivery of comments, mentions, DMs and story insights for this account. Requires one of: instagram_business_basic | pages_manage_metadata. Network docs: https://developers.facebook.com/documentation/instagram-platform/webhooks Generic route: `/v1/accounts/{accountId}/focus/webhook-subscriptions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"type":["array","null"],"items":{"type":"string"},"description":"Defaults to every supported field"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-webhook-subscriptions-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":["null","string"]},"subscribed_fields":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/webhook-subscriptions/unsubscribe":{"post":{"operationId":"instagramWebhookSubscriptionsUnsubscribe","summary":"Instagram: Unsubscribe (Webhook subscriptions)","tags":["Focus · Instagram"],"description":"Unsubscribe. Real-time delivery of comments, mentions, DMs and story insights for this account. Destructive. Requires one of: instagram_business_basic | pages_manage_metadata. Network docs: https://developers.facebook.com/documentation/instagram-platform/webhooks Generic route: `/v1/accounts/{accountId}/focus/webhook-subscriptions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_instagram","x-mcp-tool":"instagram-webhook-subscriptions-unsubscribe","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/media":{"get":{"operationId":"instagramMediaList","summary":"Instagram: List Posts","tags":["Focus · Instagram"],"description":"Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"Cursor from next_cursor"},{"schema":{"type":["string","null"],"format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":["string","null"],"format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":["string","null"],"enum":["IMAGE","VIDEO","CAROUSEL_ALBUM",null]},"in":"query","name":"media_type","required":false},{"schema":{"type":["string","null"],"enum":["FEED","REELS",null]},"in":"query","name":"product_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-list","x-zernio":["GET /v1/accounts/{accountId}/posts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"instagramMediaCreate","summary":"Instagram: Create a Posts item","tags":["Focus · Instagram"],"description":"Publish now (feed image, Reel, carousel or Story). Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"caption":{"type":["string","null"],"maxLength":2200,"description":"≤2,200 chars, ≤30 hashtags, ≤20 @mentions. Ignored for Stories."},"media":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"type":{"type":["string","null"],"enum":["image","video",null]},"alt_text":{"type":["string","null"],"maxLength":1000}}},"minItems":1,"maxItems":10},"options":{"type":"object","additionalProperties":true,"properties":{"contentType":{"type":"string","enum":["auto","feed","reel","story","carousel"],"default":"auto","description":"auto: 1 image → feed, 1 video → Reel, 2–10 items → carousel. story publishes each media item as a Story. Every single video is a Reel (use shareToFeed for a feed video)."},"shareToFeed":{"type":"boolean","default":true,"description":"Reels only: also show the Reel in the main feed."},"collaborators":{"type":"array","maxItems":3,"items":{"type":"string"},"description":"Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories)."},"userTags":{"type":"array","maxItems":20,"items":{"oneOf":[{"type":"string","description":"Username (leading @ stripped). Images default to the centre (0.5, 0.5)."},{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"x":{"type":"number","minimum":0,"maximum":1,"description":"From the left edge. Required for photos (defaults to 0.5), ignored for video."},"y":{"type":"number","minimum":0,"maximum":1,"description":"From the top edge. Required for photos (defaults to 0.5), ignored for video."},"mediaIndex":{"type":"integer","minimum":0,"description":"Carousel slide index."}}}]},"description":"People tags (feed, Reels, carousel items, Stories)."},"locationId":{"type":"string","pattern":"^[0-9]+$","description":"Facebook Page id with location data (feed, Reels, carousels; not Stories)."},"altText":{"type":"string","maxLength":1000,"description":"Fallback alt text for images (per-item `media[].altText` wins). Images only."},"coverUrl":{"type":"string","format":"uri","description":"Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl."},"thumbOffset":{"type":"integer","minimum":0,"description":"Reel cover frame offset in milliseconds."},"audioName":{"type":"string","description":"Rename the Reel original audio (once, at creation)."},"audioConfiguration":{"type":"object","required":["audioId"],"description":"Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).","properties":{"audioId":{"type":"string"},"audioVolume":{"type":"integer","minimum":0,"maximum":100,"default":100},"videoVolume":{"type":"integer","minimum":0,"maximum":100,"default":100,"description":"0 mutes the original sound."}}},"muteAudio":{"type":"boolean","default":false,"description":"Silence the original sound. With audioConfiguration this sets video_volume=0; otherwise the media pipeline must strip the audio track before publishing (the Graph API has no mute flag)."},"trialParams":{"type":"object","required":["graduationStrategy"],"description":"Trial Reel shown to non-followers first (Reels only).","properties":{"graduationStrategy":{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]}}},"isAiGenerated":{"type":"boolean","default":false,"description":"Meta \"AI info\" label (carousel: parent only)."},"isPaidPartnership":{"type":"boolean","default":false,"description":"\"Paid partnership\" label (Facebook Login only; not Stories)."},"brandedContentSponsors":{"type":"array","maxItems":2,"items":{"type":"string"},"description":"Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery."},"productTags":{"type":"array","description":"Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.","items":{"type":"object","required":["productId"],"properties":{"productId":{"type":"string"},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"mediaIndex":{"type":"integer","minimum":0,"default":0}}}},"commentsEnabled":{"type":"boolean","default":true,"description":"false disables comments right after publishing (best-effort; not Stories)."},"firstComment":{"type":"string","maxLength":2200,"description":"Posted as the first comment (not Stories). Also read from post.firstComment."},"uploadType":{"type":"string","enum":["url","resumable"],"default":"url","description":"resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url."},"checkPublishingLimit":{"type":"boolean","default":false,"description":"Read content_publishing_limit first and fail fast when the 24 h quota is used up."},"containerId":{"type":"string","description":"Publish a container created earlier (≤24 h) instead of creating a new one."}}},"first_comment":{"type":["string","null"],"maxLength":2200}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/media/{itemId}":{"get":{"operationId":"instagramMediaGet","summary":"Instagram: Get a Posts item","tags":["Focus · Instagram"],"description":"Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"instagramMediaUpdate","summary":"Instagram: Update a Posts item","tags":["Focus · Instagram"],"description":"Only comments_enabled can change after publishing (no caption edit). Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comments_enabled":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"instagramMediaDelete","summary":"Instagram: Delete a Posts item","tags":["Focus · Instagram"],"description":"Delete post/Reel/carousel/Story (Facebook Login + instagram_manage_contents). Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires scopes: instagram_basic, instagram_manage_contents. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/media/{itemId}/enable-comments":{"post":{"operationId":"instagramMediaEnableComments","summary":"Instagram: Enable comments (Posts)","tags":["Focus · Instagram"],"description":"Enable comments. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-enable-comments","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/media/{itemId}/disable-comments":{"post":{"operationId":"instagramMediaDisableComments","summary":"Instagram: Disable comments (Posts)","tags":["Focus · Instagram"],"description":"Disable comments. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-disable-comments","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/media/{itemId}/comment":{"post":{"operationId":"instagramMediaComment","summary":"Instagram: Add comment (Posts)","tags":["Focus · Instagram"],"description":"Add comment. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":2200}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-comment","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/media/{itemId}/insights":{"post":{"operationId":"instagramMediaInsights","summary":"Instagram: Insights (Posts)","tags":["Focus · Instagram"],"description":"Per-type metrics (views, reach, likes, comments, saves, shares, watch time, skip rate, navigation…). Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-insights","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/media/{itemId}/children":{"post":{"operationId":"instagramMediaChildren","summary":"Instagram: Carousel items (Posts)","tags":["Focus · Instagram"],"description":"Carousel items. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-children","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/media/{itemId}/collaborators":{"post":{"operationId":"instagramMediaCollaborators","summary":"Instagram: Collaborators (Posts)","tags":["Focus · Instagram"],"description":"Collaborators. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires scopes: instagram_basic. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-collaborators","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/media/{itemId}/like":{"post":{"operationId":"instagramMediaLike","summary":"Instagram: Like as business (Posts)","tags":["Focus · Instagram"],"description":"Like as business. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/media/{itemId}/unlike":{"post":{"operationId":"instagramMediaUnlike","summary":"Instagram: Unlike (Posts)","tags":["Focus · Instagram"],"description":"Unlike. Feed posts, Reels and carousels (≤10,000 most recent). Create publishes immediately; schedule from Scheduled. Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-media-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/reels":{"get":{"operationId":"instagramReelsList","summary":"Instagram: List Reels","tags":["Focus · Instagram"],"description":"Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"Cursor from next_cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"instagramReelsCreate","summary":"Instagram: Create a Reels item","tags":["Focus · Instagram"],"description":"Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"caption":{"type":["string","null"],"maxLength":2200},"video":{"type":"object","properties":{"media_id":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"}}},"share_to_feed":{"type":["boolean","null"],"default":true},"cover_url":{"type":["string","null"],"format":"uri"},"thumb_offset":{"type":["integer","null"],"minimum":0},"audio_name":{"type":["string","null"]},"audio_id":{"type":["string","null"],"description":"Audio API track (Facebook Login)"},"trial":{"type":["string","null"],"enum":["MANUAL","SS_PERFORMANCE",null],"description":"Publish as a trial Reel"},"collaborators":{"type":["array","null"],"items":{"type":"string"},"maxItems":3},"location_id":{"type":["string","null"]},"first_comment":{"type":["string","null"]}},"required":["video"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/reels/{itemId}":{"get":{"operationId":"instagramReelsGet","summary":"Instagram: Get a Reels item","tags":["Focus · Instagram"],"description":"Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"instagramReelsDelete","summary":"Instagram: Delete a Reels item","tags":["Focus · Instagram"],"description":"Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires scopes: instagram_basic, instagram_manage_contents. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/reels/{itemId}/enable-comments":{"post":{"operationId":"instagramReelsEnableComments","summary":"Instagram: Enable comments (Reels)","tags":["Focus · Instagram"],"description":"Enable comments. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-enable-comments","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/reels/{itemId}/disable-comments":{"post":{"operationId":"instagramReelsDisableComments","summary":"Instagram: Disable comments (Reels)","tags":["Focus · Instagram"],"description":"Disable comments. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-disable-comments","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/reels/{itemId}/comment":{"post":{"operationId":"instagramReelsComment","summary":"Instagram: Add comment (Reels)","tags":["Focus · Instagram"],"description":"Add comment. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":2200}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-comment","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/reels/{itemId}/insights":{"post":{"operationId":"instagramReelsInsights","summary":"Instagram: Insights (Reels)","tags":["Focus · Instagram"],"description":"Per-type metrics (views, reach, likes, comments, saves, shares, watch time, skip rate, navigation…). Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-insights","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/reels/{itemId}/children":{"post":{"operationId":"instagramReelsChildren","summary":"Instagram: Carousel items (Reels)","tags":["Focus · Instagram"],"description":"Carousel items. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-children","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/reels/{itemId}/collaborators":{"post":{"operationId":"instagramReelsCollaborators","summary":"Instagram: Collaborators (Reels)","tags":["Focus · Instagram"],"description":"Collaborators. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires scopes: instagram_basic. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-collaborators","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/reels/{itemId}/like":{"post":{"operationId":"instagramReelsLike","summary":"Instagram: Like as business (Reels)","tags":["Focus · Instagram"],"description":"Like as business. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/reels/{itemId}/unlike":{"post":{"operationId":"instagramReelsUnlike","summary":"Instagram: Unlike (Reels)","tags":["Focus · Instagram"],"description":"Unlike. Reels only (incl. trial Reels). Create publishes a Reel (share_to_feed, cover, audio, trial params). Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/reels`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-reels-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/stories/{itemId}":{"delete":{"operationId":"instagramStoriesDelete","summary":"Instagram: Delete a Stories item","tags":["Focus · Instagram"],"description":"Active Stories (24 h). Insights are only readable while live; archived story metrics come from the story_insights webhook (Facebook Login). Requires scopes: instagram_basic, instagram_manage_contents. Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/stories Generic route: `/v1/accounts/{accountId}/focus/stories`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_instagram","x-mcp-tool":"instagram-stories-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/stories/{itemId}/insights":{"post":{"operationId":"instagramStoriesInsights","summary":"Instagram: Story insights (Stories)","tags":["Focus · Instagram"],"description":"views, reach, replies, shares, profile visits, follows, taps forward/back, exits, swipes. Active Stories (24 h). Insights are only readable while live; archived story metrics come from the story_insights webhook (Facebook Login). Requires one of: instagram_business_basic | instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/stories Generic route: `/v1/accounts/{accountId}/focus/stories`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-stories-insights","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/containers/{itemId}":{"get":{"operationId":"instagramContainersGet","summary":"Instagram: Get a Media containers item","tags":["Focus · Instagram"],"description":"Low-level two-step publishing: create a container (expires in 24 h), check its status, publish it. Requires one of: instagram_business_content_publish | instagram_content_publish. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/containers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-containers-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status_code":{"type":["null","string"],"enum":["IN_PROGRESS","FINISHED","ERROR","EXPIRED","PUBLISHED",null]},"status":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/containers":{"post":{"operationId":"instagramContainersCreate","summary":"Instagram: Create a Media containers item","tags":["Focus · Instagram"],"description":"Create a container with raw Graph params (image_url | video_url, media_type, caption, …). Low-level two-step publishing: create a container (expires in 24 h), check its status, publish it. Requires one of: instagram_business_content_publish | instagram_content_publish. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/containers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"image_url":{"type":["string","null"],"format":"uri"},"video_url":{"type":["string","null"],"format":"uri"},"media_type":{"type":["string","null"],"enum":["REELS","STORIES","CAROUSEL","VIDEO",null]},"caption":{"type":["string","null"]},"is_carousel_item":{"type":["boolean","null"]},"children":{"type":["array","null"],"items":{"type":"string"}},"share_to_feed":{"type":["boolean","null"]},"cover_url":{"type":["string","null"],"format":"uri"},"thumb_offset":{"type":["integer","null"]},"location_id":{"type":["string","null"]},"alt_text":{"type":["string","null"]},"collaborators":{"type":["array","null"],"items":{"type":"string"}},"user_tags":{"type":["array","null"],"items":{"type":"object","properties":{"username":{"type":"string"},"x":{"type":["number","null"]},"y":{"type":["number","null"]}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-containers-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status_code":{"type":["null","string"],"enum":["IN_PROGRESS","FINISHED","ERROR","EXPIRED","PUBLISHED",null]},"status":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/containers/{itemId}/publish":{"post":{"operationId":"instagramContainersPublish","summary":"Instagram: Publish container (Media containers)","tags":["Focus · Instagram"],"description":"Publish container. Low-level two-step publishing: create a container (expires in 24 h), check its status, publish it. Requires one of: instagram_business_content_publish | instagram_content_publish. Network docs: https://developers.facebook.com/documentation/instagram-platform/content-publishing Generic route: `/v1/accounts/{accountId}/focus/containers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-containers-publish","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/scheduled":{"get":{"operationId":"instagramScheduledList","summary":"Instagram: List Scheduled & drafts","tags":["Focus · Instagram"],"description":"Posts scheduled or drafted in Socialit for this account. Requires the API to provide ctx.posts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: instagram_business_content_publish | instagram_content_publish. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","parameters":[{"schema":{"type":["string","null"],"enum":["draft","scheduled","failed",null]},"in":"query","name":"status","required":false},{"schema":{"type":["string","null"],"format":"date-time"},"in":"query","name":"from","required":false},{"schema":{"type":["string","null"],"format":"date-time"},"in":"query","name":"to","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-scheduled-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status":{"type":"string","enum":["draft","scheduled","publishing","published","failed"]},"content":{"type":["null","string"],"maxLength":2200},"scheduled_for":{"type":["null","string"],"format":"date-time"},"media":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"},"type":{"type":["null","string"],"enum":["image","video",null]},"alt_text":{"type":["null","string"],"maxLength":1000}}},"minItems":1,"maxItems":10},"platform_options":{"type":["null","object"],"additionalProperties":true,"properties":{"contentType":{"type":"string","enum":["auto","feed","reel","story","carousel"],"default":"auto","description":"auto: 1 image → feed, 1 video → Reel, 2–10 items → carousel. story publishes each media item as a Story. Every single video is a Reel (use shareToFeed for a feed video)."},"shareToFeed":{"type":"boolean","default":true,"description":"Reels only: also show the Reel in the main feed."},"collaborators":{"type":"array","maxItems":3,"items":{"type":"string"},"description":"Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories)."},"userTags":{"type":"array","maxItems":20,"items":{"oneOf":[{"type":"string","description":"Username (leading @ stripped). Images default to the centre (0.5, 0.5)."},{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"x":{"type":"number","minimum":0,"maximum":1,"description":"From the left edge. Required for photos (defaults to 0.5), ignored for video."},"y":{"type":"number","minimum":0,"maximum":1,"description":"From the top edge. Required for photos (defaults to 0.5), ignored for video."},"mediaIndex":{"type":"integer","minimum":0,"description":"Carousel slide index."}}}]},"description":"People tags (feed, Reels, carousel items, Stories)."},"locationId":{"type":"string","pattern":"^[0-9]+$","description":"Facebook Page id with location data (feed, Reels, carousels; not Stories)."},"altText":{"type":"string","maxLength":1000,"description":"Fallback alt text for images (per-item `media[].altText` wins). Images only."},"coverUrl":{"type":"string","format":"uri","description":"Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl."},"thumbOffset":{"type":"integer","minimum":0,"description":"Reel cover frame offset in milliseconds."},"audioName":{"type":"string","description":"Rename the Reel original audio (once, at creation)."},"audioConfiguration":{"type":"object","required":["audioId"],"description":"Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).","properties":{"audioId":{"type":"string"},"audioVolume":{"type":"integer","minimum":0,"maximum":100,"default":100},"videoVolume":{"type":"integer","minimum":0,"maximum":100,"default":100,"description":"0 mutes the original sound."}}},"muteAudio":{"type":"boolean","default":false,"description":"Silence the original sound. With audioConfiguration this sets video_volume=0; otherwise the media pipeline must strip the audio track before publishing (the Graph API has no mute flag)."},"trialParams":{"type":"object","required":["graduationStrategy"],"description":"Trial Reel shown to non-followers first (Reels only).","properties":{"graduationStrategy":{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]}}},"isAiGenerated":{"type":"boolean","default":false,"description":"Meta \"AI info\" label (carousel: parent only)."},"isPaidPartnership":{"type":"boolean","default":false,"description":"\"Paid partnership\" label (Facebook Login only; not Stories)."},"brandedContentSponsors":{"type":"array","maxItems":2,"items":{"type":"string"},"description":"Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery."},"productTags":{"type":"array","description":"Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.","items":{"type":"object","required":["productId"],"properties":{"productId":{"type":"string"},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"mediaIndex":{"type":"integer","minimum":0,"default":0}}}},"commentsEnabled":{"type":"boolean","default":true,"description":"false disables comments right after publishing (best-effort; not Stories)."},"firstComment":{"type":"string","maxLength":2200,"description":"Posted as the first comment (not Stories). Also read from post.firstComment."},"uploadType":{"type":"string","enum":["url","resumable"],"default":"url","description":"resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url."},"checkPublishingLimit":{"type":"boolean","default":false,"description":"Read content_publishing_limit first and fail fast when the 24 h quota is used up."},"containerId":{"type":"string","description":"Publish a container created earlier (≤24 h) instead of creating a new one."}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"instagramScheduledCreate","summary":"Instagram: Create a Scheduled & drafts item","tags":["Focus · Instagram"],"description":"Posts scheduled or drafted in Socialit for this account. Requires the API to provide ctx.posts. Requires one of: instagram_business_content_publish | instagram_content_publish. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":["string","null"]},"scheduled_for":{"type":["string","null"],"format":"date-time"},"status":{"type":["string","null"],"enum":["draft","scheduled",null]},"media":{"type":["array","null"],"items":{"type":"object","properties":{"media_id":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"type":{"type":["string","null"],"enum":["image","video",null]},"alt_text":{"type":["string","null"],"maxLength":1000}}},"minItems":1,"maxItems":10},"platform_options":{"type":["object","null"],"properties":{}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-scheduled-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status":{"type":"string","enum":["draft","scheduled","publishing","published","failed"]},"content":{"type":["null","string"],"maxLength":2200},"scheduled_for":{"type":["null","string"],"format":"date-time"},"media":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"},"type":{"type":["null","string"],"enum":["image","video",null]},"alt_text":{"type":["null","string"],"maxLength":1000}}},"minItems":1,"maxItems":10},"platform_options":{"type":["null","object"],"additionalProperties":true,"properties":{"contentType":{"type":"string","enum":["auto","feed","reel","story","carousel"],"default":"auto","description":"auto: 1 image → feed, 1 video → Reel, 2–10 items → carousel. story publishes each media item as a Story. Every single video is a Reel (use shareToFeed for a feed video)."},"shareToFeed":{"type":"boolean","default":true,"description":"Reels only: also show the Reel in the main feed."},"collaborators":{"type":"array","maxItems":3,"items":{"type":"string"},"description":"Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories)."},"userTags":{"type":"array","maxItems":20,"items":{"oneOf":[{"type":"string","description":"Username (leading @ stripped). Images default to the centre (0.5, 0.5)."},{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"x":{"type":"number","minimum":0,"maximum":1,"description":"From the left edge. Required for photos (defaults to 0.5), ignored for video."},"y":{"type":"number","minimum":0,"maximum":1,"description":"From the top edge. Required for photos (defaults to 0.5), ignored for video."},"mediaIndex":{"type":"integer","minimum":0,"description":"Carousel slide index."}}}]},"description":"People tags (feed, Reels, carousel items, Stories)."},"locationId":{"type":"string","pattern":"^[0-9]+$","description":"Facebook Page id with location data (feed, Reels, carousels; not Stories)."},"altText":{"type":"string","maxLength":1000,"description":"Fallback alt text for images (per-item `media[].altText` wins). Images only."},"coverUrl":{"type":"string","format":"uri","description":"Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl."},"thumbOffset":{"type":"integer","minimum":0,"description":"Reel cover frame offset in milliseconds."},"audioName":{"type":"string","description":"Rename the Reel original audio (once, at creation)."},"audioConfiguration":{"type":"object","required":["audioId"],"description":"Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).","properties":{"audioId":{"type":"string"},"audioVolume":{"type":"integer","minimum":0,"maximum":100,"default":100},"videoVolume":{"type":"integer","minimum":0,"maximum":100,"default":100,"description":"0 mutes the original sound."}}},"muteAudio":{"type":"boolean","default":false,"description":"Silence the original sound. With audioConfiguration this sets video_volume=0; otherwise the media pipeline must strip the audio track before publishing (the Graph API has no mute flag)."},"trialParams":{"type":"object","required":["graduationStrategy"],"description":"Trial Reel shown to non-followers first (Reels only).","properties":{"graduationStrategy":{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]}}},"isAiGenerated":{"type":"boolean","default":false,"description":"Meta \"AI info\" label (carousel: parent only)."},"isPaidPartnership":{"type":"boolean","default":false,"description":"\"Paid partnership\" label (Facebook Login only; not Stories)."},"brandedContentSponsors":{"type":"array","maxItems":2,"items":{"type":"string"},"description":"Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery."},"productTags":{"type":"array","description":"Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.","items":{"type":"object","required":["productId"],"properties":{"productId":{"type":"string"},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"mediaIndex":{"type":"integer","minimum":0,"default":0}}}},"commentsEnabled":{"type":"boolean","default":true,"description":"false disables comments right after publishing (best-effort; not Stories)."},"firstComment":{"type":"string","maxLength":2200,"description":"Posted as the first comment (not Stories). Also read from post.firstComment."},"uploadType":{"type":"string","enum":["url","resumable"],"default":"url","description":"resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url."},"checkPublishingLimit":{"type":"boolean","default":false,"description":"Read content_publishing_limit first and fail fast when the 24 h quota is used up."},"containerId":{"type":"string","description":"Publish a container created earlier (≤24 h) instead of creating a new one."}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/scheduled/{itemId}":{"get":{"operationId":"instagramScheduledGet","summary":"Instagram: Get a Scheduled & drafts item","tags":["Focus · Instagram"],"description":"Posts scheduled or drafted in Socialit for this account. Requires the API to provide ctx.posts. Requires one of: instagram_business_content_publish | instagram_content_publish. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-scheduled-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status":{"type":"string","enum":["draft","scheduled","publishing","published","failed"]},"content":{"type":["null","string"],"maxLength":2200},"scheduled_for":{"type":["null","string"],"format":"date-time"},"media":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"},"type":{"type":["null","string"],"enum":["image","video",null]},"alt_text":{"type":["null","string"],"maxLength":1000}}},"minItems":1,"maxItems":10},"platform_options":{"type":["null","object"],"additionalProperties":true,"properties":{"contentType":{"type":"string","enum":["auto","feed","reel","story","carousel"],"default":"auto","description":"auto: 1 image → feed, 1 video → Reel, 2–10 items → carousel. story publishes each media item as a Story. Every single video is a Reel (use shareToFeed for a feed video)."},"shareToFeed":{"type":"boolean","default":true,"description":"Reels only: also show the Reel in the main feed."},"collaborators":{"type":"array","maxItems":3,"items":{"type":"string"},"description":"Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories)."},"userTags":{"type":"array","maxItems":20,"items":{"oneOf":[{"type":"string","description":"Username (leading @ stripped). Images default to the centre (0.5, 0.5)."},{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"x":{"type":"number","minimum":0,"maximum":1,"description":"From the left edge. Required for photos (defaults to 0.5), ignored for video."},"y":{"type":"number","minimum":0,"maximum":1,"description":"From the top edge. Required for photos (defaults to 0.5), ignored for video."},"mediaIndex":{"type":"integer","minimum":0,"description":"Carousel slide index."}}}]},"description":"People tags (feed, Reels, carousel items, Stories)."},"locationId":{"type":"string","pattern":"^[0-9]+$","description":"Facebook Page id with location data (feed, Reels, carousels; not Stories)."},"altText":{"type":"string","maxLength":1000,"description":"Fallback alt text for images (per-item `media[].altText` wins). Images only."},"coverUrl":{"type":"string","format":"uri","description":"Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl."},"thumbOffset":{"type":"integer","minimum":0,"description":"Reel cover frame offset in milliseconds."},"audioName":{"type":"string","description":"Rename the Reel original audio (once, at creation)."},"audioConfiguration":{"type":"object","required":["audioId"],"description":"Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).","properties":{"audioId":{"type":"string"},"audioVolume":{"type":"integer","minimum":0,"maximum":100,"default":100},"videoVolume":{"type":"integer","minimum":0,"maximum":100,"default":100,"description":"0 mutes the original sound."}}},"muteAudio":{"type":"boolean","default":false,"description":"Silence the original sound. With audioConfiguration this sets video_volume=0; otherwise the media pipeline must strip the audio track before publishing (the Graph API has no mute flag)."},"trialParams":{"type":"object","required":["graduationStrategy"],"description":"Trial Reel shown to non-followers first (Reels only).","properties":{"graduationStrategy":{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]}}},"isAiGenerated":{"type":"boolean","default":false,"description":"Meta \"AI info\" label (carousel: parent only)."},"isPaidPartnership":{"type":"boolean","default":false,"description":"\"Paid partnership\" label (Facebook Login only; not Stories)."},"brandedContentSponsors":{"type":"array","maxItems":2,"items":{"type":"string"},"description":"Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery."},"productTags":{"type":"array","description":"Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.","items":{"type":"object","required":["productId"],"properties":{"productId":{"type":"string"},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"mediaIndex":{"type":"integer","minimum":0,"default":0}}}},"commentsEnabled":{"type":"boolean","default":true,"description":"false disables comments right after publishing (best-effort; not Stories)."},"firstComment":{"type":"string","maxLength":2200,"description":"Posted as the first comment (not Stories). Also read from post.firstComment."},"uploadType":{"type":"string","enum":["url","resumable"],"default":"url","description":"resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url."},"checkPublishingLimit":{"type":"boolean","default":false,"description":"Read content_publishing_limit first and fail fast when the 24 h quota is used up."},"containerId":{"type":"string","description":"Publish a container created earlier (≤24 h) instead of creating a new one."}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"instagramScheduledUpdate","summary":"Instagram: Update a Scheduled & drafts item","tags":["Focus · Instagram"],"description":"Posts scheduled or drafted in Socialit for this account. Requires the API to provide ctx.posts. Requires one of: instagram_business_content_publish | instagram_content_publish. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_instagram","x-mcp-tool":"instagram-scheduled-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status":{"type":"string","enum":["draft","scheduled","publishing","published","failed"]},"content":{"type":["null","string"],"maxLength":2200},"scheduled_for":{"type":["null","string"],"format":"date-time"},"media":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"},"type":{"type":["null","string"],"enum":["image","video",null]},"alt_text":{"type":["null","string"],"maxLength":1000}}},"minItems":1,"maxItems":10},"platform_options":{"type":["null","object"],"additionalProperties":true,"properties":{"contentType":{"type":"string","enum":["auto","feed","reel","story","carousel"],"default":"auto","description":"auto: 1 image → feed, 1 video → Reel, 2–10 items → carousel. story publishes each media item as a Story. Every single video is a Reel (use shareToFeed for a feed video)."},"shareToFeed":{"type":"boolean","default":true,"description":"Reels only: also show the Reel in the main feed."},"collaborators":{"type":"array","maxItems":3,"items":{"type":"string"},"description":"Up to 3 public Business/Creator usernames invited as collaborators (feed, Reels, carousels; not Stories)."},"userTags":{"type":"array","maxItems":20,"items":{"oneOf":[{"type":"string","description":"Username (leading @ stripped). Images default to the centre (0.5, 0.5)."},{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"x":{"type":"number","minimum":0,"maximum":1,"description":"From the left edge. Required for photos (defaults to 0.5), ignored for video."},"y":{"type":"number","minimum":0,"maximum":1,"description":"From the top edge. Required for photos (defaults to 0.5), ignored for video."},"mediaIndex":{"type":"integer","minimum":0,"description":"Carousel slide index."}}}]},"description":"People tags (feed, Reels, carousel items, Stories)."},"locationId":{"type":"string","pattern":"^[0-9]+$","description":"Facebook Page id with location data (feed, Reels, carousels; not Stories)."},"altText":{"type":"string","maxLength":1000,"description":"Fallback alt text for images (per-item `media[].altText` wins). Images only."},"coverUrl":{"type":"string","format":"uri","description":"Custom Reel cover (JPEG, 9:16). Overrides thumbOffset. Aliases: instagramThumbnail, reelCover, thumbnailUrl."},"thumbOffset":{"type":"integer","minimum":0,"description":"Reel cover frame offset in milliseconds."},"audioName":{"type":"string","description":"Rename the Reel original audio (once, at creation)."},"audioConfiguration":{"type":"object","required":["audioId"],"description":"Catalog / original-sound track from the Audio API (Reels only; Facebook Login only).","properties":{"audioId":{"type":"string"},"audioVolume":{"type":"integer","minimum":0,"maximum":100,"default":100},"videoVolume":{"type":"integer","minimum":0,"maximum":100,"default":100,"description":"0 mutes the original sound."}}},"muteAudio":{"type":"boolean","default":false,"description":"Silence the original sound. With audioConfiguration this sets video_volume=0; otherwise the media pipeline must strip the audio track before publishing (the Graph API has no mute flag)."},"trialParams":{"type":"object","required":["graduationStrategy"],"description":"Trial Reel shown to non-followers first (Reels only).","properties":{"graduationStrategy":{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]}}},"isAiGenerated":{"type":"boolean","default":false,"description":"Meta \"AI info\" label (carousel: parent only)."},"isPaidPartnership":{"type":"boolean","default":false,"description":"\"Paid partnership\" label (Facebook Login only; not Stories)."},"brandedContentSponsors":{"type":"array","maxItems":2,"items":{"type":"string"},"description":"Up to 2 sponsor usernames or IG user ids (Facebook Login only). Usernames are resolved via Business Discovery."},"productTags":{"type":"array","description":"Catalog product tags (Facebook Login + approved Instagram Shop). ≤5 per image/video item.","items":{"type":"object","required":["productId"],"properties":{"productId":{"type":"string"},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"mediaIndex":{"type":"integer","minimum":0,"default":0}}}},"commentsEnabled":{"type":"boolean","default":true,"description":"false disables comments right after publishing (best-effort; not Stories)."},"firstComment":{"type":"string","maxLength":2200,"description":"Posted as the first comment (not Stories). Also read from post.firstComment."},"uploadType":{"type":"string","enum":["url","resumable"],"default":"url","description":"resumable uploads video bytes (media[].buffer) or a hosted file via rupload.facebook.com instead of letting Meta fetch video_url."},"checkPublishingLimit":{"type":"boolean","default":false,"description":"Read content_publishing_limit first and fail fast when the 24 h quota is used up."},"containerId":{"type":"string","description":"Publish a container created earlier (≤24 h) instead of creating a new one."}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"instagramScheduledDelete","summary":"Instagram: Delete a Scheduled & drafts item","tags":["Focus · Instagram"],"description":"Posts scheduled or drafted in Socialit for this account. Requires the API to provide ctx.posts. Requires one of: instagram_business_content_publish | instagram_content_publish. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_instagram","x-mcp-tool":"instagram-scheduled-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/live":{"get":{"operationId":"instagramLiveList","summary":"Instagram: List Live","tags":["Focus · Instagram"],"description":"Live broadcast in progress (read-only; starting a Live is not possible via API). Live comments arrive by webhook. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/live_media Generic route: `/v1/accounts/{accountId}/focus/live`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-live-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string"},"media_product_type":{"type":"string"},"username":{"type":["null","string"]},"timestamp":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/collaboration-invites":{"get":{"operationId":"instagramCollaborationInvitesList","summary":"Instagram: List Collab invites","tags":["Focus · Instagram"],"description":"Pending collaboration invitations (GET 300/24 h, accept/decline 50/24 h). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/collaboration Generic route: `/v1/accounts/{accountId}/focus/collaboration-invites`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"Cursor from next_cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-collaboration-invites-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string"},"media_owner_username":{"type":["null","string"]},"caption":{"type":["null","string"]},"media_url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/collaboration-invites/{itemId}/accept":{"post":{"operationId":"instagramCollaborationInvitesAccept","summary":"Instagram: Accept (Collab invites)","tags":["Focus · Instagram"],"description":"Accept. Pending collaboration invitations (GET 300/24 h, accept/decline 50/24 h). Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/collaboration Generic route: `/v1/accounts/{accountId}/focus/collaboration-invites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-collaboration-invites-accept","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/collaboration-invites/{itemId}/decline":{"post":{"operationId":"instagramCollaborationInvitesDecline","summary":"Instagram: Decline (Collab invites)","tags":["Focus · Instagram"],"description":"Decline. Pending collaboration invitations (GET 300/24 h, accept/decline 50/24 h). Destructive. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/collaboration Generic route: `/v1/accounts/{accountId}/focus/collaboration-invites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_instagram","x-mcp-tool":"instagram-collaboration-invites-decline","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/collaborative-media":{"get":{"operationId":"instagramCollaborativeMediaList","summary":"Instagram: List Collab posts","tags":["Focus · Instagram"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/collaboration Generic route: `/v1/accounts/{accountId}/focus/collaborative-media`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"Cursor from next_cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-collaborative-media-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/upcoming-events":{"get":{"operationId":"instagramUpcomingEventsList","summary":"Instagram: List Event reminders","tags":["Focus · Instagram"],"description":"Upcoming event reminders (business-linked accounts; only events created via API/Ads Manager are listed). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: instagram_basic, instagram_manage_upcoming_events. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/upcoming-events Generic route: `/v1/accounts/{accountId}/focus/upcoming-events`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-upcoming-events-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"start_time":{"type":"string","format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"notification_subtypes":{"type":["null","array"],"items":{"type":"string","enum":["BEFORE_EVENT_1DAY","BEFORE_EVENT_2DAY","BEFORE_EVENT_1HOUR","BEFORE_EVENT_15MIN","EVENT_START","AFTER_EVENT_1DAY","AFTER_EVENT_2DAY","AFTER_EVENT_3DAY","AFTER_EVENT_4DAY","AFTER_EVENT_5DAY","AFTER_EVENT_6DAY","AFTER_EVENT_7DAY"]}},"notification_target_time":{"type":["null","string"],"enum":["EVENT_START","EVENT_END",null]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"instagramUpcomingEventsCreate","summary":"Instagram: Create a Event reminders item","tags":["Focus · Instagram"],"description":"Upcoming event reminders (business-linked accounts; only events created via API/Ads Manager are listed). Requires scopes: instagram_basic, instagram_manage_upcoming_events. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/upcoming-events Generic route: `/v1/accounts/{accountId}/focus/upcoming-events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"start_time":{"type":"string","format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"notification_subtypes":{"type":["array","null"],"items":{"type":"string","enum":["BEFORE_EVENT_1DAY","BEFORE_EVENT_2DAY","BEFORE_EVENT_1HOUR","BEFORE_EVENT_15MIN","EVENT_START","AFTER_EVENT_1DAY","AFTER_EVENT_2DAY","AFTER_EVENT_3DAY","AFTER_EVENT_4DAY","AFTER_EVENT_5DAY","AFTER_EVENT_6DAY","AFTER_EVENT_7DAY"]}},"notification_target_time":{"type":["string","null"],"enum":["EVENT_START","EVENT_END",null]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-upcoming-events-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"start_time":{"type":"string","format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"notification_subtypes":{"type":["null","array"],"items":{"type":"string","enum":["BEFORE_EVENT_1DAY","BEFORE_EVENT_2DAY","BEFORE_EVENT_1HOUR","BEFORE_EVENT_15MIN","EVENT_START","AFTER_EVENT_1DAY","AFTER_EVENT_2DAY","AFTER_EVENT_3DAY","AFTER_EVENT_4DAY","AFTER_EVENT_5DAY","AFTER_EVENT_6DAY","AFTER_EVENT_7DAY"]}},"notification_target_time":{"type":["null","string"],"enum":["EVENT_START","EVENT_END",null]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/upcoming-events/{itemId}":{"get":{"operationId":"instagramUpcomingEventsGet","summary":"Instagram: Get a Event reminders item","tags":["Focus · Instagram"],"description":"Upcoming event reminders (business-linked accounts; only events created via API/Ads Manager are listed). Requires scopes: instagram_basic, instagram_manage_upcoming_events. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/upcoming-events Generic route: `/v1/accounts/{accountId}/focus/upcoming-events`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-upcoming-events-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"start_time":{"type":"string","format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"notification_subtypes":{"type":["null","array"],"items":{"type":"string","enum":["BEFORE_EVENT_1DAY","BEFORE_EVENT_2DAY","BEFORE_EVENT_1HOUR","BEFORE_EVENT_15MIN","EVENT_START","AFTER_EVENT_1DAY","AFTER_EVENT_2DAY","AFTER_EVENT_3DAY","AFTER_EVENT_4DAY","AFTER_EVENT_5DAY","AFTER_EVENT_6DAY","AFTER_EVENT_7DAY"]}},"notification_target_time":{"type":["null","string"],"enum":["EVENT_START","EVENT_END",null]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"instagramUpcomingEventsUpdate","summary":"Instagram: Update a Event reminders item","tags":["Focus · Instagram"],"description":"Upcoming event reminders (business-linked accounts; only events created via API/Ads Manager are listed). Requires scopes: instagram_basic, instagram_manage_upcoming_events. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/upcoming-events Generic route: `/v1/accounts/{accountId}/focus/upcoming-events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"start_time":{"type":"string","format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"notification_subtypes":{"type":["array","null"],"items":{"type":"string","enum":["BEFORE_EVENT_1DAY","BEFORE_EVENT_2DAY","BEFORE_EVENT_1HOUR","BEFORE_EVENT_15MIN","EVENT_START","AFTER_EVENT_1DAY","AFTER_EVENT_2DAY","AFTER_EVENT_3DAY","AFTER_EVENT_4DAY","AFTER_EVENT_5DAY","AFTER_EVENT_6DAY","AFTER_EVENT_7DAY"]}},"notification_target_time":{"type":["string","null"],"enum":["EVENT_START","EVENT_END",null]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_instagram","x-mcp-tool":"instagram-upcoming-events-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"start_time":{"type":"string","format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"notification_subtypes":{"type":["null","array"],"items":{"type":"string","enum":["BEFORE_EVENT_1DAY","BEFORE_EVENT_2DAY","BEFORE_EVENT_1HOUR","BEFORE_EVENT_15MIN","EVENT_START","AFTER_EVENT_1DAY","AFTER_EVENT_2DAY","AFTER_EVENT_3DAY","AFTER_EVENT_4DAY","AFTER_EVENT_5DAY","AFTER_EVENT_6DAY","AFTER_EVENT_7DAY"]}},"notification_target_time":{"type":["null","string"],"enum":["EVENT_START","EVENT_END",null]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/comments":{"get":{"operationId":"instagramCommentsList","summary":"Instagram: List Comments","tags":["Focus · Instagram"],"description":"Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"Cursor from next_cursor"},{"schema":{"type":["string","null"]},"in":"query","name":"media_id","required":false,"description":"Only comments on this media"},{"schema":{"type":["integer","null"],"minimum":1,"maximum":50,"default":15},"in":"query","name":"media_limit","required":false,"description":"Recent media scanned for the queue"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-list","x-zernio":["GET /v1/inbox/comments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"author":{"type":["null","string"],"description":"username"},"author_id":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"hidden":{"type":["null","boolean"]},"parent_id":{"type":["null","string"]},"media_id":{"type":["null","string"]},"replies_count":{"type":["null","integer"]},"replies":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"author":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"hidden":{"type":["null","boolean"]}}}},"media":{"type":["null","object"],"properties":{"id":{"type":"string"},"caption":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"media_product_type":{"type":["null","string"],"enum":["FEED","REELS","STORY","AD",null]},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"instagramCommentsCreate","summary":"Instagram: Create a Comments item","tags":["Focus · Instagram"],"description":"Top-level comment on a media object. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string"},"message":{"type":"string","maxLength":2200}},"required":["media_id","message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}","POST /v1/inbox/comments/{postId}/{commentId}/hide","POST /v1/inbox/comments/{postId}/{commentId}/like","POST /v1/inbox/comments/{postId}/{commentId}/private-reply"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"author":{"type":["null","string"],"description":"username"},"author_id":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"hidden":{"type":["null","boolean"]},"parent_id":{"type":["null","string"]},"media_id":{"type":["null","string"]},"replies_count":{"type":["null","integer"]},"replies":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"author":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"hidden":{"type":["null","boolean"]}}}},"media":{"type":["null","object"],"properties":{"id":{"type":"string"},"caption":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"media_product_type":{"type":["null","string"],"enum":["FEED","REELS","STORY","AD",null]},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/comments/{itemId}":{"get":{"operationId":"instagramCommentsGet","summary":"Instagram: Get a Comments item","tags":["Focus · Instagram"],"description":"Comment with replies. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-get","x-zernio":["GET /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"author":{"type":["null","string"],"description":"username"},"author_id":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"hidden":{"type":["null","boolean"]},"parent_id":{"type":["null","string"]},"media_id":{"type":["null","string"]},"replies_count":{"type":["null","integer"]},"replies":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"author":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"hidden":{"type":["null","boolean"]}}}},"media":{"type":["null","object"],"properties":{"id":{"type":"string"},"caption":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"media_product_type":{"type":["null","string"],"enum":["FEED","REELS","STORY","AD",null]},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"instagramCommentsDelete","summary":"Instagram: Delete a Comments item","tags":["Focus · Instagram"],"description":"Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-delete","x-zernio":["DELETE /v1/inbox/comments/{postId}","DELETE /v1/inbox/comments/{postId}/{commentId}/hide","DELETE /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/comments/{itemId}/reply":{"post":{"operationId":"instagramCommentsReply","summary":"Instagram: Reply (Comments)","tags":["Focus · Instagram"],"description":"Reply. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":2200}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/comments/{itemId}/replies":{"post":{"operationId":"instagramCommentsReplies","summary":"Instagram: Load replies (Comments)","tags":["Focus · Instagram"],"description":"Load replies. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-replies","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/comments/{itemId}/hide":{"post":{"operationId":"instagramCommentsHide","summary":"Instagram: Hide (Comments)","tags":["Focus · Instagram"],"description":"Hide. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/comments/{itemId}/unhide":{"post":{"operationId":"instagramCommentsUnhide","summary":"Instagram: Unhide (Comments)","tags":["Focus · Instagram"],"description":"Unhide. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-unhide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/comments/{itemId}/like":{"post":{"operationId":"instagramCommentsLike","summary":"Instagram: Like (Comments)","tags":["Focus · Instagram"],"description":"Like. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/comments/{itemId}/unlike":{"post":{"operationId":"instagramCommentsUnlike","summary":"Instagram: Unlike (Comments)","tags":["Focus · Instagram"],"description":"Unlike. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/comments/{itemId}/private-reply":{"post":{"operationId":"instagramCommentsPrivateReply","summary":"Instagram: Reply privately (DM) (Comments)","tags":["Focus · Instagram"],"description":"One DM per comment within 7 days; buttons may be refused for non-followers. Moderation queue across recent media (or one post with media_id). Reply, hide/unhide, delete, like (Facebook Login), private reply by DM (7 days, once per comment). Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/comment-moderation Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":["string","null"],"maxLength":1000,"description":"≤1000 bytes; URLs must be valid"},"attachment":{"type":["object","null"],"properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":["string","null"],"format":"uri"},"media_id":{"type":["string","null"]},"attachment_id":{"type":["string","null"],"description":"Reusable id from the Attachment Upload API"}}},"attachments":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":"string","enum":["image"]},"url":{"type":"string","format":"uri"}}},"maxItems":10,"description":"Multi-image message (≤10 images)"},"quick_replies":{"type":["array","null"],"items":{"type":"object","properties":{"title":{"type":"string","maxLength":20},"payload":{"type":["string","null"]}}},"maxItems":13},"buttons":{"type":["array","null"],"items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":["string","null"],"format":"uri"},"payload":{"type":["string","null"]}}},"maxItems":3},"elements":{"type":["array","null"],"items":{"type":"object","properties":{"title":{"type":"string"},"subtitle":{"type":["string","null"]},"image_url":{"type":["string","null"],"format":"uri"},"buttons":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"url":{"type":["string","null"],"format":"uri"},"payload":{"type":["string","null"]}}}}}},"maxItems":10,"description":"Generic template carousel"},"sticker":{"type":["string","null"],"enum":["like_heart",null]},"media_share_id":{"type":["string","null"],"description":"Own post id to share (MEDIA_SHARE)"},"reply_to":{"type":["string","null"],"description":"Message id to reply to"},"human_agent":{"type":["boolean","null"],"description":"Send with the HUMAN_AGENT tag (up to 7 days after the last user message; needs the Human Agent feature)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-comments-private-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/mentions":{"get":{"operationId":"instagramMentionsList","summary":"Instagram: List Mentions & tags","tags":["Focus · Instagram"],"description":"Media you are tagged in. Caption/comment @mentions arrive by webhook; look them up by id and reply here. Story mentions arrive as DMs. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions Generic route: `/v1/accounts/{accountId}/focus/mentions`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"Cursor from next_cursor"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-mentions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/mentions/{itemId}":{"get":{"operationId":"instagramMentionsGet","summary":"Instagram: Get a Mentions & tags item","tags":["Focus · Instagram"],"description":"Mentioned media by id (from the mentions webhook). Media you are tagged in. Caption/comment @mentions arrive by webhook; look them up by id and reply here. Story mentions arrive as DMs. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions Generic route: `/v1/accounts/{accountId}/focus/mentions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-mentions-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/mentions/{itemId}/reply":{"post":{"operationId":"instagramMentionsReply","summary":"Instagram: Reply to mention (Mentions & tags)","tags":["Focus · Instagram"],"description":"Reply on the caption (no comment_id) or on the mentioning comment. Media you are tagged in. Caption/comment @mentions arrive by webhook; look them up by id and reply here. Story mentions arrive as DMs. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment_id":{"type":["string","null"]},"message":{"type":"string","maxLength":2200}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-mentions-reply","x-idempotent":true,"x-zernio":["POST /v1/inbox/mentions/reply","POST /v1/inbox/posts/{postId}/like","DELETE /v1/inbox/posts/{postId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/mentions/mentioned-comment":{"post":{"operationId":"instagramMentionsMentionedComment","summary":"Instagram: Look up mentioning comment (Mentions & tags)","tags":["Focus · Instagram"],"description":"Look up mentioning comment. Media you are tagged in. Caption/comment @mentions arrive by webhook; look them up by id and reply here. Story mentions arrive as DMs. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment_id":{"type":"string"}},"required":["comment_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-mentions-mentioned-comment","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/mentions/{itemId}/like":{"post":{"operationId":"instagramMentionsLike","summary":"Instagram: Like (Mentions & tags)","tags":["Focus · Instagram"],"description":"Like. Media you are tagged in. Caption/comment @mentions arrive by webhook; look them up by id and reply here. Story mentions arrive as DMs. Requires scopes: instagram_basic, instagram_manage_engagement. Requires one of: instagram_business_manage_comments | instagram_manage_comments. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/mentions Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-mentions-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/conversations":{"get":{"operationId":"instagramConversationsList","summary":"Instagram: List Direct","tags":["Focus · Instagram"],"description":"1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"Cursor from next_cursor"},{"schema":{"type":["string","null"]},"in":"query","name":"user_id","required":false,"description":"IGSID: find the thread with this user"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-conversations-list","x-zernio":["GET /v1/inbox/conversations","GET /v1/inbox/conversations/{conversationId}/messages"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"updated_at":{"type":"string","format":"date-time"},"unread_count":{"type":"integer"},"last_message":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]}}}},"participant":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]}}},"messages":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":["null","string"]},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":"string","format":"date-time"},"from_id":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"],"format":"uri"}}}},"reply_to":{"type":["null","string"]},"story_reply":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}}}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/conversations/{itemId}":{"get":{"operationId":"instagramConversationsGet","summary":"Instagram: Get a Direct item","tags":["Focus · Instagram"],"description":"Thread with messages. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-conversations-get","x-zernio":["GET /v1/inbox/conversations/{conversationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"updated_at":{"type":"string","format":"date-time"},"unread_count":{"type":"integer"},"last_message":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]}}}},"participant":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"username":{"type":["null","string"]}}},"messages":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":["null","string"]},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":"string","format":"date-time"},"from_id":{"type":["null","string"]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":["null","string"],"format":"uri"}}}},"reply_to":{"type":["null","string"]},"story_reply":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/conversations/{itemId}/send":{"post":{"operationId":"instagramConversationsSend","summary":"Instagram: Send message (Direct)","tags":["Focus · Instagram"],"description":"Send message. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipient_id":{"type":["string","null"]},"text":{"type":["string","null"],"maxLength":1000,"description":"≤1000 bytes; URLs must be valid"},"attachment":{"type":["object","null"],"properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":["string","null"],"format":"uri"},"media_id":{"type":["string","null"]},"attachment_id":{"type":["string","null"],"description":"Reusable id from the Attachment Upload API"}}},"attachments":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":"string","enum":["image"]},"url":{"type":"string","format":"uri"}}},"maxItems":10,"description":"Multi-image message (≤10 images)"},"quick_replies":{"type":["array","null"],"items":{"type":"object","properties":{"title":{"type":"string","maxLength":20},"payload":{"type":["string","null"]}}},"maxItems":13},"buttons":{"type":["array","null"],"items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":["string","null"],"format":"uri"},"payload":{"type":["string","null"]}}},"maxItems":3},"elements":{"type":["array","null"],"items":{"type":"object","properties":{"title":{"type":"string"},"subtitle":{"type":["string","null"]},"image_url":{"type":["string","null"],"format":"uri"},"buttons":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"url":{"type":["string","null"],"format":"uri"},"payload":{"type":["string","null"]}}}}}},"maxItems":10,"description":"Generic template carousel"},"sticker":{"type":["string","null"],"enum":["like_heart",null]},"media_share_id":{"type":["string","null"],"description":"Own post id to share (MEDIA_SHARE)"},"reply_to":{"type":["string","null"],"description":"Message id to reply to"},"human_agent":{"type":["boolean","null"],"description":"Send with the HUMAN_AGENT tag (up to 7 days after the last user message; needs the Human Agent feature)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-conversations-send","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/messages","POST /v1/inbox/conversations/{conversationId}/typing","POST /v1/inbox/conversations/{conversationId}/read","POST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions","DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/conversations/{itemId}/react":{"post":{"operationId":"instagramConversationsReact","summary":"Instagram: React (Direct)","tags":["Focus · Instagram"],"description":"React. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message_id":{"type":"string"},"reaction":{"type":["string","null"],"default":"love","description":"Emoji or \"love\""},"recipient_id":{"type":["string","null"]}},"required":["message_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-conversations-react","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/conversations/{itemId}/unreact":{"post":{"operationId":"instagramConversationsUnreact","summary":"Instagram: Remove reaction (Direct)","tags":["Focus · Instagram"],"description":"Remove reaction. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message_id":{"type":"string"},"recipient_id":{"type":["string","null"]}},"required":["message_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-conversations-unreact","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/conversations/{itemId}/typing":{"post":{"operationId":"instagramConversationsTyping","summary":"Instagram: Typing indicator (Direct)","tags":["Focus · Instagram"],"description":"Typing indicator. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"on":{"type":["boolean","null"],"default":true},"recipient_id":{"type":["string","null"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-conversations-typing","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/conversations/{itemId}/mark-seen":{"post":{"operationId":"instagramConversationsMarkSeen","summary":"Instagram: Mark as seen (Direct)","tags":["Focus · Instagram"],"description":"Mark as seen. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipient_id":{"type":["string","null"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-conversations-mark-seen","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/conversations/{itemId}/block":{"post":{"operationId":"instagramConversationsBlock","summary":"Instagram: Block user (Direct)","tags":["Focus · Instagram"],"description":"Block user. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Destructive. Requires scopes: instagram_basic, instagram_manage_messages, business_management. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipient_id":{"type":["string","null"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_instagram","x-mcp-tool":"instagram-conversations-block","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/conversations/{itemId}/unblock":{"post":{"operationId":"instagramConversationsUnblock","summary":"Instagram: Unblock user (Direct)","tags":["Focus · Instagram"],"description":"Unblock user. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Requires scopes: instagram_basic, instagram_manage_messages, business_management. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipient_id":{"type":["string","null"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-conversations-unblock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/conversations/{itemId}/spam":{"post":{"operationId":"instagramConversationsSpam","summary":"Instagram: Move to spam (Direct)","tags":["Focus · Instagram"],"description":"Move to spam. 1:1 Direct threads (≈20 newest messages readable). Replies within 24 h of the last user message; HUMAN_AGENT tag up to 7 days. Requests-folder threads inactive >30 days are hidden. Destructive. Requires scopes: instagram_basic, instagram_manage_messages, business_management. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recipient_id":{"type":["string","null"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_instagram","x-mcp-tool":"instagram-conversations-spam","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/ice-breakers":{"get":{"operationId":"instagramIceBreakersGet","summary":"Instagram: Get Ice breakers","tags":["Focus · Instagram"],"description":"Up to 4 FAQ questions shown when someone opens a new conversation (per locale). Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/ice-breakers Generic route: `/v1/accounts/{accountId}/focus/ice-breakers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-ice-breakers-get","x-zernio":["GET /v1/accounts/{accountId}/instagram-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ice_breakers":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string","maxLength":80},"payload":{"type":["null","string"]}},"required":["question"]},"maxItems":4}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"instagramIceBreakersUpdate","summary":"Instagram: Update Ice breakers","tags":["Focus · Instagram"],"description":"Up to 4 FAQ questions shown when someone opens a new conversation (per locale). Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/ice-breakers Generic route: `/v1/accounts/{accountId}/focus/ice-breakers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ice_breakers":{"type":"array","items":{"type":"object","properties":{"locale":{"type":["string","null"]},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string","maxLength":80},"payload":{"type":["string","null"]}},"required":["question"]},"maxItems":4}}}},"questions":{"type":["array","null"],"items":{"type":"object","properties":{"question":{"type":"string","maxLength":80},"payload":{"type":["string","null"]}},"required":["question"]},"maxItems":4}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_instagram","x-mcp-tool":"instagram-ice-breakers-update","x-zernio":["PUT /v1/accounts/{accountId}/instagram-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ice_breakers":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string","maxLength":80},"payload":{"type":["null","string"]}},"required":["question"]},"maxItems":4}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"instagramIceBreakersDelete","summary":"Instagram: Delete Ice breakers","tags":["Focus · Instagram"],"description":"Up to 4 FAQ questions shown when someone opens a new conversation (per locale). Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/ice-breakers Generic route: `/v1/accounts/{accountId}/focus/ice-breakers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_instagram","x-mcp-tool":"instagram-ice-breakers-delete","x-zernio":["DELETE /v1/accounts/{accountId}/instagram-ice-breakers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/persistent-menu":{"get":{"operationId":"instagramPersistentMenuGet","summary":"Instagram: Get Persistent menu","tags":["Focus · Instagram"],"description":"Menu of web links and postbacks available in every conversation. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/persistent-menu Generic route: `/v1/accounts/{accountId}/focus/persistent-menu`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-persistent-menu-get","x-zernio":["GET /v1/accounts/{accountId}/messenger-menu"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"persistent_menu":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"composer_input_disabled":{"type":["null","boolean"]},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":["null","string"],"format":"uri"},"payload":{"type":["null","string"]}},"required":["title"]}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"instagramPersistentMenuUpdate","summary":"Instagram: Update Persistent menu","tags":["Focus · Instagram"],"description":"Menu of web links and postbacks available in every conversation. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/persistent-menu Generic route: `/v1/accounts/{accountId}/focus/persistent-menu`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_instagram","x-mcp-tool":"instagram-persistent-menu-update","x-zernio":["PUT /v1/accounts/{accountId}/messenger-menu"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"persistent_menu":{"type":"array","items":{"type":"object","properties":{"locale":{"type":"string","default":"default"},"composer_input_disabled":{"type":["null","boolean"]},"call_to_actions":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":["null","string"],"format":"uri"},"payload":{"type":["null","string"]}},"required":["title"]}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"instagramPersistentMenuDelete","summary":"Instagram: Delete Persistent menu","tags":["Focus · Instagram"],"description":"Menu of web links and postbacks available in every conversation. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/persistent-menu Generic route: `/v1/accounts/{accountId}/focus/persistent-menu`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_instagram","x-mcp-tool":"instagram-persistent-menu-delete","x-zernio":["DELETE /v1/accounts/{accountId}/messenger-menu"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/people/{itemId}":{"get":{"operationId":"instagramPeopleGet","summary":"Instagram: Get a People item","tags":["Focus · Instagram"],"description":"Profile and follow status of a user who messaged the account (by IGSID). Requires one of: instagram_business_manage_messages | instagram_manage_messages. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api/user-profile Generic route: `/v1/accounts/{accountId}/focus/people`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-people-get","x-zernio":["GET /v1/accounts/{accountId}/follow-status/{userId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"},"username":{"type":["null","string"]},"name":{"type":["null","string"]},"is_follower":{"type":["null","boolean"]},"is_followed_by_account":{"type":["null","boolean"]},"follower_count":{"type":["null","integer"]},"is_verified":{"type":["null","boolean"]},"unavailable_reason":{"type":["null","string"],"enum":["consent_required","dm_access_disabled","not_messageable","error",null]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/message-attachments":{"post":{"operationId":"instagramMessageAttachmentsCreate","summary":"Instagram: Create a Reusable attachments item","tags":["Focus · Instagram"],"description":"Upload media once and reuse its attachment_id in DMs. Requires one of: instagram_business_manage_messages | instagram_manage_messages. Generic route: `/v1/accounts/{accountId}/focus/message-attachments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["image","video","audio","file"]},"url":{"type":"string","format":"uri"}},"required":["url"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-message-attachments-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"attachment_id":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/account-insights":{"get":{"operationId":"instagramAccountInsightsGet","summary":"Instagram: Get Account","tags":["Focus · Instagram"],"description":"Views, reach, accounts engaged, interactions (likes, comments, saves, shares, replies, reposts), follows/unfollows and profile link taps. Max 90 days, up to 48 h delay; only reach has a daily series. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/api-reference/instagram-user/insights Generic route: `/v1/accounts/{accountId}/focus/account-insights`.","parameters":[{"schema":{"type":["string","null"],"format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":["string","null"],"format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":["array","null"],"items":{"type":"string","enum":["views","reach","accounts_engaged","total_interactions","likes","comments","saves","shares","replies","reposts","follows_and_unfollows","profile_links_taps","follower_count"]}},"in":"query","name":"metrics","required":false},{"schema":{"type":["string","null"],"enum":["total_value","time_series",null],"default":"total_value"},"in":"query","name":"metric_type","required":false},{"schema":{"type":["string","null"],"enum":["media_product_type","follow_type","contact_button_type",null]},"in":"query","name":"breakdown","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-account-insights-get","x-zernio":["GET /v1/analytics/instagram/account-insights"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"date_range":{"type":"object","properties":{"since":{"type":"string"},"until":{"type":"string"}}},"metric_type":{"type":"string","enum":["total_value","time_series"]},"breakdown":{"type":["null","string"]},"metrics":{"type":"object","additionalProperties":{"type":"object","properties":{"total":{"type":["null","number"]},"values":{"type":["null","array"],"items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"value":{"type":"number"}}}},"breakdown":{"type":["null","array"],"items":{"type":"object","properties":{"dimensions":{"type":"array","items":{"type":"string"}},"value":{"type":"number"}}}}}}},"unavailable_metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/account-insights/summary":{"post":{"operationId":"instagramAccountInsightsSummary","summary":"Instagram: Normalized summary (Account)","tags":["Focus · Instagram"],"description":"Normalized summary. Views, reach, accounts engaged, interactions (likes, comments, saves, shares, replies, reposts), follows/unfollows and profile link taps. Max 90 days, up to 48 h delay; only reach has a daily series. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/api-reference/instagram-user/insights Generic route: `/v1/accounts/{accountId}/focus/account-insights`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":["string","null"],"format":"date-time"},"until":{"type":["string","null"],"format":"date-time"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-account-insights-summary","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/content-insights":{"get":{"operationId":"instagramContentInsightsList","summary":"Instagram: List Content","tags":["Focus · Instagram"],"description":"Per-post performance ranked by a metric: views, reach, interactions, Reels watch time and skip rate. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/reference/instagram-media/insights Generic route: `/v1/accounts/{accountId}/focus/content-insights`.","parameters":[{"schema":{"type":["string","null"],"format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":["string","null"],"format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":["integer","null"],"default":25,"maximum":50},"in":"query","name":"limit","required":false},{"schema":{"type":["string","null"],"enum":["views","reach","likes","comments","shares","saves","engagements","engagement_rate",null]},"in":"query","name":"metric","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-content-insights-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"caption":{"type":["null","string"]},"media_product_type":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"timestamp":{"type":"string","format":"date-time"},"views":{"type":["null","number"]},"reach":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/content-insights/{itemId}":{"get":{"operationId":"instagramContentInsightsGet","summary":"Instagram: Get a Content item","tags":["Focus · Instagram"],"description":"Raw insights for one media. Per-post performance ranked by a metric: views, reach, interactions, Reels watch time and skip rate. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/reference/instagram-media/insights Generic route: `/v1/accounts/{accountId}/focus/content-insights`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-content-insights-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"caption":{"type":["null","string"]},"media_product_type":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"timestamp":{"type":"string","format":"date-time"},"views":{"type":["null","number"]},"reach":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]},"saves":{"type":["null","number"]},"engagements":{"type":["null","number"]},"engagement_rate":{"type":["null","number"]},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/audience":{"get":{"operationId":"instagramAudienceGet","summary":"Instagram: Get Audience","tags":["Focus · Instagram"],"description":"Follower or engaged-audience demographics by age, gender, country and city (top 45; ≥100 followers). Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/api-reference/instagram-user/insights Generic route: `/v1/accounts/{accountId}/focus/audience`.","parameters":[{"schema":{"type":["string","null"],"enum":["follower_demographics","engaged_audience_demographics",null],"default":"follower_demographics"},"in":"query","name":"metric","required":false},{"schema":{"type":["string","null"],"enum":["this_week","this_month","prev_month","last_14_days","last_30_days","last_90_days",null],"default":"this_month"},"in":"query","name":"timeframe","required":false},{"schema":{"type":["array","null"],"items":{"type":"string","enum":["age","gender","country","city"]}},"in":"query","name":"breakdown","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-audience-get","x-zernio":["GET /v1/analytics/instagram/demographics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"metric":{"type":"string","enum":["follower_demographics","engaged_audience_demographics"]},"timeframe":{"type":"string","enum":["this_week","this_month","prev_month","last_14_days","last_30_days","last_90_days"]},"demographics":{"type":"object","properties":{"age":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"number"}}}},"gender":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"number"}}}},"country":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"number"}}}},"city":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"number"}}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/online-followers":{"get":{"operationId":"instagramOnlineFollowersGet","summary":"Instagram: Get Best time to post","tags":["Focus · Instagram"],"description":"Hourly online followers for each of the last 30 days, with the best hours. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/api-reference/instagram-user/insights Generic route: `/v1/accounts/{accountId}/focus/online-followers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-online-followers-get","x-zernio":["GET /v1/analytics/instagram/online-followers"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"hours":{"type":"object","additionalProperties":{"type":"number"}}}}},"average_by_hour":{"type":"array","items":{"type":"object","properties":{"hour":{"type":"integer","minimum":0,"maximum":23},"value":{"type":"number"}}}},"best_hours":{"type":"array","items":{"type":"integer"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/follower-history":{"get":{"operationId":"instagramFollowerHistoryGet","summary":"Instagram: Get Followers","tags":["Focus · Instagram"],"description":"Follower totals (Socialit daily snapshots) with new followers per day (Instagram, last 30 days) and derived unfollows. Requires one of: instagram_business_manage_insights | instagram_manage_insights. Network docs: https://developers.facebook.com/documentation/instagram-platform/api-reference/instagram-user/insights Generic route: `/v1/accounts/{accountId}/focus/follower-history`.","parameters":[{"schema":{"type":["string","null"],"format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":["string","null"],"format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-follower-history-get","x-zernio":["GET /v1/analytics/instagram/follower-history"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"current_followers":{"type":["null","integer"]},"metrics":{"type":"object","properties":{"follower_count":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"value":{"type":"number"}}}},"followers_gained":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"value":{"type":"number"}}}},"followers_lost":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"value":{"type":"number"}}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/hashtags":{"get":{"operationId":"instagramHashtagsList","summary":"Instagram: List Hashtag search","tags":["Focus · Instagram"],"description":"Recently searched hashtags (7-day window). Top and recent (24 h) public media for a hashtag. 30 unique hashtags per rolling 7 days; requires the Instagram Public Content Access feature (App Review). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/hashtag-search Generic route: `/v1/accounts/{accountId}/focus/hashtags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-hashtags-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"instagramHashtagsCreate","summary":"Instagram: Create a Hashtag search item","tags":["Focus · Instagram"],"description":"Search a hashtag (counts toward the 30/7-day budget). Top and recent (24 h) public media for a hashtag. 30 unique hashtags per rolling 7 days; requires the Instagram Public Content Access feature (App Review). Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/hashtag-search Generic route: `/v1/accounts/{accountId}/focus/hashtags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","description":"Hashtag without #"}},"required":["q"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-hashtags-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/hashtags/{itemId}":{"get":{"operationId":"instagramHashtagsGet","summary":"Instagram: Get a Hashtag search item","tags":["Focus · Instagram"],"description":"Top and recent (24 h) public media for a hashtag. 30 unique hashtags per rolling 7 days; requires the Instagram Public Content Access feature (App Review). Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/hashtag-search Generic route: `/v1/accounts/{accountId}/focus/hashtags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-hashtags-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/hashtags/{itemId}/top-media":{"post":{"operationId":"instagramHashtagsTopMedia","summary":"Instagram: Top media (Hashtag search)","tags":["Focus · Instagram"],"description":"Top media. Top and recent (24 h) public media for a hashtag. 30 unique hashtags per rolling 7 days; requires the Instagram Public Content Access feature (App Review). Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/hashtag-search Generic route: `/v1/accounts/{accountId}/focus/hashtags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":25},"after":{"type":"string","description":"Cursor from next_cursor"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-hashtags-top-media","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/hashtags/{itemId}/recent-media":{"post":{"operationId":"instagramHashtagsRecentMedia","summary":"Instagram: Recent media (24 h) (Hashtag search)","tags":["Focus · Instagram"],"description":"Recent media (24 h). Top and recent (24 h) public media for a hashtag. 30 unique hashtags per rolling 7 days; requires the Instagram Public Content Access feature (App Review). Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/hashtag-search Generic route: `/v1/accounts/{accountId}/focus/hashtags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":25},"after":{"type":"string","description":"Cursor from next_cursor"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-hashtags-recent-media","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/business-discovery/{itemId}":{"get":{"operationId":"instagramBusinessDiscoveryGet","summary":"Instagram: Get a Competitors item","tags":["Focus · Instagram"],"description":"Public profile and recent media of another Business/Creator account (not private, personal or age-gated). Reels include cross-app view_count. Requires scopes: instagram_basic. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/business_discovery Generic route: `/v1/accounts/{accountId}/focus/business-discovery`.","parameters":[{"schema":{"type":["integer","null"],"default":12,"maximum":50},"in":"query","name":"limit","required":false},{"schema":{"type":["string","null"]},"in":"query","name":"after","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-business-discovery-get","x-zernio":["GET /v1/accounts/{accountId}/instagram/business-discovery"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"name":{"type":["null","string"]},"biography":{"type":["null","string"]},"website":{"type":["null","string"],"format":"uri"},"profile_picture_url":{"type":["null","string"],"format":"uri"},"followers_count":{"type":["null","integer"]},"follows_count":{"type":["null","integer"]},"media_count":{"type":["null","integer"]}}},"media":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"caption":{"type":["null","string"],"maxLength":2200},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_product_type":{"type":"string","enum":["FEED","REELS","STORY","AD"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"permalink":{"type":["null","string"],"format":"uri"},"shortcode":{"type":["null","string"]},"timestamp":{"type":"string","format":"date-time"},"username":{"type":["null","string"]},"like_count":{"type":["null","integer"]},"comments_count":{"type":["null","integer"]},"is_comment_enabled":{"type":["null","boolean"]},"is_shared_to_feed":{"type":["null","boolean"]},"alt_text":{"type":["null","string"]},"children":{"type":["null","array"],"items":{"type":"object","properties":{"id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL_ALBUM"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"}}}},"reposts_count":{"type":["null","integer"],"description":"Facebook Login only"},"saved_count":{"type":["null","integer"],"description":"Facebook Login only"},"shares_count":{"type":["null","integer"],"description":"Facebook Login only"},"media_audio_type":{"type":["null","string"],"enum":["MUSIC","ORIGINAL_SOUND",null]},"is_ai_generated":{"type":["null","boolean"]},"view_count":{"type":["null","integer"]}},"required":["id"]}},"next_cursor":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/oembed":{"post":{"operationId":"instagramOembedCreate","summary":"Instagram: Create a Embed item","tags":["Focus · Instagram"],"description":"Embed HTML for a public Instagram post or Reel URL. Network docs: https://developers.facebook.com/docs/instagram-platform/oembed Generic route: `/v1/accounts/{accountId}/focus/oembed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"maxwidth":{"type":["integer","null"]},"hidecaption":{"type":["boolean","null"]},"omitscript":{"type":["boolean","null"]}},"required":["url"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_instagram","x-mcp-tool":"instagram-oembed-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"},"provider_name":{"type":["null","string"]},"width":{"type":["null","integer"]},"type":{"type":["null","string"]},"version":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/catalogs":{"get":{"operationId":"instagramCatalogsList","summary":"Instagram: List Catalogs","tags":["Focus · Instagram"],"description":"Catalogs eligible for product tagging (approved Instagram Shop; user must be catalog admin). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: `/v1/accounts/{accountId}/focus/catalogs`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-catalogs-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"catalog_id":{"type":"string"},"catalog_name":{"type":["null","string"]},"shop_name":{"type":["null","string"]},"product_count":{"type":["null","integer"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/catalog-products":{"get":{"operationId":"instagramCatalogProductsList","summary":"Instagram: List Products","tags":["Focus · Instagram"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: `/v1/accounts/{accountId}/focus/catalog-products`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"after","required":false,"description":"Cursor from next_cursor"},{"schema":{"type":"string"},"in":"query","name":"catalog_id","required":false},{"schema":{"type":["string","null"]},"in":"query","name":"q","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-catalog-products-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string"},"merchant_id":{"type":["null","string"]},"product_name":{"type":["null","string"]},"image_url":{"type":["null","string"],"format":"uri"},"retailer_id":{"type":["null","string"]},"review_status":{"type":["null","string"]},"is_checkout_flow":{"type":["null","boolean"]},"product_variants":{"type":["null","array"],"items":{"type":"object","properties":{"product_id":{"type":"string"},"variant_name":{"type":["null","string"]}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/catalog-products/{itemId}/appeal":{"post":{"operationId":"instagramCatalogProductsAppeal","summary":"Instagram: Appeal rejection (Products)","tags":["Focus · Instagram"],"description":"Appeal rejection. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: `/v1/accounts/{accountId}/focus/catalog-products`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"appeal_reason":{"type":["string","null"],"description":"Omit to read the appeal status"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_instagram","x-mcp-tool":"instagram-catalog-products-appeal","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/product-tags/{itemId}":{"get":{"operationId":"instagramProductTagsGet","summary":"Instagram: Get a Product tags item","tags":["Focus · Instagram"],"description":"Product tags on a published media item (by media id), with review status. ≤5 per item. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: `/v1/accounts/{accountId}/focus/product-tags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_instagram","x-mcp-tool":"instagram-product-tags-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string"},"tags":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string"},"name":{"type":["null","string"]},"x":{"type":["null","number"]},"y":{"type":["null","number"]},"review_status":{"type":["null","string"]}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"instagramProductTagsUpdate","summary":"Instagram: Update a Product tags item","tags":["Focus · Instagram"],"description":"Product tags on a published media item (by media id), with review status. ≤5 per item. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: `/v1/accounts/{accountId}/focus/product-tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string"},"x":{"type":["number","null"],"minimum":0,"maximum":1},"y":{"type":["number","null"],"minimum":0,"maximum":1}},"required":["product_id"]},"maxItems":5}},"required":["tags"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_instagram","x-mcp-tool":"instagram-product-tags-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string"},"tags":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string"},"name":{"type":["null","string"]},"x":{"type":["null","number"]},"y":{"type":["null","number"]},"review_status":{"type":["null","string"]}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/instagram/product-tags/{itemId}/remove":{"post":{"operationId":"instagramProductTagsRemove","summary":"Instagram: Remove tags (Product tags)","tags":["Focus · Instagram"],"description":"Remove tags. Product tags on a published media item (by media id), with review status. ≤5 per item. Destructive. Requires scopes: instagram_basic, instagram_shopping_tag_products, catalog_management. Network docs: https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login/product-tagging Generic route: `/v1/accounts/{accountId}/focus/product-tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_ids":{"type":"array","items":{"type":"string"}}},"required":["product_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_instagram","x-mcp-tool":"instagram-product-tags-remove","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/profile":{"get":{"operationId":"linkedinProfileGet","summary":"LinkedIn: Get Profile","tags":["Focus · LinkedIn"],"description":"Get the profile or Page details. The connected member profile or LinkedIn Page. LinkedIn does not expose Page editing in the versioned API; edit details on linkedin.com. Requires one of: r_basicprofile | profile | rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-lookup-api Generic route: `/v1/accounts/{accountId}/focus/profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"urn":{"type":"string"},"account_type":{"type":"string","enum":["organization","member"]},"name":{"type":"string"},"vanity_name":{"type":["null","string"]},"headline":{"type":["null","string"],"description":"Member headline"},"description":{"type":["null","string"]},"website":{"type":["null","string"],"format":"uri"},"industries":{"type":"array","items":{"type":"string"}},"staff_count_range":{"type":["null","string"]},"organization_type":{"type":["null","string"]},"primary_organization_type":{"type":["null","string"]},"founded_on":{"type":["null","object"],"properties":{"year":{"type":"integer"},"month":{"type":"integer"},"day":{"type":"integer"}}},"specialties":{"type":"array","items":{"type":"string"}},"locations":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string"},"country":{"type":"string"},"line1":{"type":"string"},"postal_code":{"type":"string"},"headquarter":{"type":"boolean"}}}},"logo_url":{"type":["null","string"],"format":"uri"},"cover_photo":{"type":["null","string"]},"followers":{"type":["null","integer"]},"connections":{"type":["null","integer"],"description":"First-degree connections (r_1st_connections_size)"},"profile_url":{"type":"string","format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/organizations":{"get":{"operationId":"linkedinOrganizationsList","summary":"LinkedIn: List Pages","tags":["Focus · LinkedIn"],"description":"List administered Pages. LinkedIn Pages the member holds a role on. Switch this connection between the personal profile and a Page. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: rw_organization_admin | r_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: `/v1/accounts/{accountId}/focus/organizations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-organizations-list","x-zernio":["GET /v1/accounts/{accountId}/linkedin-organizations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"urn":{"type":"string"},"name":{"type":"string"},"localizedName":{"type":"string"},"vanityName":{"type":["null","string"]},"logoUrl":{"type":["null","string"],"format":"uri"},"roles":{"type":"array","items":{"type":"string","enum":["ADMINISTRATOR","CONTENT_ADMINISTRATOR","DIRECT_SPONSORED_CONTENT_POSTER","RECRUITING_POSTER","LEAD_CAPTURE_ADMINISTRATOR","LEAD_GEN_FORMS_MANAGER","ANALYST","CURATOR"]}},"canPost":{"type":"boolean"},"isAdmin":{"type":"boolean"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/organizations/{itemId}":{"get":{"operationId":"linkedinOrganizationsGet","summary":"LinkedIn: Get a Pages item","tags":["Focus · LinkedIn"],"description":"LinkedIn Pages the member holds a role on. Switch this connection between the personal profile and a Page. Requires one of: rw_organization_admin | r_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: `/v1/accounts/{accountId}/focus/organizations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-organizations-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"urn":{"type":"string"},"name":{"type":"string"},"localizedName":{"type":"string"},"vanityName":{"type":["null","string"]},"logoUrl":{"type":["null","string"],"format":"uri"},"roles":{"type":"array","items":{"type":"string","enum":["ADMINISTRATOR","CONTENT_ADMINISTRATOR","DIRECT_SPONSORED_CONTENT_POSTER","RECRUITING_POSTER","LEAD_CAPTURE_ADMINISTRATOR","LEAD_GEN_FORMS_MANAGER","ANALYST","CURATOR"]}},"canPost":{"type":"boolean"},"isAdmin":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/organizations/{itemId}/switch-to-organization":{"post":{"operationId":"linkedinOrganizationsSwitchToOrganization","summary":"LinkedIn: Use this Page (Pages)","tags":["Focus · LinkedIn"],"description":"Switch the connection to act as this Page. LinkedIn Pages the member holds a role on. Switch this connection between the personal profile and a Page. Requires scopes: w_organization_social. Requires one of: rw_organization_admin | r_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: `/v1/accounts/{accountId}/focus/organizations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-organizations-switch-to-organization","x-idempotent":true,"x-zernio":["PUT /v1/accounts/{accountId}/linkedin-organization"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/organizations/switch-to-personal":{"post":{"operationId":"linkedinOrganizationsSwitchToPersonal","summary":"LinkedIn: Use personal profile (Pages)","tags":["Focus · LinkedIn"],"description":"Use personal profile. LinkedIn Pages the member holds a role on. Switch this connection between the personal profile and a Page. Requires scopes: w_member_social. Requires one of: rw_organization_admin | r_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: `/v1/accounts/{accountId}/focus/organizations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-organizations-switch-to-personal","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/brands":{"get":{"operationId":"linkedinBrandsList","summary":"LinkedIn: List Showcase pages","tags":["Focus · LinkedIn"],"description":"Brand / showcase pages under the organization that the member administers. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: rw_organization_admin. Generic route: `/v1/accounts/{accountId}/focus/brands`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-brands-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"urn":{"type":"string"},"name":{"type":"string"},"vanity_name":{"type":["null","string"]},"type":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/admins":{"get":{"operationId":"linkedinAdminsList","summary":"LinkedIn: List Page admins","tags":["Focus · LinkedIn"],"description":"Members holding roles on the Page (organizationAcls). The API only lets a member request the DSC poster role for themselves; assign other roles on linkedin.com. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: `/v1/accounts/{accountId}/focus/admins`.","parameters":[{"schema":{"type":"string","enum":["ADMINISTRATOR","CONTENT_ADMINISTRATOR","DIRECT_SPONSORED_CONTENT_POSTER","RECRUITING_POSTER","LEAD_CAPTURE_ADMINISTRATOR","LEAD_GEN_FORMS_MANAGER","ANALYST","CURATOR"]},"in":"query","name":"role","required":false},{"schema":{"type":"string","enum":["APPROVED","REQUESTED","REJECTED","REVOKED"]},"in":"query","name":"state","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor (start offset) from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-admins-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organization":{"type":"string"},"role_assignee":{"type":"string","description":"urn:li:person:…"},"role":{"type":"string","enum":["ADMINISTRATOR","CONTENT_ADMINISTRATOR","DIRECT_SPONSORED_CONTENT_POSTER","RECRUITING_POSTER","LEAD_CAPTURE_ADMINISTRATOR","LEAD_GEN_FORMS_MANAGER","ANALYST","CURATOR"]},"state":{"type":"string","enum":["APPROVED","REQUESTED","REJECTED","REVOKED"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/admins/request-dsc-role":{"post":{"operationId":"linkedinAdminsRequestDscRole","summary":"LinkedIn: Request DSC poster role (Page admins)","tags":["Focus · LinkedIn"],"description":"Request DSC poster role. Members holding roles on the Page (organizationAcls). The API only lets a member request the DSC poster role for themselves; assign other roles on linkedin.com. Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role Generic route: `/v1/accounts/{accountId}/focus/admins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organization_urn":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-admins-request-dsc-role","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/posts":{"get":{"operationId":"linkedinPostsList","summary":"LinkedIn: List Posts","tags":["Focus · LinkedIn"],"description":"List posts by author (newest first). Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","enum":["LAST_MODIFIED","CREATED"]},"in":"query","name":"sort_by","required":false},{"schema":{"type":"string","enum":["READER","AUTHOR"]},"in":"query","name":"view_context","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor (start offset) from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-posts-list","x-zernio":["GET /v1/accounts/{accountId}/posts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:share:… or urn:li:ugcPost:…"},"url":{"type":"string","format":"uri"},"author":{"type":"string"},"text":{"type":"string","maxLength":3000},"commentary":{"type":"string","description":"Raw little-text commentary"},"type":{"type":"string","enum":["text","image","multi_image","video","document","article","poll","reshare","event","celebration","carousel"]},"mentions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"urn":{"type":"string"}}}},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"urn":{"type":"string"},"title":{"type":["null","string"]},"alt_text":{"type":["null","string"]}}}},"article":{"type":["null","object"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"thumbnail":{"type":"string"}}},"poll":{"type":["null","object"],"properties":{"question":{"type":"string"},"duration":{"type":"string"},"unique_voters":{"type":"integer"},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"vote_count":{"type":["null","integer"]}}}}}},"event":{"type":["null","string"]},"reshare_parent":{"type":["null","string"]},"reshare_root":{"type":["null","string"]},"visibility":{"type":"string","enum":["PUBLIC","CONNECTIONS","LOGGED_IN"]},"feed_distribution":{"type":"string","enum":["MAIN_FEED","NONE"]},"targeted":{"type":"boolean"},"lifecycle_state":{"type":"string","enum":["PUBLISHED","DRAFT","PUBLISH_REQUESTED","PUBLISH_FAILED"]},"is_reshare_disabled":{"type":"boolean"},"edited":{"type":"boolean"},"cta_label":{"type":["null","string"],"enum":["APPLY","DOWNLOAD","VIEW_QUOTE","LEARN_MORE","SIGN_UP","SUBSCRIBE","REGISTER","JOIN","ATTEND","REQUEST_DEMO","SEE_MORE","BUY_NOW","SHOP_NOW",null]},"landing_page":{"type":["null","string"],"format":"uri"},"sponsored":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"linkedinPostsCreate","summary":"LinkedIn: Create a Posts item","tags":["Focus · LinkedIn"],"description":"Publish a post. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":3000},"media_ids":{"type":"array","items":{"type":"string"}},"first_comment":{"type":"string","maxLength":1250},"options":{"type":"object","additionalProperties":false,"properties":{"organizationUrn":{"type":"string","description":"Publish as this organization (urn:li:organization:<id>) instead of the account default. The member must be ADMINISTRATOR, CONTENT_ADMINISTRATOR or DSC poster."},"visibility":{"type":"string","enum":["PUBLIC","CONNECTIONS","LOGGED_IN"],"default":"PUBLIC","description":"CONNECTIONS is member-only."},"feedDistribution":{"type":"string","enum":["MAIN_FEED","NONE"],"default":"MAIN_FEED","description":"NONE creates a dark post (organizations; used for ads)."},"firstComment":{"type":"string","maxLength":1250,"description":"Posted as the author right after publishing."},"disableLinkPreview":{"type":"boolean","default":false,"description":"When false, a text post containing a URL becomes an article share built from the page OpenGraph tags."},"disableReshare":{"type":"boolean","default":false,"description":"isReshareDisabledByAuthor"},"disableComments":{"type":"boolean","default":false,"description":"Close comments after publishing (needs *_social_feed)."},"hashtags":{"type":"boolean","default":true,"description":"Keep #hashtags clickable (otherwise escaped as text)."},"mentions":{"type":"array","description":"Turn the first plain \"@Name\" into a mention. Inline @[Name](urn:li:…) syntax also works.","items":{"type":"object","required":["name","urn"],"properties":{"name":{"type":"string"},"urn":{"type":"string","pattern":"^urn:li:(person|organization|organizationBrand):"}}}},"documentTitle":{"type":"string","description":"Title of a document post (required by LinkedIn; defaults to media title or filename)."},"videoTitle":{"type":"string"},"thumbnailUrl":{"type":"string","format":"uri","description":"Custom video thumbnail (also media[].thumbnail)."},"waitForVideo":{"type":"boolean","default":true,"description":"Poll the video until AVAILABLE before creating the post."},"videoProcessingTimeoutMs":{"type":"integer","minimum":0,"default":600000},"reshareUrl":{"type":"string","description":"Post link or urn:li:share / ugcPost URN to repost. With text: repost with your thoughts. Mutually exclusive with media and polls."},"article":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"thumbnailUrl":{"type":"string","format":"uri"},"thumbnailUrn":{"type":"string","pattern":"^urn:li:image:"},"thumbnailAltText":{"type":"string","maxLength":4086}}},"poll":{"type":"object","required":["question","options"],"properties":{"question":{"type":"string","minLength":1,"maxLength":140},"options":{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":30}},"duration":{"type":"string","enum":["ONE_DAY","THREE_DAYS","SEVEN_DAYS","FOURTEEN_DAYS"],"default":"SEVEN_DAYS"}}},"eventUrn":{"type":"string","pattern":"^urn:li:(event|liveVideo):","description":"Share a LinkedIn Event (content.reference)."},"callToAction":{"type":"object","properties":{"label":{"type":"string","enum":["APPLY","DOWNLOAD","VIEW_QUOTE","LEARN_MORE","SIGN_UP","SUBSCRIBE","REGISTER","JOIN","ATTEND","REQUEST_DEMO","SEE_MORE","BUY_NOW","SHOP_NOW"]},"landingPage":{"type":"string","format":"uri"}}},"geoRestriction":{"type":"object","description":"Organizations only; audience must exceed 300 members.","properties":{"countries":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string","minLength":2,"maxLength":2}}}},"audience":{"type":"object","description":"Targeted organic post (distribution.targetEntities). Organizations only; OR within a facet, AND across facets; >300 members.","properties":{"countries":{"type":"array","maxItems":25,"items":{"type":"string"}},"geoLocations":{"type":"array","items":{"type":"string"}},"interfaceLocales":{"type":"array","items":{"type":"object","required":["language","country"],"properties":{"language":{"type":"string"},"country":{"type":"string"}}}},"industries":{"type":"array","items":{"type":"string"}},"jobFunctions":{"type":"array","items":{"type":"string"}},"seniorities":{"type":"array","items":{"type":"string"}},"staffCountRanges":{"type":"array","items":{"type":"string","enum":["SIZE_1","SIZE_2_TO_10","SIZE_11_TO_50","SIZE_51_TO_200","SIZE_201_TO_500","SIZE_501_TO_1000","SIZE_1001_TO_5000","SIZE_5001_TO_10000","SIZE_10001_OR_MORE"]}},"degrees":{"type":"array","items":{"type":"string"}},"fieldsOfStudy":{"type":"array","items":{"type":"string"}},"organizations":{"type":"array","items":{"type":"string"}}}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-posts-create","x-idempotent":true,"x-zernio":["POST /v1/posts/{postId}/edit","POST /v1/posts/{postId}/unpublish","POST /v1/posts/sync-external"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:share:… or urn:li:ugcPost:…"},"url":{"type":"string","format":"uri"},"author":{"type":"string"},"text":{"type":"string","maxLength":3000},"commentary":{"type":"string","description":"Raw little-text commentary"},"type":{"type":"string","enum":["text","image","multi_image","video","document","article","poll","reshare","event","celebration","carousel"]},"mentions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"urn":{"type":"string"}}}},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"urn":{"type":"string"},"title":{"type":["null","string"]},"alt_text":{"type":["null","string"]}}}},"article":{"type":["null","object"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"thumbnail":{"type":"string"}}},"poll":{"type":["null","object"],"properties":{"question":{"type":"string"},"duration":{"type":"string"},"unique_voters":{"type":"integer"},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"vote_count":{"type":["null","integer"]}}}}}},"event":{"type":["null","string"]},"reshare_parent":{"type":["null","string"]},"reshare_root":{"type":["null","string"]},"visibility":{"type":"string","enum":["PUBLIC","CONNECTIONS","LOGGED_IN"]},"feed_distribution":{"type":"string","enum":["MAIN_FEED","NONE"]},"targeted":{"type":"boolean"},"lifecycle_state":{"type":"string","enum":["PUBLISHED","DRAFT","PUBLISH_REQUESTED","PUBLISH_FAILED"]},"is_reshare_disabled":{"type":"boolean"},"edited":{"type":"boolean"},"cta_label":{"type":["null","string"],"enum":["APPLY","DOWNLOAD","VIEW_QUOTE","LEARN_MORE","SIGN_UP","SUBSCRIBE","REGISTER","JOIN","ATTEND","REQUEST_DEMO","SEE_MORE","BUY_NOW","SHOP_NOW",null]},"landing_page":{"type":["null","string"],"format":"uri"},"sponsored":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/posts/{itemId}":{"get":{"operationId":"linkedinPostsGet","summary":"LinkedIn: Get a Posts item","tags":["Focus · LinkedIn"],"description":"Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-posts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:share:… or urn:li:ugcPost:…"},"url":{"type":"string","format":"uri"},"author":{"type":"string"},"text":{"type":"string","maxLength":3000},"commentary":{"type":"string","description":"Raw little-text commentary"},"type":{"type":"string","enum":["text","image","multi_image","video","document","article","poll","reshare","event","celebration","carousel"]},"mentions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"urn":{"type":"string"}}}},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"urn":{"type":"string"},"title":{"type":["null","string"]},"alt_text":{"type":["null","string"]}}}},"article":{"type":["null","object"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"thumbnail":{"type":"string"}}},"poll":{"type":["null","object"],"properties":{"question":{"type":"string"},"duration":{"type":"string"},"unique_voters":{"type":"integer"},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"vote_count":{"type":["null","integer"]}}}}}},"event":{"type":["null","string"]},"reshare_parent":{"type":["null","string"]},"reshare_root":{"type":["null","string"]},"visibility":{"type":"string","enum":["PUBLIC","CONNECTIONS","LOGGED_IN"]},"feed_distribution":{"type":"string","enum":["MAIN_FEED","NONE"]},"targeted":{"type":"boolean"},"lifecycle_state":{"type":"string","enum":["PUBLISHED","DRAFT","PUBLISH_REQUESTED","PUBLISH_FAILED"]},"is_reshare_disabled":{"type":"boolean"},"edited":{"type":"boolean"},"cta_label":{"type":["null","string"],"enum":["APPLY","DOWNLOAD","VIEW_QUOTE","LEARN_MORE","SIGN_UP","SUBSCRIBE","REGISTER","JOIN","ATTEND","REQUEST_DEMO","SEE_MORE","BUY_NOW","SHOP_NOW",null]},"landing_page":{"type":["null","string"],"format":"uri"},"sponsored":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"linkedinPostsUpdate","summary":"LinkedIn: Update a Posts item","tags":["Focus · LinkedIn"],"description":"Edit the text / CTA of a published post. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":3000},"cta_label":{"type":"string","enum":["APPLY","DOWNLOAD","VIEW_QUOTE","LEARN_MORE","SIGN_UP","SUBSCRIBE","REGISTER","JOIN","ATTEND","REQUEST_DEMO","SEE_MORE","BUY_NOW","SHOP_NOW"]},"landing_page":{"type":"string","format":"uri"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-posts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:share:… or urn:li:ugcPost:…"},"url":{"type":"string","format":"uri"},"author":{"type":"string"},"text":{"type":"string","maxLength":3000},"commentary":{"type":"string","description":"Raw little-text commentary"},"type":{"type":"string","enum":["text","image","multi_image","video","document","article","poll","reshare","event","celebration","carousel"]},"mentions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"urn":{"type":"string"}}}},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"urn":{"type":"string"},"title":{"type":["null","string"]},"alt_text":{"type":["null","string"]}}}},"article":{"type":["null","object"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"thumbnail":{"type":"string"}}},"poll":{"type":["null","object"],"properties":{"question":{"type":"string"},"duration":{"type":"string"},"unique_voters":{"type":"integer"},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"vote_count":{"type":["null","integer"]}}}}}},"event":{"type":["null","string"]},"reshare_parent":{"type":["null","string"]},"reshare_root":{"type":["null","string"]},"visibility":{"type":"string","enum":["PUBLIC","CONNECTIONS","LOGGED_IN"]},"feed_distribution":{"type":"string","enum":["MAIN_FEED","NONE"]},"targeted":{"type":"boolean"},"lifecycle_state":{"type":"string","enum":["PUBLISHED","DRAFT","PUBLISH_REQUESTED","PUBLISH_FAILED"]},"is_reshare_disabled":{"type":"boolean"},"edited":{"type":"boolean"},"cta_label":{"type":["null","string"],"enum":["APPLY","DOWNLOAD","VIEW_QUOTE","LEARN_MORE","SIGN_UP","SUBSCRIBE","REGISTER","JOIN","ATTEND","REQUEST_DEMO","SEE_MORE","BUY_NOW","SHOP_NOW",null]},"landing_page":{"type":["null","string"],"format":"uri"},"sponsored":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"published_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"linkedinPostsDelete","summary":"LinkedIn: Delete a Posts item","tags":["Focus · LinkedIn"],"description":"Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-posts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/posts/{itemId}/close-comments":{"post":{"operationId":"linkedinPostsCloseComments","summary":"LinkedIn: Turn off comments (Posts)","tags":["Focus · LinkedIn"],"description":"Closing comments deletes the existing comments on the post. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Destructive. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-posts-close-comments","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/posts/{itemId}/open-comments":{"post":{"operationId":"linkedinPostsOpenComments","summary":"LinkedIn: Turn on comments (Posts)","tags":["Focus · LinkedIn"],"description":"Turn on comments. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-posts-open-comments","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/posts/{itemId}/comment":{"post":{"operationId":"linkedinPostsComment","summary":"LinkedIn: Comment (Posts)","tags":["Focus · LinkedIn"],"description":"Comment. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":1250}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-posts-comment","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/posts/{itemId}/react":{"post":{"operationId":"linkedinPostsReact","summary":"LinkedIn: React (Posts)","tags":["Focus · LinkedIn"],"description":"React. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reaction_type":{"type":"string","enum":["LIKE","PRAISE","EMPATHY","INTEREST","APPRECIATION","ENTERTAINMENT"],"default":"LIKE"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-posts-react","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/posts/{itemId}/reshare":{"post":{"operationId":"linkedinPostsReshare","summary":"LinkedIn: Repost with thoughts (Posts)","tags":["Focus · LinkedIn"],"description":"Repost with thoughts. Posts by this Page (r_organization_social). Listing a member's own posts needs the closed r_member_social permission; posts published through Socialit are tracked by Socialit. Requires one of: r_organization_social | r_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":3000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-posts-reshare","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/images":{"get":{"operationId":"linkedinImagesList","summary":"LinkedIn: List Images","tags":["Focus · LinkedIn"],"description":"Images used in recent posts. JPG / PNG / GIF (< 36,152,320 px, GIF ≤ 250 frames). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/images-api Generic route: `/v1/accounts/{accountId}/focus/images`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor (start offset) from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-images-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:image|video|document:…"},"owner":{"type":"string"},"status":{"type":"string","enum":["WAITING_UPLOAD","PROCESSING","AVAILABLE","PROCESSING_FAILED"]},"download_url":{"type":["null","string"],"format":"uri"},"download_url_expires_at":{"type":["null","string"],"format":"date-time"},"duration_ms":{"type":["null","integer"]},"aspect_ratio":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"captions":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"used_in_post":{"type":["null","string"]},"processing_failure_reason":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"linkedinImagesCreate","summary":"LinkedIn: Create a Images item","tags":["Focus · LinkedIn"],"description":"Upload a image (returns its URN for use in posts). JPG / PNG / GIF (< 36,152,320 px, GIF ≤ 250 frames). Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/images-api Generic route: `/v1/accounts/{accountId}/focus/images`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string"},"url":{"type":"string","format":"uri"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-images-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:image|video|document:…"},"owner":{"type":"string"},"status":{"type":"string","enum":["WAITING_UPLOAD","PROCESSING","AVAILABLE","PROCESSING_FAILED"]},"download_url":{"type":["null","string"],"format":"uri"},"download_url_expires_at":{"type":["null","string"],"format":"date-time"},"duration_ms":{"type":["null","integer"]},"aspect_ratio":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"captions":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"used_in_post":{"type":["null","string"]},"processing_failure_reason":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/images/{itemId}":{"get":{"operationId":"linkedinImagesGet","summary":"LinkedIn: Get a Images item","tags":["Focus · LinkedIn"],"description":"JPG / PNG / GIF (< 36,152,320 px, GIF ≤ 250 frames). Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/images-api Generic route: `/v1/accounts/{accountId}/focus/images`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-images-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:image|video|document:…"},"owner":{"type":"string"},"status":{"type":"string","enum":["WAITING_UPLOAD","PROCESSING","AVAILABLE","PROCESSING_FAILED"]},"download_url":{"type":["null","string"],"format":"uri"},"download_url_expires_at":{"type":["null","string"],"format":"date-time"},"duration_ms":{"type":["null","integer"]},"aspect_ratio":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"captions":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"used_in_post":{"type":["null","string"]},"processing_failure_reason":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/videos":{"get":{"operationId":"linkedinVideosList","summary":"LinkedIn: List Videos","tags":["Focus · LinkedIn"],"description":"Videos used in recent posts. MP4 up to 5 GB, 3 s – 30 min (10 min for members); one English SRT caption and a custom thumbnail. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/videos-api Generic route: `/v1/accounts/{accountId}/focus/videos`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor (start offset) from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-videos-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:image|video|document:…"},"owner":{"type":"string"},"status":{"type":"string","enum":["WAITING_UPLOAD","PROCESSING","AVAILABLE","PROCESSING_FAILED"]},"download_url":{"type":["null","string"],"format":"uri"},"download_url_expires_at":{"type":["null","string"],"format":"date-time"},"duration_ms":{"type":["null","integer"]},"aspect_ratio":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"captions":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"used_in_post":{"type":["null","string"]},"processing_failure_reason":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"linkedinVideosCreate","summary":"LinkedIn: Create a Videos item","tags":["Focus · LinkedIn"],"description":"Upload a video (returns its URN for use in posts). MP4 up to 5 GB, 3 s – 30 min (10 min for members); one English SRT caption and a custom thumbnail. Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/videos-api Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string"},"thumbnail_media_id":{"type":"string"},"captions_media_id":{"type":"string","description":"English SRT file"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-videos-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:image|video|document:…"},"owner":{"type":"string"},"status":{"type":"string","enum":["WAITING_UPLOAD","PROCESSING","AVAILABLE","PROCESSING_FAILED"]},"download_url":{"type":["null","string"],"format":"uri"},"download_url_expires_at":{"type":["null","string"],"format":"date-time"},"duration_ms":{"type":["null","integer"]},"aspect_ratio":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"captions":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"used_in_post":{"type":["null","string"]},"processing_failure_reason":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/videos/{itemId}":{"get":{"operationId":"linkedinVideosGet","summary":"LinkedIn: Get a Videos item","tags":["Focus · LinkedIn"],"description":"MP4 up to 5 GB, 3 s – 30 min (10 min for members); one English SRT caption and a custom thumbnail. Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/videos-api Generic route: `/v1/accounts/{accountId}/focus/videos`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-videos-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:image|video|document:…"},"owner":{"type":"string"},"status":{"type":"string","enum":["WAITING_UPLOAD","PROCESSING","AVAILABLE","PROCESSING_FAILED"]},"download_url":{"type":["null","string"],"format":"uri"},"download_url_expires_at":{"type":["null","string"],"format":"date-time"},"duration_ms":{"type":["null","integer"]},"aspect_ratio":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"captions":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"used_in_post":{"type":["null","string"]},"processing_failure_reason":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/documents":{"get":{"operationId":"linkedinDocumentsList","summary":"LinkedIn: List Documents","tags":["Focus · LinkedIn"],"description":"Documents used in recent posts. PDF, PPT, PPTX, DOC, DOCX up to 100 MB / 300 pages (shown as a carousel). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/documents-api Generic route: `/v1/accounts/{accountId}/focus/documents`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor (start offset) from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-documents-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:image|video|document:…"},"owner":{"type":"string"},"status":{"type":"string","enum":["WAITING_UPLOAD","PROCESSING","AVAILABLE","PROCESSING_FAILED"]},"download_url":{"type":["null","string"],"format":"uri"},"download_url_expires_at":{"type":["null","string"],"format":"date-time"},"duration_ms":{"type":["null","integer"]},"aspect_ratio":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"captions":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"used_in_post":{"type":["null","string"]},"processing_failure_reason":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"linkedinDocumentsCreate","summary":"LinkedIn: Create a Documents item","tags":["Focus · LinkedIn"],"description":"Upload a document (returns its URN for use in posts). PDF, PPT, PPTX, DOC, DOCX up to 100 MB / 300 pages (shown as a carousel). Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/documents-api Generic route: `/v1/accounts/{accountId}/focus/documents`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-documents-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:image|video|document:…"},"owner":{"type":"string"},"status":{"type":"string","enum":["WAITING_UPLOAD","PROCESSING","AVAILABLE","PROCESSING_FAILED"]},"download_url":{"type":["null","string"],"format":"uri"},"download_url_expires_at":{"type":["null","string"],"format":"date-time"},"duration_ms":{"type":["null","integer"]},"aspect_ratio":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"captions":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"used_in_post":{"type":["null","string"]},"processing_failure_reason":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/documents/{itemId}":{"get":{"operationId":"linkedinDocumentsGet","summary":"LinkedIn: Get a Documents item","tags":["Focus · LinkedIn"],"description":"PDF, PPT, PPTX, DOC, DOCX up to 100 MB / 300 pages (shown as a carousel). Requires one of: w_organization_social | w_member_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/documents-api Generic route: `/v1/accounts/{accountId}/focus/documents`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-documents-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"urn:li:image|video|document:…"},"owner":{"type":"string"},"status":{"type":"string","enum":["WAITING_UPLOAD","PROCESSING","AVAILABLE","PROCESSING_FAILED"]},"download_url":{"type":["null","string"],"format":"uri"},"download_url_expires_at":{"type":["null","string"],"format":"date-time"},"duration_ms":{"type":["null","integer"]},"aspect_ratio":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"captions":{"type":["null","string"],"format":"uri"},"title":{"type":["null","string"]},"used_in_post":{"type":["null","string"]},"processing_failure_reason":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/events":{"get":{"operationId":"linkedinEventsList","summary":"LinkedIn: List Events","tags":["Focus · LinkedIn"],"description":"LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: r_events. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: `/v1/accounts/{accountId}/focus/events`.","parameters":[{"schema":{"type":"string","enum":["UPCOMING","ONGOING","PAST"]},"in":"query","name":"lifecycle","required":false},{"schema":{"type":"boolean"},"in":"query","name":"exclude_cancelled","required":false},{"schema":{"type":"string","enum":["PUBLIC","GATED"]},"in":"query","name":"entry_criteria","required":false},{"schema":{"type":"string","enum":["START_TIME_ASC","END_TIME_DESC"]},"in":"query","name":"sort_order","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor (start offset) from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-events-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"urn":{"type":"string"},"name":{"type":"string","maxLength":255},"description":{"type":["null","string"]},"type":{"type":"string","enum":["live_video","external","in_person"]},"organizer":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"},"address":{"type":["null","object"],"properties":{"line1":{"type":"string"},"city":{"type":"string"},"geographicArea":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"venue_details":{"type":["null","string"]},"vanity_name":{"type":["null","string"]},"discovery_mode":{"type":["null","string"],"enum":["LISTED","URL_ONLY",null]},"background_image":{"type":["null","string"]},"live_video":{"type":["null","string"]},"ugc_post":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"linkedinEventsCreate","summary":"LinkedIn: Create a Events item","tags":["Focus · LinkedIn"],"description":"LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Requires scopes: r_events, rw_events. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: `/v1/accounts/{accountId}/focus/events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["live_video","external","in_person"]},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"address":{"type":"object","properties":{"line1":{"type":"string"},"city":{"type":"string"},"geographicArea":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"venue_details":{"type":"string"},"vanity_name":{"type":"string"},"discovery_mode":{"type":"string","enum":["LISTED","URL_ONLY"]},"background_image":{"type":"string","description":"urn:li:digitalmediaAsset:…"},"privacy_policy_url":{"type":"string","format":"uri","description":"Attach a templated lead gen registration form"},"test_event":{"type":"boolean"},"post":{"type":"boolean","default":true,"description":"Share the event to the feed (required for it to be visible)"},"commentary":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-events-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"urn":{"type":"string"},"name":{"type":"string","maxLength":255},"description":{"type":["null","string"]},"type":{"type":"string","enum":["live_video","external","in_person"]},"organizer":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"},"address":{"type":["null","object"],"properties":{"line1":{"type":"string"},"city":{"type":"string"},"geographicArea":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"venue_details":{"type":["null","string"]},"vanity_name":{"type":["null","string"]},"discovery_mode":{"type":["null","string"],"enum":["LISTED","URL_ONLY",null]},"background_image":{"type":["null","string"]},"live_video":{"type":["null","string"]},"ugc_post":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/events/{itemId}":{"get":{"operationId":"linkedinEventsGet","summary":"LinkedIn: Get a Events item","tags":["Focus · LinkedIn"],"description":"LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Requires scopes: r_events. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: `/v1/accounts/{accountId}/focus/events`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-events-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"urn":{"type":"string"},"name":{"type":"string","maxLength":255},"description":{"type":["null","string"]},"type":{"type":"string","enum":["live_video","external","in_person"]},"organizer":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"},"address":{"type":["null","object"],"properties":{"line1":{"type":"string"},"city":{"type":"string"},"geographicArea":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"venue_details":{"type":["null","string"]},"vanity_name":{"type":["null","string"]},"discovery_mode":{"type":["null","string"],"enum":["LISTED","URL_ONLY",null]},"background_image":{"type":["null","string"]},"live_video":{"type":["null","string"]},"ugc_post":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"linkedinEventsUpdate","summary":"LinkedIn: Update a Events item","tags":["Focus · LinkedIn"],"description":"LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Requires scopes: r_events, rw_events. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: `/v1/accounts/{accountId}/focus/events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["live_video","external","in_person"]},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"address":{"type":"object","properties":{"line1":{"type":"string"},"city":{"type":"string"},"geographicArea":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"venue_details":{"type":"string"},"vanity_name":{"type":"string"},"discovery_mode":{"type":"string","enum":["LISTED","URL_ONLY"]},"background_image":{"type":"string","description":"urn:li:digitalmediaAsset:…"},"privacy_policy_url":{"type":"string","format":"uri","description":"Attach a templated lead gen registration form"},"test_event":{"type":"boolean"},"post":{"type":"boolean","default":true,"description":"Share the event to the feed (required for it to be visible)"},"commentary":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-events-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"urn":{"type":"string"},"name":{"type":"string","maxLength":255},"description":{"type":["null","string"]},"type":{"type":"string","enum":["live_video","external","in_person"]},"organizer":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"},"address":{"type":["null","object"],"properties":{"line1":{"type":"string"},"city":{"type":"string"},"geographicArea":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"venue_details":{"type":["null","string"]},"vanity_name":{"type":["null","string"]},"discovery_mode":{"type":["null","string"],"enum":["LISTED","URL_ONLY",null]},"background_image":{"type":["null","string"]},"live_video":{"type":["null","string"]},"ugc_post":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"linkedinEventsDelete","summary":"LinkedIn: Delete a Events item","tags":["Focus · LinkedIn"],"description":"LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Requires scopes: r_events, rw_events. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: `/v1/accounts/{accountId}/focus/events`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-events-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/events/{itemId}/post":{"post":{"operationId":"linkedinEventsPost","summary":"LinkedIn: Share to feed (Events)","tags":["Focus · LinkedIn"],"description":"Share to feed. LinkedIn Events (Event Management API, separate product). Updates are only possible before the event starts. Requires scopes: r_events, rw_events, w_organization_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/event-management/events Generic route: `/v1/accounts/{accountId}/focus/events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"commentary":{"type":"string"},"type":{"type":"string","enum":["live_video","external","in_person"]},"live_video":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-events-post","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/comments":{"get":{"operationId":"linkedinCommentsList","summary":"LinkedIn: List Comments","tags":["Focus · LinkedIn"],"description":"Comments on a post, or replies to a comment. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"post_id","required":false,"description":"Post URN (share / ugcPost / activity)"},{"schema":{"type":"string"},"in":"query","name":"comment_id","required":false,"description":"List replies of this comment URN instead"},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor (start offset) from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-comments-list","x-zernio":["GET /v1/inbox/comments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Composite URN urn:li:comment:(thread,id)"},"text":{"type":"string","maxLength":1250},"author":{"type":"string","description":"Actor URN (person or organization)"},"author_type":{"type":"string","enum":["person","organization"]},"agent":{"type":["null","string"],"description":"Member who commented on behalf of the Page"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"edited":{"type":"boolean"},"like_count":{"type":"integer"},"liked_by_me":{"type":"boolean"},"reply_count":{"type":"integer"},"comment_id":{"type":"string"},"post_id":{"type":"string"},"parent_id":{"type":["null","string"]},"is_own":{"type":"boolean"},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"urn":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}}}},"mentions":{"type":"array","items":{"type":"object","properties":{"start":{"type":"integer"},"length":{"type":"integer"},"urn":{"type":"string"}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"linkedinCommentsCreate","summary":"LinkedIn: Create a Comments item","tags":["Focus · LinkedIn"],"description":"Comment on a post or reply to a comment. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"},"parent_comment_id":{"type":"string","description":"Reply to this comment URN"},"text":{"type":"string","maxLength":1250},"image_media_id":{"type":"string"},"mentions":{"type":"array","items":{"type":"object","properties":{"start":{"type":"integer"},"length":{"type":"integer"},"urn":{"type":"string"}}}}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-comments-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}","POST /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Composite URN urn:li:comment:(thread,id)"},"text":{"type":"string","maxLength":1250},"author":{"type":"string","description":"Actor URN (person or organization)"},"author_type":{"type":"string","enum":["person","organization"]},"agent":{"type":["null","string"],"description":"Member who commented on behalf of the Page"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"edited":{"type":"boolean"},"like_count":{"type":"integer"},"liked_by_me":{"type":"boolean"},"reply_count":{"type":"integer"},"comment_id":{"type":"string"},"post_id":{"type":"string"},"parent_id":{"type":["null","string"]},"is_own":{"type":"boolean"},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"urn":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}}}},"mentions":{"type":"array","items":{"type":"object","properties":{"start":{"type":"integer"},"length":{"type":"integer"},"urn":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/comments/{itemId}":{"get":{"operationId":"linkedinCommentsGet","summary":"LinkedIn: Get a Comments item","tags":["Focus · LinkedIn"],"description":"Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-comments-get","x-zernio":["GET /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Composite URN urn:li:comment:(thread,id)"},"text":{"type":"string","maxLength":1250},"author":{"type":"string","description":"Actor URN (person or organization)"},"author_type":{"type":"string","enum":["person","organization"]},"agent":{"type":["null","string"],"description":"Member who commented on behalf of the Page"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"edited":{"type":"boolean"},"like_count":{"type":"integer"},"liked_by_me":{"type":"boolean"},"reply_count":{"type":"integer"},"comment_id":{"type":"string"},"post_id":{"type":"string"},"parent_id":{"type":["null","string"]},"is_own":{"type":"boolean"},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"urn":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}}}},"mentions":{"type":"array","items":{"type":"object","properties":{"start":{"type":"integer"},"length":{"type":"integer"},"urn":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"linkedinCommentsUpdate","summary":"LinkedIn: Update a Comments item","tags":["Focus · LinkedIn"],"description":"Edit a comment written by this account. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":1250}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-comments-update","x-zernio":["PATCH /v1/inbox/comments/{postId}/{commentId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Composite URN urn:li:comment:(thread,id)"},"text":{"type":"string","maxLength":1250},"author":{"type":"string","description":"Actor URN (person or organization)"},"author_type":{"type":"string","enum":["person","organization"]},"agent":{"type":["null","string"],"description":"Member who commented on behalf of the Page"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"edited":{"type":"boolean"},"like_count":{"type":"integer"},"liked_by_me":{"type":"boolean"},"reply_count":{"type":"integer"},"comment_id":{"type":"string"},"post_id":{"type":"string"},"parent_id":{"type":["null","string"]},"is_own":{"type":"boolean"},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"urn":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"}}}},"mentions":{"type":"array","items":{"type":"object","properties":{"start":{"type":"integer"},"length":{"type":"integer"},"urn":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"linkedinCommentsDelete","summary":"LinkedIn: Delete a Comments item","tags":["Focus · LinkedIn"],"description":"Delete a comment (Pages can delete comments on their posts). Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-comments-delete","x-zernio":["DELETE /v1/inbox/comments/{postId}","DELETE /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/comments/{itemId}/like":{"post":{"operationId":"linkedinCommentsLike","summary":"LinkedIn: React (Comments)","tags":["Focus · LinkedIn"],"description":"React. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reaction_type":{"type":"string","enum":["LIKE","PRAISE","EMPATHY","INTEREST","APPRECIATION","ENTERTAINMENT"],"default":"LIKE"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-comments-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/comments/{itemId}/unlike":{"post":{"operationId":"linkedinCommentsUnlike","summary":"LinkedIn: Remove reaction (Comments)","tags":["Focus · LinkedIn"],"description":"Remove reaction. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-comments-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/comments/{itemId}/reply":{"post":{"operationId":"linkedinCommentsReply","summary":"LinkedIn: Reply (Comments)","tags":["Focus · LinkedIn"],"description":"Reply. Comments and replies on posts. Page posts need r_organization_social_feed; comments on member posts need the restricted r_member_social_feed. LinkedIn has no comment hiding. Commenter data may be cached 24 h, activity 48 h. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/comments-api Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":1250}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-comments-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/reactions":{"get":{"operationId":"linkedinReactionsList","summary":"LinkedIn: List Reactions","tags":["Focus · LinkedIn"],"description":"Individual reactions on a post or comment, plus the reaction breakdown (social metadata). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/reactions-api Generic route: `/v1/accounts/{accountId}/focus/reactions`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"entity","required":true,"description":"Post or comment URN"},{"schema":{"type":"string","enum":["REVERSE_CHRONOLOGICAL","CHRONOLOGICAL","RELEVANCE"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor (start offset) from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-reactions-list","x-zernio":["GET /v1/accounts/{accountId}/linkedin-post-reactions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"reaction_type":{"type":"string","enum":["LIKE","PRAISE","EMPATHY","INTEREST","APPRECIATION","ENTERTAINMENT"]},"actor":{"type":"string"},"actor_type":{"type":"string","enum":["person","organization"]},"root":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"linkedinReactionsCreate","summary":"LinkedIn: Create a Reactions item","tags":["Focus · LinkedIn"],"description":"React as this account. Individual reactions on a post or comment, plus the reaction breakdown (social metadata). Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/reactions-api Generic route: `/v1/accounts/{accountId}/focus/reactions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"entity":{"type":"string"},"reaction_type":{"type":"string","enum":["LIKE","PRAISE","EMPATHY","INTEREST","APPRECIATION","ENTERTAINMENT"],"default":"LIKE"}},"required":["entity"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-reactions-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/posts/{postId}/like"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"reaction_type":{"type":"string","enum":["LIKE","PRAISE","EMPATHY","INTEREST","APPRECIATION","ENTERTAINMENT"]},"actor":{"type":"string"},"actor_type":{"type":"string","enum":["person","organization"]},"root":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/reactions/{itemId}":{"delete":{"operationId":"linkedinReactionsDelete","summary":"LinkedIn: Delete a Reactions item","tags":["Focus · LinkedIn"],"description":"Remove this account's reaction (id = entity URN). Individual reactions on a post or comment, plus the reaction breakdown (social metadata). Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/reactions-api Generic route: `/v1/accounts/{accountId}/focus/reactions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-reactions-delete","x-zernio":["DELETE /v1/inbox/posts/{postId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/reactions/summary":{"post":{"operationId":"linkedinReactionsSummary","summary":"LinkedIn: Reaction breakdown (Reactions)","tags":["Focus · LinkedIn"],"description":"Reaction breakdown. Individual reactions on a post or comment, plus the reaction breakdown (social metadata). Requires one of: r_organization_social_feed | r_member_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/reactions-api Generic route: `/v1/accounts/{accountId}/focus/reactions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"entity":{"type":"string"}},"required":["entity"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-reactions-summary","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/mentions":{"get":{"operationId":"linkedinMentionsList","summary":"LinkedIn: List Mentions","tags":["Focus · LinkedIn"],"description":"Posts and comments that @mention the Page (Page notifications, retained 60 days; real-time via webhooks on CM Standard). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications Generic route: `/v1/accounts/{accountId}/focus/mentions`.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor (start offset) from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-mentions-list","x-zernio":["GET /v1/inbox/mentions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["mention"]},"kind":{"type":"string","enum":["post","comment"]},"post_id":{"type":"string"},"comment_id":{"type":["null","string"]},"author":{"type":["null","string"]},"text":{"type":["null","string"]},"organization":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/mentions/{itemId}/reply":{"post":{"operationId":"linkedinMentionsReply","summary":"LinkedIn: Reply as Page (Mentions)","tags":["Focus · LinkedIn"],"description":"Reply as Page. Posts and comments that @mention the Page (Page notifications, retained 60 days; real-time via webhooks on CM Standard). Requires scopes: rw_organization_admin, w_organization_social_feed. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"},"comment_id":{"type":"string"},"message":{"type":"string","maxLength":1250}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-mentions-reply","x-idempotent":true,"x-zernio":["POST /v1/inbox/mentions/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/notifications":{"get":{"operationId":"linkedinNotificationsList","summary":"LinkedIn: List Page activity","tags":["Focus · LinkedIn"],"description":"Likes, comments, reshares, mentions and comment edits/deletes on the Page (60-day retention). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: rw_organization_admin. Generic route: `/v1/accounts/{accountId}/focus/notifications`.","parameters":[{"schema":{"type":"array","items":{"type":"string","enum":["LIKE","COMMENT","SHARE","SHARE_MENTION","ADMIN_COMMENT","COMMENT_EDIT","COMMENT_DELETE"]}},"in":"query","name":"actions","required":false},{"schema":{"type":"string"},"in":"query","name":"source_post","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor (start offset) from next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-notifications-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"action":{"type":"string","enum":["LIKE","COMMENT","SHARE","SHARE_MENTION","ADMIN_COMMENT","COMMENT_EDIT","COMMENT_DELETE"]},"kind":{"type":"string","enum":["post","comment"]},"organization":{"type":"string"},"source_post":{"type":["null","string"]},"generated_activity":{"type":["null","string"]},"author":{"type":["null","string"]},"text":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/mention-search":{"get":{"operationId":"linkedinMentionSearchList","summary":"LinkedIn: List Mention picker","tags":["Focus · LinkedIn"],"description":"Find Page followers to @mention (People Typeahead, restricted r_organization_followers) and resolve profile / company URLs into mention URNs. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: r_organization_followers. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-atmention-search-api Generic route: `/v1/accounts/{accountId}/focus/mention-search`.","parameters":[{"schema":{"type":"string","minLength":3},"in":"query","name":"keywords","required":true},{"schema":{"type":"string"},"in":"query","name":"organization_urn","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-mention-search-list","x-zernio":["GET /v1/accounts/{accountId}/linkedin-mentions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"urn":{"type":"string"},"name":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"},"headline":{"type":["null","string"]},"photo_urn":{"type":["null","string"]},"mention_format":{"type":"string"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/mention-search/resolve":{"post":{"operationId":"linkedinMentionSearchResolve","summary":"LinkedIn: Resolve URL (Mention picker)","tags":["Focus · LinkedIn"],"description":"Resolve a linkedin.com/in/… or /company/… URL into a mention. Find Page followers to @mention (People Typeahead, restricted r_organization_followers) and resolve profile / company URLs into mention URNs. Requires scopes: r_organization_followers. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-atmention-search-api Generic route: `/v1/accounts/{accountId}/focus/mention-search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"display_name":{"type":"string"},"organization_urn":{"type":"string"}},"required":["url"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-mention-search-resolve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/insights":{"get":{"operationId":"linkedinInsightsGet","summary":"LinkedIn: Get Overview","tags":["Focus · LinkedIn"],"description":"Daily impressions, reach, clicks, reactions, comments, reshares, followers and page views (Pages) or post performance and follower growth (members). Requires one of: rw_organization_admin | r_member_postAnalytics. Generic route: `/v1/accounts/{accountId}/focus/insights`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Inclusive start date (YYYY-MM-DD)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"Inclusive end date (YYYY-MM-DD)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-insights-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"}},"additionalProperties":{"type":"number"}}},"totals":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/followers":{"get":{"operationId":"linkedinFollowersGet","summary":"LinkedIn: Get Followers","tags":["Focus · LinkedIn"],"description":"Follower count and daily organic / paid gains (12 months back to 2 days ago) for Pages; follower count and daily series for members. Requires one of: rw_organization_admin | r_member_profileAnalytics. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/follower-statistics Generic route: `/v1/accounts/{accountId}/focus/followers`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Inclusive start date (YYYY-MM-DD)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"Inclusive end date (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["DAY","WEEK","MONTH"],"default":"DAY"},"in":"query","name":"granularity","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-followers-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"granularity":{"type":"string","enum":["DAY","WEEK","MONTH"]},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"organic":{"type":"integer"},"paid":{"type":"integer"},"total":{"type":"integer"},"value":{"type":"integer"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/demographics":{"get":{"operationId":"linkedinDemographicsGet","summary":"LinkedIn: Get Follower demographics","tags":["Focus · LinkedIn"],"description":"Lifetime follower breakdown by country, region, seniority, industry, job function, company size and association (top 100 per facet). Requires scopes: rw_organization_admin. Generic route: `/v1/accounts/{accountId}/focus/demographics`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-demographics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"regions":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"seniorities":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"industries":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"functions":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"company_sizes":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"association_types":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/page-statistics":{"get":{"operationId":"linkedinPageStatisticsGet","summary":"LinkedIn: Get Page views","tags":["Focus · LinkedIn"],"description":"Page views by section (overview, life, jobs, careers) and device; lifetime breakdown by visitor demographics, or a daily / monthly series when a date range is given. Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/page-statistics Generic route: `/v1/accounts/{accountId}/focus/page-statistics`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Inclusive start date (YYYY-MM-DD)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"Inclusive end date (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["DAY","MONTH"]},"in":"query","name":"granularity","required":false},{"schema":{"type":"string"},"in":"query","name":"brand","required":false,"description":"urn:li:organizationBrand:… (showcase page)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-page-statistics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"totals":{"type":"object","properties":{},"additionalProperties":{"type":"number"}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"}},"additionalProperties":{"type":"number"}}},"countries":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"regions":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"seniorities":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"industries":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"functions":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}},"company_sizes":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"integer"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/share-statistics":{"get":{"operationId":"linkedinShareStatisticsGet","summary":"LinkedIn: Get Post performance","tags":["Focus · LinkedIn"],"description":"Organic impressions, unique impressions, clicks, reactions, comments, reshares and engagement rate (rolling 12 months). Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/share-statistics Generic route: `/v1/accounts/{accountId}/focus/share-statistics`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Inclusive start date (YYYY-MM-DD)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"Inclusive end date (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["DAY","MONTH"]},"in":"query","name":"granularity","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-share-statistics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"lifetime":{"type":"object","properties":{},"additionalProperties":{"type":"number"}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"}},"additionalProperties":{"type":"number"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/post-analytics/{itemId}":{"get":{"operationId":"linkedinPostAnalyticsGet","summary":"LinkedIn: Get a Post analytics item","tags":["Focus · LinkedIn"],"description":"Lifetime metrics per post: impressions, reach, reactions, comments, reshares, clicks (Pages) or saves / sends (members); video views. Requires one of: rw_organization_admin | r_member_postAnalytics. Generic route: `/v1/accounts/{accountId}/focus/post-analytics`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-post-analytics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"external_id":{"type":"string"},"impressions":{"type":"integer"},"reach":{"type":"integer"},"likes":{"type":"integer"},"comments":{"type":"integer"},"shares":{"type":"integer"},"clicks":{"type":"integer"},"saves":{"type":"integer"},"views":{"type":"integer"},"engagements":{"type":"integer"},"engagement_rate":{"type":"number"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/video-analytics":{"get":{"operationId":"linkedinVideoAnalyticsGet","summary":"LinkedIn: Get Video analytics","tags":["Focus · LinkedIn"],"description":"Views, unique viewers and watch time of a video post (Pages: 6 months of data; members: plays, viewers, watch time). Requires one of: r_organization_social | r_member_postAnalytics. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/video-analytics-api Generic route: `/v1/accounts/{accountId}/focus/video-analytics`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"post_id","required":true},{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Inclusive start date (YYYY-MM-DD)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"Inclusive end date (YYYY-MM-DD)"},{"schema":{"type":"string","enum":["ALL","DAY","WEEK"]},"in":"query","name":"aggregation","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-video-analytics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"date":{"type":["null","string"]},"value":{"type":"number"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/member-post-analytics":{"get":{"operationId":"linkedinMemberPostAnalyticsGet","summary":"LinkedIn: Get Creator analytics","tags":["Focus · LinkedIn"],"description":"Member post analytics for one post or all posts: impressions, members reached, reactions, comments, reshares, saves, sends, link clicks, followers and profile views from content. Requires scopes: r_member_postAnalytics. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/members/post-statistics Generic route: `/v1/accounts/{accountId}/focus/member-post-analytics`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"post_id","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["IMPRESSION","MEMBERS_REACHED","RESHARE","REACTION","COMMENT","POST_SAVE","POST_SEND","LINK_CLICKS","PREMIUM_CTA_CLICKS","FOLLOWER_GAINED_FROM_CONTENT","PROFILE_VIEW_FROM_CONTENT"]}},"in":"query","name":"metrics","required":false},{"schema":{"type":"string","enum":["TOTAL","DAILY"],"default":"TOTAL"},"in":"query","name":"aggregation","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Inclusive start date (YYYY-MM-DD)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"Inclusive end date (YYYY-MM-DD)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-member-post-analytics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string","enum":["IMPRESSION","MEMBERS_REACHED","RESHARE","REACTION","COMMENT","POST_SAVE","POST_SEND","LINK_CLICKS","PREMIUM_CTA_CLICKS","FOLLOWER_GAINED_FROM_CONTENT","PROFILE_VIEW_FROM_CONTENT"]},"date":{"type":["null","string"]},"value":{"type":"number"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/org-aggregate":{"get":{"operationId":"linkedinOrgAggregateGet","summary":"LinkedIn: Get Page analytics (aggregate)","tags":["Focus · LinkedIn"],"description":"Zernio-compatible organization aggregate analytics (max 89 days). Requires scopes: rw_organization_admin. Generic route: `/v1/accounts/{accountId}/focus/org-aggregate`.","parameters":[{"schema":{"type":"array","items":{"type":"string","enum":["impressions","unique_impressions","clicks","likes","comments","shares","engagement_rate","organic_followers_gained","paid_followers_gained","page_views_total","page_views_overview","page_views_careers","page_views_jobs","page_views_life","followers_gained","followers_lost"]}},"in":"query","name":"metrics","required":false},{"schema":{"type":"string","enum":["time_series","total_value"]},"in":"query","name":"metric_type","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Inclusive start date (YYYY-MM-DD)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"Inclusive end date (YYYY-MM-DD)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-org-aggregate-get","x-zernio":["GET /v1/analytics/linkedin/org-aggregate-analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"dateRange":{"type":"object","properties":{"since":{"type":"string"},"until":{"type":"string"}}},"metricType":{"type":"string","enum":["time_series","total_value"]},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"total":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number"}}}}}}},"unavailableMetrics":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/member-aggregate":{"get":{"operationId":"linkedinMemberAggregateGet","summary":"LinkedIn: Get Profile analytics (aggregate)","tags":["Focus · LinkedIn"],"description":"Zernio-compatible aggregated analytics across the member's posts. Requires scopes: r_member_postAnalytics. Generic route: `/v1/accounts/{accountId}/focus/member-aggregate`.","parameters":[{"schema":{"type":"string","enum":["TOTAL","DAILY"]},"in":"query","name":"aggregation","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["IMPRESSION","MEMBERS_REACHED","RESHARE","REACTION","COMMENT","POST_SAVE","POST_SEND","LINK_CLICKS","PREMIUM_CTA_CLICKS","FOLLOWER_GAINED_FROM_CONTENT","PROFILE_VIEW_FROM_CONTENT"]}},"in":"query","name":"metrics","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Inclusive start date (YYYY-MM-DD)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"Inclusive end date (YYYY-MM-DD)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-member-aggregate-get","x-zernio":["GET /v1/accounts/{accountId}/linkedin-aggregate-analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"aggregation":{"type":"string","enum":["TOTAL","DAILY"]},"analytics":{"type":"object","properties":{},"additionalProperties":true},"skippedMetrics":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/webhook-subscriptions":{"get":{"operationId":"linkedinWebhookSubscriptionsList","summary":"LinkedIn: List Real-time notifications","tags":["Focus · LinkedIn"],"description":"Webhook subscriptions for Page comments, mentions, reactions and reshares (Community Management Standard tier only; subscriptions end when the member's grant expires or their admin role is removed). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications Generic route: `/v1/accounts/{accountId}/focus/webhook-subscriptions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-webhook-subscriptions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organization":{"type":"string"},"user":{"type":"string"},"event_type":{"type":"string","enum":["ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS"]},"webhook":{"type":"string","format":"uri"},"expires_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"linkedinWebhookSubscriptionsCreate","summary":"LinkedIn: Create a Real-time notifications item","tags":["Focus · LinkedIn"],"description":"Subscribe the Page to webhook notifications. Webhook subscriptions for Page comments, mentions, reactions and reshares (Community Management Standard tier only; subscriptions end when the member's grant expires or their admin role is removed). Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications Generic route: `/v1/accounts/{accountId}/focus/webhook-subscriptions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"webhook_url":{"type":"string","format":"uri"},"organization_urn":{"type":"string"},"developer_app_id":{"type":"string","description":"Defaults to LINKEDIN_ORG_APP_ID"}},"required":["webhook_url"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-webhook-subscriptions-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"organization":{"type":"string"},"user":{"type":"string"},"event_type":{"type":"string","enum":["ORGANIZATION_SOCIAL_ACTION_NOTIFICATIONS"]},"webhook":{"type":"string","format":"uri"},"expires_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/webhook-subscriptions/{itemId}":{"delete":{"operationId":"linkedinWebhookSubscriptionsDelete","summary":"LinkedIn: Delete a Real-time notifications item","tags":["Focus · LinkedIn"],"description":"Unsubscribe (id = organization URN or \"organization|user\"). Webhook subscriptions for Page comments, mentions, reactions and reshares (Community Management Standard tier only; subscriptions end when the member's grant expires or their admin role is removed). Requires scopes: rw_organization_admin. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-social-action-notifications Generic route: `/v1/accounts/{accountId}/focus/webhook-subscriptions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-webhook-subscriptions-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/linkedin/targeting/estimate-audience":{"post":{"operationId":"linkedinTargetingEstimateAudience","summary":"LinkedIn: Estimate audience (Audience targeting)","tags":["Focus · LinkedIn"],"description":"Estimate audience. Estimate the audience of a targeted organic Page post (must exceed 300 members). Use the same facets as platform_options.linkedin.audience. Requires scopes: w_organization_social. Network docs: https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api#create-targeted-organic-posts Generic route: `/v1/accounts/{accountId}/focus/targeting`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"string"}},"geoLocations":{"type":"array","items":{"type":"string"}},"industries":{"type":"array","items":{"type":"string"}},"jobFunctions":{"type":"array","items":{"type":"string"}},"seniorities":{"type":"array","items":{"type":"string"}},"staffCountRanges":{"type":"array","items":{"type":"string","enum":["SIZE_1","SIZE_2_TO_10","SIZE_11_TO_50","SIZE_51_TO_200","SIZE_201_TO_500","SIZE_501_TO_1000","SIZE_1001_TO_5000","SIZE_5001_TO_10000","SIZE_10001_OR_MORE"]}},"degrees":{"type":"array","items":{"type":"string"}},"fieldsOfStudy":{"type":"array","items":{"type":"string"}},"organizations":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_linkedin","x-mcp-tool":"linkedin-targeting-estimate-audience","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses":{"get":{"operationId":"mastodonStatusesList","summary":"Mastodon: List Posts","tags":["Focus · Mastodon"],"description":"Own statuses (GET /api/v1/accounts/:id/statuses). Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false,"description":"Defaults to the connected account"},{"schema":{"type":"boolean"},"in":"query","name":"only_media","required":false},{"schema":{"type":"boolean"},"in":"query","name":"exclude_replies","required":false},{"schema":{"type":"boolean"},"in":"query","name":"exclude_reblogs","required":false},{"schema":{"type":"boolean"},"in":"query","name":"pinned","required":false},{"schema":{"type":"string"},"in":"query","name":"tagged","required":false},{"schema":{"type":"boolean"},"in":"query","name":"exclude_direct","required":false,"description":"Mastodon 4.6+"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonStatusesCreate","summary":"Mastodon: Create a Posts item","tags":["Focus · Mastodon"],"description":"Publish (media, poll, CW, quote, schedule, thread). Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}":{"get":{"operationId":"mastodonStatusesGet","summary":"Mastodon: Get a Posts item","tags":["Focus · Mastodon"],"description":"Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonStatusesUpdate","summary":"Mastodon: Update a Posts item","tags":["Focus · Mastodon"],"description":"Edit (PUT /api/v1/statuses/:id); visibility cannot change. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Final list of attachment ids (omit to keep)"},"media":{"type":"array","items":{"type":"string"},"description":"New Socialit media to upload and append"},"media_attributes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"description":{"type":"string"},"focus":{"type":"string","description":"\"x,y\""}}}},"poll":{"type":["object","null"],"properties":{"options":{"type":"array","items":{"type":"string"}},"expires_in":{"type":"integer"},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonStatusesDelete","summary":"Mastodon: Delete a Posts item","tags":["Focus · Mastodon"],"description":"Delete (and its media). Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/pin":{"post":{"operationId":"mastodonStatusesPin","summary":"Mastodon: Pin to profile (Posts)","tags":["Focus · Mastodon"],"description":"Pin to profile. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-pin","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/unpin":{"post":{"operationId":"mastodonStatusesUnpin","summary":"Mastodon: Unpin (Posts)","tags":["Focus · Mastodon"],"description":"Unpin. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-unpin","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/boost":{"post":{"operationId":"mastodonStatusesBoost","summary":"Mastodon: Boost (Posts)","tags":["Focus · Mastodon"],"description":"Boost. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["public","unlisted","private"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-boost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/unboost":{"post":{"operationId":"mastodonStatusesUnboost","summary":"Mastodon: Undo boost (Posts)","tags":["Focus · Mastodon"],"description":"Undo boost. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-unboost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/favourite":{"post":{"operationId":"mastodonStatusesFavourite","summary":"Mastodon: Favourite (Posts)","tags":["Focus · Mastodon"],"description":"Favourite. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-favourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/unfavourite":{"post":{"operationId":"mastodonStatusesUnfavourite","summary":"Mastodon: Unfavourite (Posts)","tags":["Focus · Mastodon"],"description":"Unfavourite. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-unfavourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/bookmark":{"post":{"operationId":"mastodonStatusesBookmark","summary":"Mastodon: Bookmark (Posts)","tags":["Focus · Mastodon"],"description":"Bookmark. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/unbookmark":{"post":{"operationId":"mastodonStatusesUnbookmark","summary":"Mastodon: Remove bookmark (Posts)","tags":["Focus · Mastodon"],"description":"Remove bookmark. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-unbookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/mute":{"post":{"operationId":"mastodonStatusesMute","summary":"Mastodon: Mute conversation (Posts)","tags":["Focus · Mastodon"],"description":"Mute conversation. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:mutes. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/unmute":{"post":{"operationId":"mastodonStatusesUnmute","summary":"Mastodon: Unmute conversation (Posts)","tags":["Focus · Mastodon"],"description":"Unmute conversation. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:mutes. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-unmute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/reply":{"post":{"operationId":"mastodonStatusesReply","summary":"Mastodon: Reply / continue thread (Posts)","tags":["Focus · Mastodon"],"description":"Reply / continue thread. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/translate":{"post":{"operationId":"mastodonStatusesTranslate","summary":"Mastodon: Translate (Posts)","tags":["Focus · Mastodon"],"description":"Translate. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lang":{"type":"string","description":"Target ISO 639-1 (default: user locale)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-translate","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/history":{"post":{"operationId":"mastodonStatusesHistory","summary":"Mastodon: Edit history (Posts)","tags":["Focus · Mastodon"],"description":"Edit history. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-history","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/source":{"post":{"operationId":"mastodonStatusesSource","summary":"Mastodon: Source text (Posts)","tags":["Focus · Mastodon"],"description":"Source text. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-source","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/context":{"post":{"operationId":"mastodonStatusesContext","summary":"Mastodon: Thread (Posts)","tags":["Focus · Mastodon"],"description":"Thread. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-context","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/redraft":{"post":{"operationId":"mastodonStatusesRedraft","summary":"Mastodon: Delete & redraft (Posts)","tags":["Focus · Mastodon"],"description":"Deletes the status (keeping media) and re-posts it with optional changes. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Destructive. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"spoiler_text":{"type":"string"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-redraft","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/favourited-by":{"post":{"operationId":"mastodonStatusesFavouritedBy","summary":"Mastodon: Favourited by (Posts)","tags":["Focus · Mastodon"],"description":"Favourited by. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from a previous next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":80,"default":20}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-favourited-by","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/reblogged-by":{"post":{"operationId":"mastodonStatusesRebloggedBy","summary":"Mastodon: Boosted by (Posts)","tags":["Focus · Mastodon"],"description":"Boosted by. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from a previous next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":80,"default":20}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-reblogged-by","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/quotes":{"post":{"operationId":"mastodonStatusesQuotes","summary":"Mastodon: Quotes of this post (Posts)","tags":["Focus · Mastodon"],"description":"Quotes of this post. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from a previous next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":80,"default":20}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-quotes","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/revoke-quote":{"post":{"operationId":"mastodonStatusesRevokeQuote","summary":"Mastodon: Revoke a quote (Posts)","tags":["Focus · Mastodon"],"description":"Revoke a quote. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Destructive. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quoting_status_id":{"type":"string"}},"required":["quoting_status_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-revoke-quote","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/statuses/{itemId}/interaction-policy":{"post":{"operationId":"mastodonStatusesInteractionPolicy","summary":"Mastodon: Who can quote (Posts)","tags":["Focus · Mastodon"],"description":"Who can quote. Your statuses: publish, edit, delete, pin, boost, bookmark, translate, edit history, quotes. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/ Generic route: `/v1/accounts/{accountId}/focus/statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]}},"required":["quote_approval_policy"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-statuses-interaction-policy","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/scheduled-statuses":{"get":{"operationId":"mastodonScheduledStatusesList","summary":"Mastodon: List Scheduled posts","tags":["Focus · Mastodon"],"description":"Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: `/v1/accounts/{accountId}/focus/scheduled-statuses`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-scheduled-statuses-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"scheduled_at":{"type":"string","format":"date-time"},"text":{"type":"string","readOnly":true},"visibility":{"type":["null","string"],"enum":["public","unlisted","private","direct",null]},"spoiler_text":{"type":["null","string"]},"media_count":{"type":"integer"},"poll_options":{"type":["null","array"],"items":{"type":"string"}},"params":{"type":"object","properties":{},"additionalProperties":true},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}}},"required":["id","scheduled_at"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonScheduledStatusesCreate","summary":"Mastodon: Create a Scheduled posts item","tags":["Focus · Mastodon"],"description":"Schedule natively (≥ 5 min ahead, max 300 pending / 25 per day). Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: `/v1/accounts/{accountId}/focus/scheduled-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}},"required":["scheduled_at"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-scheduled-statuses-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"scheduled_at":{"type":"string","format":"date-time"},"text":{"type":"string","readOnly":true},"visibility":{"type":["null","string"],"enum":["public","unlisted","private","direct",null]},"spoiler_text":{"type":["null","string"]},"media_count":{"type":"integer"},"poll_options":{"type":["null","array"],"items":{"type":"string"}},"params":{"type":"object","properties":{},"additionalProperties":true},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}}},"required":["id","scheduled_at"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/scheduled-statuses/{itemId}":{"get":{"operationId":"mastodonScheduledStatusesGet","summary":"Mastodon: Get a Scheduled posts item","tags":["Focus · Mastodon"],"description":"Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: `/v1/accounts/{accountId}/focus/scheduled-statuses`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-scheduled-statuses-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"scheduled_at":{"type":"string","format":"date-time"},"text":{"type":"string","readOnly":true},"visibility":{"type":["null","string"],"enum":["public","unlisted","private","direct",null]},"spoiler_text":{"type":["null","string"]},"media_count":{"type":"integer"},"poll_options":{"type":["null","array"],"items":{"type":"string"}},"params":{"type":"object","properties":{},"additionalProperties":true},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}}},"required":["id","scheduled_at"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonScheduledStatusesUpdate","summary":"Mastodon: Update a Scheduled posts item","tags":["Focus · Mastodon"],"description":"Reschedule. Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: `/v1/accounts/{accountId}/focus/scheduled-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduled_at":{"type":"string","format":"date-time"}},"required":["scheduled_at"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-scheduled-statuses-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"scheduled_at":{"type":"string","format":"date-time"},"text":{"type":"string","readOnly":true},"visibility":{"type":["null","string"],"enum":["public","unlisted","private","direct",null]},"spoiler_text":{"type":["null","string"]},"media_count":{"type":"integer"},"poll_options":{"type":["null","array"],"items":{"type":"string"}},"params":{"type":"object","properties":{},"additionalProperties":true},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}}},"required":["id","scheduled_at"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonScheduledStatusesDelete","summary":"Mastodon: Delete a Scheduled posts item","tags":["Focus · Mastodon"],"description":"Statuses scheduled natively on the instance (from any client). Content is fixed; only the date can change. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/scheduled_statuses/ Generic route: `/v1/accounts/{accountId}/focus/scheduled-statuses`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-scheduled-statuses-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/polls":{"get":{"operationId":"mastodonPollsList","summary":"Mastodon: List Polls","tags":["Focus · Mastodon"],"description":"Own statuses that carry a poll. Your polls and their results; vote in any poll. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/polls/ Generic route: `/v1/accounts/{accountId}/focus/polls`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-polls-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}},"status_id":{"type":"string"},"question":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/polls/{itemId}":{"get":{"operationId":"mastodonPollsGet","summary":"Mastodon: Get a Polls item","tags":["Focus · Mastodon"],"description":"Your polls and their results; vote in any poll. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/polls/ Generic route: `/v1/accounts/{accountId}/focus/polls`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-polls-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}},"status_id":{"type":"string"},"question":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/polls/{itemId}/vote":{"post":{"operationId":"mastodonPollsVote","summary":"Mastodon: Vote (Polls)","tags":["Focus · Mastodon"],"description":"Vote. Your polls and their results; vote in any poll. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/polls/ Generic route: `/v1/accounts/{accountId}/focus/polls`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"choices":{"type":"array","items":{"type":"integer","minimum":0},"minItems":1}},"required":["choices"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-polls-vote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/media/{itemId}":{"get":{"operationId":"mastodonMediaGet","summary":"Mastodon: Get a Media item","tags":["Focus · Mastodon"],"description":"Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: `/v1/accounts/{accountId}/focus/media`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-media-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonMediaUpdate","summary":"Mastodon: Update a Media item","tags":["Focus · Mastodon"],"description":"Alt text / focal point (only before attaching; afterwards edit the status media_attributes). Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","title":"Alt text"},"focus":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-media-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonMediaDelete","summary":"Mastodon: Delete a Media item","tags":["Focus · Mastodon"],"description":"Delete unattached media (4.4+). Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: `/v1/accounts/{accountId}/focus/media`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-media-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/media":{"post":{"operationId":"mastodonMediaCreate","summary":"Mastodon: Create a Media item","tags":["Focus · Mastodon"],"description":"POST /api/v2/media (waits for processing). Upload media, edit alt text / focal point before attaching, delete unattached uploads (unattached media is purged after 1 day). Requires scopes: write:media. Network docs: https://docs.joinmastodon.org/methods/media/ Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string","description":"Socialit media id"},"url":{"type":"string","format":"uri","description":"Or a public URL"},"description":{"type":"string","title":"Alt text"},"focus":{"type":"string","description":"\"x,y\" in -1.0..1.0"},"thumbnail":{"type":"string","description":"Custom thumbnail (video/audio)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-media-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/pinned-statuses":{"get":{"operationId":"mastodonPinnedStatusesList","summary":"Mastodon: List Pinned posts","tags":["Focus · Mastodon"],"description":"Statuses pinned to your profile (max configuration.accounts.max_pinned_statuses, default 5). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/#pin Generic route: `/v1/accounts/{accountId}/focus/pinned-statuses`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-pinned-statuses-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonPinnedStatusesCreate","summary":"Mastodon: Create a Pinned posts item","tags":["Focus · Mastodon"],"description":"Statuses pinned to your profile (max configuration.accounts.max_pinned_statuses, default 5). Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/#pin Generic route: `/v1/accounts/{accountId}/focus/pinned-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status_id":{"type":"string"}},"required":["status_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-pinned-statuses-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/pinned-statuses/{itemId}":{"delete":{"operationId":"mastodonPinnedStatusesDelete","summary":"Mastodon: Delete a Pinned posts item","tags":["Focus · Mastodon"],"description":"Statuses pinned to your profile (max configuration.accounts.max_pinned_statuses, default 5). Requires scopes: read:statuses, write:accounts. Network docs: https://docs.joinmastodon.org/methods/statuses/#pin Generic route: `/v1/accounts/{accountId}/focus/pinned-statuses`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-pinned-statuses-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notifications":{"get":{"operationId":"mastodonNotificationsList","summary":"Mastodon: List Notifications","tags":["Focus · Mastodon"],"description":"All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: `/v1/accounts/{accountId}/focus/notifications`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["mention","status","reblog","follow","follow_request","favourite","poll","update","admin.sign_up","admin.report","severed_relationships","moderation_warning","quote","quoted_update","added_to_collection","collection_update"]}},"in":"query","name":"types","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["mention","status","reblog","follow","follow_request","favourite","poll","update","admin.sign_up","admin.report","severed_relationships","moderation_warning","quote","quoted_update","added_to_collection","collection_update"]}},"in":"query","name":"exclude_types","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"boolean"},"in":"query","name":"include_filtered","required":false,"description":"Include notifications filtered by the notification policy (4.3+)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notifications-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["mention","status","reblog","follow","follow_request","favourite","poll","update","admin.sign_up","admin.report","severed_relationships","moderation_warning","quote","quoted_update","added_to_collection","collection_update"]},"created_at":{"type":"string","format":"date-time"},"group_key":{"type":["null","string"]},"author":{"type":["null","string"],"title":"From"},"author_name":{"type":["null","string"]},"text":{"type":["null","string"]},"status_id":{"type":["null","string"]},"visibility":{"type":["null","string"]},"filtered":{"type":["null","boolean"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]},"status":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"]},"report":{"type":["null","object"],"properties":{},"additionalProperties":true},"moderation_warning":{"type":["null","object"],"properties":{},"additionalProperties":true},"event":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id","type"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notifications/{itemId}":{"get":{"operationId":"mastodonNotificationsGet","summary":"Mastodon: Get a Notifications item","tags":["Focus · Mastodon"],"description":"All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: `/v1/accounts/{accountId}/focus/notifications`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notifications-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["mention","status","reblog","follow","follow_request","favourite","poll","update","admin.sign_up","admin.report","severed_relationships","moderation_warning","quote","quoted_update","added_to_collection","collection_update"]},"created_at":{"type":"string","format":"date-time"},"group_key":{"type":["null","string"]},"author":{"type":["null","string"],"title":"From"},"author_name":{"type":["null","string"]},"text":{"type":["null","string"]},"status_id":{"type":["null","string"]},"visibility":{"type":["null","string"]},"filtered":{"type":["null","boolean"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]},"status":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"]},"report":{"type":["null","object"],"properties":{},"additionalProperties":true},"moderation_warning":{"type":["null","object"],"properties":{},"additionalProperties":true},"event":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id","type"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notifications/{itemId}/dismiss":{"post":{"operationId":"mastodonNotificationsDismiss","summary":"Mastodon: Dismiss (Notifications)","tags":["Focus · Mastodon"],"description":"Dismiss. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: `/v1/accounts/{accountId}/focus/notifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notifications-dismiss","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notifications/clear":{"post":{"operationId":"mastodonNotificationsClear","summary":"Mastodon: Clear all (Notifications)","tags":["Focus · Mastodon"],"description":"Clear all. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Destructive. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: `/v1/accounts/{accountId}/focus/notifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notifications-clear","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notifications/unread-count":{"post":{"operationId":"mastodonNotificationsUnreadCount","summary":"Mastodon: Unread count (Notifications)","tags":["Focus · Mastodon"],"description":"Unread count. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: `/v1/accounts/{accountId}/focus/notifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notifications-unread-count","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notifications/{itemId}/reply":{"post":{"operationId":"mastodonNotificationsReply","summary":"Mastodon: Reply (Notifications)","tags":["Focus · Mastodon"],"description":"Reply. All notifications (mentions, boosts, favourites, follows, quotes, polls, moderation…). Requires scopes: read:notifications, write:statuses. Network docs: https://docs.joinmastodon.org/methods/notifications/ Generic route: `/v1/accounts/{accountId}/focus/notifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notifications-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/grouped-notifications":{"get":{"operationId":"mastodonGroupedNotificationsList","summary":"Mastodon: List Grouped notifications","tags":["Focus · Mastodon"],"description":"Notifications grouped like the Mastodon web UI (\"Alice and 12 others favourited…\"). Mastodon 4.3+. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: `/v1/accounts/{accountId}/focus/grouped-notifications`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["mention","status","reblog","follow","follow_request","favourite","poll","update","admin.sign_up","admin.report","severed_relationships","moderation_warning","quote","quoted_update","added_to_collection","collection_update"]}},"in":"query","name":"types","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["mention","status","reblog","follow","follow_request","favourite","poll","update","admin.sign_up","admin.report","severed_relationships","moderation_warning","quote","quoted_update","added_to_collection","collection_update"]}},"in":"query","name":"exclude_types","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["favourite","follow","reblog"]}},"in":"query","name":"grouped_types","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"boolean"},"in":"query","name":"include_filtered","required":false},{"schema":{"type":"string","enum":["full","partial_avatars"]},"in":"query","name":"expand_accounts","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-grouped-notifications-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"group_key":{"type":"string","readOnly":true},"type":{"type":"string","enum":["mention","status","reblog","follow","follow_request","favourite","poll","update","admin.sign_up","admin.report","severed_relationships","moderation_warning","quote","quoted_update","added_to_collection","collection_update"]},"notifications_count":{"type":"integer"},"most_recent_notification_id":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"},"author":{"type":["null","string"]},"text":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]}},"status":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"]},"sample_account_ids":{"type":"array","items":{"type":"string"}}},"required":["group_key"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/grouped-notifications/{itemId}":{"get":{"operationId":"mastodonGroupedNotificationsGet","summary":"Mastodon: Get a Grouped notifications item","tags":["Focus · Mastodon"],"description":"Notifications grouped like the Mastodon web UI (\"Alice and 12 others favourited…\"). Mastodon 4.3+. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: `/v1/accounts/{accountId}/focus/grouped-notifications`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-grouped-notifications-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"group_key":{"type":"string","readOnly":true},"type":{"type":"string","enum":["mention","status","reblog","follow","follow_request","favourite","poll","update","admin.sign_up","admin.report","severed_relationships","moderation_warning","quote","quoted_update","added_to_collection","collection_update"]},"notifications_count":{"type":"integer"},"most_recent_notification_id":{"type":"string"},"created_at":{"type":["null","string"],"format":"date-time"},"author":{"type":["null","string"]},"text":{"type":["null","string"]},"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]}},"status":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"]},"sample_account_ids":{"type":"array","items":{"type":"string"}}},"required":["group_key"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/grouped-notifications/{itemId}/dismiss":{"post":{"operationId":"mastodonGroupedNotificationsDismiss","summary":"Mastodon: Dismiss group (Grouped notifications)","tags":["Focus · Mastodon"],"description":"Dismiss group. Notifications grouped like the Mastodon web UI (\"Alice and 12 others favourited…\"). Mastodon 4.3+. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: `/v1/accounts/{accountId}/focus/grouped-notifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-grouped-notifications-dismiss","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/grouped-notifications/{itemId}/accounts":{"post":{"operationId":"mastodonGroupedNotificationsAccounts","summary":"Mastodon: Accounts in group (Grouped notifications)","tags":["Focus · Mastodon"],"description":"Accounts in group. Notifications grouped like the Mastodon web UI (\"Alice and 12 others favourited…\"). Mastodon 4.3+. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: `/v1/accounts/{accountId}/focus/grouped-notifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-grouped-notifications-accounts","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/grouped-notifications/unread-count":{"post":{"operationId":"mastodonGroupedNotificationsUnreadCount","summary":"Mastodon: Unread count (Grouped notifications)","tags":["Focus · Mastodon"],"description":"Unread count. Notifications grouped like the Mastodon web UI (\"Alice and 12 others favourited…\"). Mastodon 4.3+. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/grouped_notifications/ Generic route: `/v1/accounts/{accountId}/focus/grouped-notifications`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-grouped-notifications-unread-count","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notification-policy":{"get":{"operationId":"mastodonNotificationPolicyGet","summary":"Mastodon: Get Notification filtering","tags":["Focus · Mastodon"],"description":"Filter or drop notifications from people you don’t follow, new accounts, private mentions, moderated accounts (4.3+). Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-policy Generic route: `/v1/accounts/{accountId}/focus/notification-policy`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notification-policy-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"for_not_following":{"type":"string","enum":["accept","filter","drop"]},"for_not_followers":{"type":"string","enum":["accept","filter","drop"]},"for_new_accounts":{"type":"string","enum":["accept","filter","drop"]},"for_private_mentions":{"type":"string","enum":["accept","filter","drop"]},"for_limited_accounts":{"type":"string","enum":["accept","filter","drop"]},"summary":{"type":"object","properties":{"pending_requests_count":{"type":"integer"},"pending_notifications_count":{"type":"integer"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonNotificationPolicyUpdate","summary":"Mastodon: Update Notification filtering","tags":["Focus · Mastodon"],"description":"Filter or drop notifications from people you don’t follow, new accounts, private mentions, moderated accounts (4.3+). Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-policy Generic route: `/v1/accounts/{accountId}/focus/notification-policy`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"for_not_following":{"type":"string","enum":["accept","filter","drop"]},"for_not_followers":{"type":"string","enum":["accept","filter","drop"]},"for_new_accounts":{"type":"string","enum":["accept","filter","drop"]},"for_private_mentions":{"type":"string","enum":["accept","filter","drop"]},"for_limited_accounts":{"type":"string","enum":["accept","filter","drop"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notification-policy-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"for_not_following":{"type":"string","enum":["accept","filter","drop"]},"for_not_followers":{"type":"string","enum":["accept","filter","drop"]},"for_new_accounts":{"type":"string","enum":["accept","filter","drop"]},"for_private_mentions":{"type":"string","enum":["accept","filter","drop"]},"for_limited_accounts":{"type":"string","enum":["accept","filter","drop"]},"summary":{"type":"object","properties":{"pending_requests_count":{"type":"integer"},"pending_notifications_count":{"type":"integer"}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notification-requests":{"get":{"operationId":"mastodonNotificationRequestsList","summary":"Mastodon: List Message requests","tags":["Focus · Mastodon"],"description":"Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: `/v1/accounts/{accountId}/focus/notification-requests`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notification-requests-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"notifications_count":{"type":"string"},"author":{"type":"string","title":"From"},"text":{"type":["null","string"]},"account":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]},"last_status":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"]}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notification-requests/{itemId}":{"get":{"operationId":"mastodonNotificationRequestsGet","summary":"Mastodon: Get a Message requests item","tags":["Focus · Mastodon"],"description":"Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: `/v1/accounts/{accountId}/focus/notification-requests`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notification-requests-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"notifications_count":{"type":"string"},"author":{"type":"string","title":"From"},"text":{"type":["null","string"]},"account":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]},"last_status":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"]}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notification-requests/{itemId}/accept":{"post":{"operationId":"mastodonNotificationRequestsAccept","summary":"Mastodon: Accept (Message requests)","tags":["Focus · Mastodon"],"description":"Accept. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: `/v1/accounts/{accountId}/focus/notification-requests`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notification-requests-accept","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notification-requests/{itemId}/dismiss":{"post":{"operationId":"mastodonNotificationRequestsDismiss","summary":"Mastodon: Dismiss (Message requests)","tags":["Focus · Mastodon"],"description":"Dismiss. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Destructive. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: `/v1/accounts/{accountId}/focus/notification-requests`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notification-requests-dismiss","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notification-requests/accept-many":{"post":{"operationId":"mastodonNotificationRequestsAcceptMany","summary":"Mastodon: Accept selected (Message requests)","tags":["Focus · Mastodon"],"description":"Accept selected. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: `/v1/accounts/{accountId}/focus/notification-requests`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"},"minItems":1}},"required":["ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notification-requests-accept-many","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notification-requests/dismiss-many":{"post":{"operationId":"mastodonNotificationRequestsDismissMany","summary":"Mastodon: Dismiss selected (Message requests)","tags":["Focus · Mastodon"],"description":"Dismiss selected. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Destructive. Requires scopes: read:notifications, write:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: `/v1/accounts/{accountId}/focus/notification-requests`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"},"minItems":1}},"required":["ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notification-requests-dismiss-many","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/notification-requests/merged":{"post":{"operationId":"mastodonNotificationRequestsMerged","summary":"Mastodon: Merge status (Message requests)","tags":["Focus · Mastodon"],"description":"Merge status. Notifications held back by your filtering policy (mentions and DMs from strangers). Accept to move them into the inbox. Requires scopes: read:notifications. Network docs: https://docs.joinmastodon.org/methods/notifications/#get-requests Generic route: `/v1/accounts/{accountId}/focus/notification-requests`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-notification-requests-merged","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/conversations":{"get":{"operationId":"mastodonConversationsList","summary":"Mastodon: List Direct messages","tags":["Focus · Mastodon"],"description":"Private mentions grouped into conversations. Replies @mention every participant. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-conversations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time"},"unread":{"type":"boolean"},"unread_count":{"type":"integer"},"last_message":{"type":["null","string"]},"last_status_id":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"avatar_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":"string","format":"date-time"},"from_id":{"type":"string"},"from_username":{"type":"string"},"attachments":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}}}}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonConversationsCreate","summary":"Mastodon: Create a Direct messages item","tags":["Focus · Mastodon"],"description":"Start a DM (visibility=direct). Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"array","items":{"type":"string","description":"@user@domain or account id"},"minItems":1},"text":{"type":"string"},"media":{"type":"array","items":{"type":"string"}},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"}},"required":["to"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-conversations-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time"},"unread":{"type":"boolean"},"unread_count":{"type":"integer"},"last_message":{"type":["null","string"]},"last_status_id":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"avatar_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":"string","format":"date-time"},"from_id":{"type":"string"},"from_username":{"type":"string"},"attachments":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}}}}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/conversations/{itemId}":{"get":{"operationId":"mastodonConversationsGet","summary":"Mastodon: Get a Direct messages item","tags":["Focus · Mastodon"],"description":"Conversation + its direct messages. Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-conversations-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time"},"unread":{"type":"boolean"},"unread_count":{"type":"integer"},"last_message":{"type":["null","string"]},"last_status_id":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"avatar_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":"string","format":"date-time"},"from_id":{"type":"string"},"from_username":{"type":"string"},"attachments":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}}}}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonConversationsDelete","summary":"Mastodon: Delete a Direct messages item","tags":["Focus · Mastodon"],"description":"Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:conversations. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-conversations-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/conversations/{itemId}/read":{"post":{"operationId":"mastodonConversationsRead","summary":"Mastodon: Mark as read (Direct messages)","tags":["Focus · Mastodon"],"description":"Mark as read. Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:conversations. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-conversations-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/conversations/{itemId}/reply":{"post":{"operationId":"mastodonConversationsReply","summary":"Mastodon: Reply (Direct messages)","tags":["Focus · Mastodon"],"description":"Reply. Private mentions grouped into conversations. Replies @mention every participant. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/conversations/ Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"media":{"type":"array","items":{"type":"string"}},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-conversations-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/comments":{"get":{"operationId":"mastodonCommentsList","summary":"Mastodon: List Comments","tags":["Focus · Mastodon"],"description":"Replies to your posts (thread context + reply mentions, including filtered ones). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:statuses, read:notifications. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"post_id","required":false,"description":"Replies to one post; omit for recent replies across your posts"},{"schema":{"type":"integer","default":5,"maximum":40},"in":"query","name":"recent_posts","required":false,"description":"How many recent own posts to scan when post_id is omitted"},{"schema":{"type":"integer","default":40,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-comments-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"author":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"share_count":{"type":"integer"},"parent_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"visibility":{"type":"string"},"liked":{"type":"boolean"},"is_own":{"type":"boolean"},"spoiler_text":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"},"attachments":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/comments/{itemId}":{"get":{"operationId":"mastodonCommentsGet","summary":"Mastodon: Get a Comments item","tags":["Focus · Mastodon"],"description":"Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-comments-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"author":{"type":"string"},"author_name":{"type":["null","string"]},"author_avatar":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"share_count":{"type":"integer"},"parent_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"visibility":{"type":"string"},"liked":{"type":"boolean"},"is_own":{"type":"boolean"},"spoiler_text":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"},"attachments":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonCommentsDelete","summary":"Mastodon: Delete a Comments item","tags":["Focus · Mastodon"],"description":"Delete your own reply (others’ replies cannot be deleted). Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-comments-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/comments/{itemId}/reply":{"post":{"operationId":"mastodonCommentsReply","summary":"Mastodon: Reply (Comments)","tags":["Focus · Mastodon"],"description":"Reply. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:statuses. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"mention_all":{"type":"boolean"},"media":{"type":"array","items":{"type":"string"}}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-comments-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/comments/{itemId}/like":{"post":{"operationId":"mastodonCommentsLike","summary":"Mastodon: Favourite (Comments)","tags":["Focus · Mastodon"],"description":"Favourite. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-comments-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/comments/{itemId}/unlike":{"post":{"operationId":"mastodonCommentsUnlike","summary":"Mastodon: Unfavourite (Comments)","tags":["Focus · Mastodon"],"description":"Unfavourite. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:favourites. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-comments-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/comments/{itemId}/mute-thread":{"post":{"operationId":"mastodonCommentsMuteThread","summary":"Mastodon: Mute thread (Comments)","tags":["Focus · Mastodon"],"description":"Mute thread. Replies to your posts (thread context + reply mentions, including filtered ones). Requires scopes: read:statuses, read:notifications, write:mutes. Network docs: https://docs.joinmastodon.org/methods/statuses/#context Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-comments-mute-thread","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/followers":{"get":{"operationId":"mastodonFollowersList","summary":"Mastodon: List Followers","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: `/v1/accounts/{accountId}/focus/followers`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false,"description":"Defaults to the connected account"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-followers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/followers/{itemId}/remove-from-followers":{"post":{"operationId":"mastodonFollowersRemoveFromFollowers","summary":"Mastodon: Remove from followers (Followers)","tags":["Focus · Mastodon"],"description":"Remove from followers. Destructive. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-followers-remove-from-followers","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/followers/{itemId}/follow":{"post":{"operationId":"mastodonFollowersFollow","summary":"Mastodon: Follow (Followers)","tags":["Focus · Mastodon"],"description":"Follow. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reblogs":{"type":"boolean","default":true},"notify":{"type":"boolean"},"languages":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-followers-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/followers/{itemId}/block":{"post":{"operationId":"mastodonFollowersBlock","summary":"Mastodon: Block (Followers)","tags":["Focus · Mastodon"],"description":"Block. Destructive. Requires scopes: write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/#followers Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-followers-block","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/following":{"get":{"operationId":"mastodonFollowingList","summary":"Mastodon: List Following","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: `/v1/accounts/{accountId}/focus/following`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-following-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonFollowingCreate","summary":"Mastodon: Create a Following item","tags":["Focus · Mastodon"],"description":"Follow an account by id or @user@domain (400 follows / 24 h). Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"account_id":{"type":"string"},"acct":{"type":"string","description":"@user@domain"},"reblogs":{"type":"boolean","default":true},"notify":{"type":"boolean"},"languages":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-following-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/following/{itemId}":{"delete":{"operationId":"mastodonFollowingDelete","summary":"Mastodon: Delete a Following item","tags":["Focus · Mastodon"],"description":"Unfollow. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: `/v1/accounts/{accountId}/focus/following`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-following-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/following/{itemId}/notify":{"post":{"operationId":"mastodonFollowingNotify","summary":"Mastodon: Notify on new posts (Following)","tags":["Focus · Mastodon"],"description":"Notify on new posts. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notify":{"type":"boolean","default":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-following-notify","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/following/{itemId}/mute":{"post":{"operationId":"mastodonFollowingMute","summary":"Mastodon: Mute (Following)","tags":["Focus · Mastodon"],"description":"Mute. Requires scopes: write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/#following Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notifications":{"type":"boolean","default":true},"duration":{"type":"integer","minimum":0,"description":"Seconds; 0 = indefinite"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-following-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/follow-requests":{"get":{"operationId":"mastodonFollowRequestsList","summary":"Mastodon: List Follow requests","tags":["Focus · Mastodon"],"description":"Pending requests to follow your locked account. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/follow_requests/ Generic route: `/v1/accounts/{accountId}/focus/follow-requests`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-follow-requests-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/follow-requests/{itemId}/authorize":{"post":{"operationId":"mastodonFollowRequestsAuthorize","summary":"Mastodon: Accept (Follow requests)","tags":["Focus · Mastodon"],"description":"Accept. Pending requests to follow your locked account. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/follow_requests/ Generic route: `/v1/accounts/{accountId}/focus/follow-requests`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-follow-requests-authorize","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/follow-requests/{itemId}/reject":{"post":{"operationId":"mastodonFollowRequestsReject","summary":"Mastodon: Reject (Follow requests)","tags":["Focus · Mastodon"],"description":"Reject. Pending requests to follow your locked account. Destructive. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/follow_requests/ Generic route: `/v1/accounts/{accountId}/focus/follow-requests`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-follow-requests-reject","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/relationships":{"get":{"operationId":"mastodonRelationshipsList","summary":"Mastodon: List Relationships","tags":["Focus · Mastodon"],"description":"Follow / block / mute state with given accounts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: `/v1/accounts/{accountId}/focus/relationships`.","parameters":[{"schema":{"type":"array","items":{"type":"string"},"minItems":1},"in":"query","name":"ids","required":true},{"schema":{"type":"boolean"},"in":"query","name":"with_suspended","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-relationships-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"following":{"type":"boolean"},"showing_reblogs":{"type":"boolean"},"notifying":{"type":"boolean"},"languages":{"type":["null","array"],"items":{"type":"string"}},"followed_by":{"type":"boolean"},"blocking":{"type":"boolean"},"blocked_by":{"type":"boolean"},"muting":{"type":"boolean"},"muting_notifications":{"type":"boolean"},"muting_expires_at":{"type":["null","string"],"format":"date-time"},"requested":{"type":"boolean"},"requested_by":{"type":"boolean"},"domain_blocking":{"type":"boolean"},"endorsed":{"type":"boolean"},"note":{"type":"string"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/relationships/{itemId}/follow":{"post":{"operationId":"mastodonRelationshipsFollow","summary":"Mastodon: Follow (Relationships)","tags":["Focus · Mastodon"],"description":"Follow. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: `/v1/accounts/{accountId}/focus/relationships`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reblogs":{"type":"boolean","default":true},"notify":{"type":"boolean"},"languages":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-relationships-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/relationships/{itemId}/unfollow":{"post":{"operationId":"mastodonRelationshipsUnfollow","summary":"Mastodon: Unfollow (Relationships)","tags":["Focus · Mastodon"],"description":"Unfollow. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: `/v1/accounts/{accountId}/focus/relationships`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-relationships-unfollow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/relationships/{itemId}/remove-from-followers":{"post":{"operationId":"mastodonRelationshipsRemoveFromFollowers","summary":"Mastodon: Remove from followers (Relationships)","tags":["Focus · Mastodon"],"description":"Remove from followers. Follow / block / mute state with given accounts. Destructive. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: `/v1/accounts/{accountId}/focus/relationships`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-relationships-remove-from-followers","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/relationships/{itemId}/block":{"post":{"operationId":"mastodonRelationshipsBlock","summary":"Mastodon: Block (Relationships)","tags":["Focus · Mastodon"],"description":"Block. Follow / block / mute state with given accounts. Destructive. Requires scopes: read:follows, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: `/v1/accounts/{accountId}/focus/relationships`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-relationships-block","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/relationships/{itemId}/unblock":{"post":{"operationId":"mastodonRelationshipsUnblock","summary":"Mastodon: Unblock (Relationships)","tags":["Focus · Mastodon"],"description":"Unblock. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: `/v1/accounts/{accountId}/focus/relationships`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-relationships-unblock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/relationships/{itemId}/mute":{"post":{"operationId":"mastodonRelationshipsMute","summary":"Mastodon: Mute (Relationships)","tags":["Focus · Mastodon"],"description":"Mute. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: `/v1/accounts/{accountId}/focus/relationships`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notifications":{"type":"boolean","default":true},"duration":{"type":"integer","minimum":0,"description":"Seconds; 0 = indefinite"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-relationships-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/relationships/{itemId}/unmute":{"post":{"operationId":"mastodonRelationshipsUnmute","summary":"Mastodon: Unmute (Relationships)","tags":["Focus · Mastodon"],"description":"Unmute. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: `/v1/accounts/{accountId}/focus/relationships`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-relationships-unmute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/relationships/{itemId}/note":{"post":{"operationId":"mastodonRelationshipsNote","summary":"Mastodon: Private note (Relationships)","tags":["Focus · Mastodon"],"description":"Private note. Follow / block / mute state with given accounts. Requires scopes: read:follows, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/#relationships Generic route: `/v1/accounts/{accountId}/focus/relationships`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-relationships-note","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/familiar-followers":{"get":{"operationId":"mastodonFamiliarFollowersList","summary":"Mastodon: List Familiar followers","tags":["Focus · Mastodon"],"description":"Accounts you follow that also follow the given accounts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/#familiar_followers Generic route: `/v1/accounts/{accountId}/focus/familiar-followers`.","parameters":[{"schema":{"type":"array","items":{"type":"string"},"minItems":1},"in":"query","name":"ids","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-familiar-followers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"count":{"type":"integer"},"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]}}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts":{"get":{"operationId":"mastodonAccountsList","summary":"Mastodon: List People","tags":["Focus · Mastodon"],"description":"Account search (GET /api/v1/accounts/search). Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"type":"boolean"},"in":"query","name":"resolve","required":false,"description":"WebFinger-resolve remote handles"},{"schema":{"type":"boolean"},"in":"query","name":"following","required":false},{"schema":{"type":"integer","maximum":80},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}":{"get":{"operationId":"mastodonAccountsGet","summary":"Mastodon: Get a People item","tags":["Focus · Mastodon"],"description":"Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/lookup":{"post":{"operationId":"mastodonAccountsLookup","summary":"Mastodon: Look up handle (People)","tags":["Focus · Mastodon"],"description":"Look up handle. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"acct":{"type":"string","description":"user or user@domain"}},"required":["acct"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-lookup","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/statuses":{"post":{"operationId":"mastodonAccountsStatuses","summary":"Mastodon: Posts (People)","tags":["Focus · Mastodon"],"description":"Posts. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from a previous next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":80,"default":20},"only_media":{"type":"boolean"},"exclude_replies":{"type":"boolean"},"exclude_reblogs":{"type":"boolean"},"pinned":{"type":"boolean"},"tagged":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-statuses","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/lists":{"post":{"operationId":"mastodonAccountsLists","summary":"Mastodon: Lists containing (People)","tags":["Focus · Mastodon"],"description":"Lists containing. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, read:lists. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-lists","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/featured-tags":{"post":{"operationId":"mastodonAccountsFeaturedTags","summary":"Mastodon: Featured hashtags (People)","tags":["Focus · Mastodon"],"description":"Featured hashtags. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-featured-tags","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/endorsements":{"post":{"operationId":"mastodonAccountsEndorsements","summary":"Mastodon: Featured accounts (People)","tags":["Focus · Mastodon"],"description":"Featured accounts. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from a previous next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":80,"default":20}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-endorsements","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/follow":{"post":{"operationId":"mastodonAccountsFollow","summary":"Mastodon: Follow (People)","tags":["Focus · Mastodon"],"description":"Follow. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reblogs":{"type":"boolean","default":true},"notify":{"type":"boolean"},"languages":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/unfollow":{"post":{"operationId":"mastodonAccountsUnfollow","summary":"Mastodon: Unfollow (People)","tags":["Focus · Mastodon"],"description":"Unfollow. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-unfollow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/remove-from-followers":{"post":{"operationId":"mastodonAccountsRemoveFromFollowers","summary":"Mastodon: Remove from followers (People)","tags":["Focus · Mastodon"],"description":"Remove from followers. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Destructive. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-remove-from-followers","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/block":{"post":{"operationId":"mastodonAccountsBlock","summary":"Mastodon: Block (People)","tags":["Focus · Mastodon"],"description":"Block. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Destructive. Requires scopes: read:accounts, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-block","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/unblock":{"post":{"operationId":"mastodonAccountsUnblock","summary":"Mastodon: Unblock (People)","tags":["Focus · Mastodon"],"description":"Unblock. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:blocks. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-unblock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/mute":{"post":{"operationId":"mastodonAccountsMute","summary":"Mastodon: Mute (People)","tags":["Focus · Mastodon"],"description":"Mute. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notifications":{"type":"boolean","default":true},"duration":{"type":"integer","minimum":0,"description":"Seconds; 0 = indefinite"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/unmute":{"post":{"operationId":"mastodonAccountsUnmute","summary":"Mastodon: Unmute (People)","tags":["Focus · Mastodon"],"description":"Unmute. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:mutes. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-unmute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/endorse":{"post":{"operationId":"mastodonAccountsEndorse","summary":"Mastodon: Feature on profile (People)","tags":["Focus · Mastodon"],"description":"Feature on profile. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-endorse","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/unendorse":{"post":{"operationId":"mastodonAccountsUnendorse","summary":"Mastodon: Unfeature (People)","tags":["Focus · Mastodon"],"description":"Unfeature. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-unendorse","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/accounts/{itemId}/note":{"post":{"operationId":"mastodonAccountsNote","summary":"Mastodon: Private note (People)","tags":["Focus · Mastodon"],"description":"Private note. Search and look up accounts (local or remote), see their posts, follow, block, mute, endorse, add notes. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/accounts/ Generic route: `/v1/accounts/{accountId}/focus/accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-accounts-note","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/lists":{"get":{"operationId":"mastodonListsList","summary":"Mastodon: List Lists","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: `/v1/accounts/{accountId}/focus/lists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-lists-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"replies_policy":{"type":"string","enum":["followed","list","none"]},"exclusive":{"type":"boolean","description":"Hide members from the home timeline (4.2+)"}},"required":["id","title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonListsCreate","summary":"Mastodon: Create a Lists item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"replies_policy":{"type":"string","enum":["followed","list","none"]},"exclusive":{"type":"boolean"}},"required":["title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-lists-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"replies_policy":{"type":"string","enum":["followed","list","none"]},"exclusive":{"type":"boolean","description":"Hide members from the home timeline (4.2+)"}},"required":["id","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/lists/{itemId}":{"get":{"operationId":"mastodonListsGet","summary":"Mastodon: Get a Lists item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: `/v1/accounts/{accountId}/focus/lists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-lists-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"replies_policy":{"type":"string","enum":["followed","list","none"]},"exclusive":{"type":"boolean","description":"Hide members from the home timeline (4.2+)"}},"required":["id","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonListsUpdate","summary":"Mastodon: Update a Lists item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"replies_policy":{"type":"string","enum":["followed","list","none"]},"exclusive":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-lists-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"replies_policy":{"type":"string","enum":["followed","list","none"]},"exclusive":{"type":"boolean","description":"Hide members from the home timeline (4.2+)"}},"required":["id","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonListsDelete","summary":"Mastodon: Delete a Lists item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: `/v1/accounts/{accountId}/focus/lists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-lists-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/lists/{itemId}/timeline":{"post":{"operationId":"mastodonListsTimeline","summary":"Mastodon: List timeline (Lists)","tags":["Focus · Mastodon"],"description":"List timeline. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from a previous next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":80,"default":20}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-lists-timeline","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/lists/{itemId}/members":{"post":{"operationId":"mastodonListsMembers","summary":"Mastodon: Members (Lists)","tags":["Focus · Mastodon"],"description":"Members. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from a previous next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":80,"default":20}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-lists-members","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/lists/{itemId}/add-accounts":{"post":{"operationId":"mastodonListsAddAccounts","summary":"Mastodon: Add accounts (Lists)","tags":["Focus · Mastodon"],"description":"Add accounts. Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"account_ids":{"type":"array","items":{"type":"string"},"minItems":1}},"required":["account_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-lists-add-accounts","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/lists/{itemId}/remove-accounts":{"post":{"operationId":"mastodonListsRemoveAccounts","summary":"Mastodon: Remove accounts (Lists)","tags":["Focus · Mastodon"],"description":"Remove accounts. Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/ Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"account_ids":{"type":"array","items":{"type":"string"},"minItems":1}},"required":["account_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-lists-remove-accounts","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/list-members":{"get":{"operationId":"mastodonListMembersList","summary":"Mastodon: List List members","tags":["Focus · Mastodon"],"description":"Accounts in a list (you must follow an account before adding it). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/lists/#accounts Generic route: `/v1/accounts/{accountId}/focus/list-members`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"list_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-members-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"<list_id>:<account_id>"},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"},"account_id":{"type":"string"},"list_id":{"type":"string"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonListMembersCreate","summary":"Mastodon: Create a List members item","tags":["Focus · Mastodon"],"description":"Accounts in a list (you must follow an account before adding it). Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/#accounts Generic route: `/v1/accounts/{accountId}/focus/list-members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list_id":{"type":"string"},"account_ids":{"type":"array","items":{"type":"string"},"minItems":1}},"required":["list_id","account_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-members-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"<list_id>:<account_id>"},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"},"account_id":{"type":"string"},"list_id":{"type":"string"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/list-members/{itemId}":{"delete":{"operationId":"mastodonListMembersDelete","summary":"Mastodon: Delete a List members item","tags":["Focus · Mastodon"],"description":"Accounts in a list (you must follow an account before adding it). Requires scopes: read:lists, write:lists. Network docs: https://docs.joinmastodon.org/methods/lists/#accounts Generic route: `/v1/accounts/{accountId}/focus/list-members`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-members-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/endorsements":{"get":{"operationId":"mastodonEndorsementsList","summary":"Mastodon: List Featured accounts","tags":["Focus · Mastodon"],"description":"Accounts you feature (endorse) on your profile. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/endorsements/ Generic route: `/v1/accounts/{accountId}/focus/endorsements`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-endorsements-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonEndorsementsCreate","summary":"Mastodon: Create a Featured accounts item","tags":["Focus · Mastodon"],"description":"Accounts you feature (endorse) on your profile. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/endorsements/ Generic route: `/v1/accounts/{accountId}/focus/endorsements`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"account_id":{"type":"string"}},"required":["account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-endorsements-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/endorsements/{itemId}":{"delete":{"operationId":"mastodonEndorsementsDelete","summary":"Mastodon: Delete a Featured accounts item","tags":["Focus · Mastodon"],"description":"Accounts you feature (endorse) on your profile. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/endorsements/ Generic route: `/v1/accounts/{accountId}/focus/endorsements`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-endorsements-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/collections":{"get":{"operationId":"mastodonCollectionsList","summary":"Mastodon: List Collections","tags":["Focus · Mastodon"],"description":"Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: `/v1/accounts/{accountId}/focus/collections`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-collections-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"description":{"type":["null","string"]},"sensitive":{"type":["null","boolean"]},"discoverable":{"type":["null","boolean"]},"language":{"type":["null","string"]},"tag":{"type":["null","object"],"properties":{},"additionalProperties":true},"items_count":{"type":["null","integer"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"state":{"type":"string"},"account":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]}}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonCollectionsCreate","summary":"Mastodon: Create a Collections item","tags":["Focus · Mastodon"],"description":"Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: `/v1/accounts/{accountId}/focus/collections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"sensitive":{"type":"boolean"},"discoverable":{"type":"boolean"},"language":{"type":"string"},"tag_name":{"type":"string"},"account_ids":{"type":"array","items":{"type":"string"},"maxItems":25}},"required":["name"],"additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-collections-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"description":{"type":["null","string"]},"sensitive":{"type":["null","boolean"]},"discoverable":{"type":["null","boolean"]},"language":{"type":["null","string"]},"tag":{"type":["null","object"],"properties":{},"additionalProperties":true},"items_count":{"type":["null","integer"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"state":{"type":"string"},"account":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]}}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/collections/{itemId}":{"get":{"operationId":"mastodonCollectionsGet","summary":"Mastodon: Get a Collections item","tags":["Focus · Mastodon"],"description":"Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: `/v1/accounts/{accountId}/focus/collections`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-collections-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"description":{"type":["null","string"]},"sensitive":{"type":["null","boolean"]},"discoverable":{"type":["null","boolean"]},"language":{"type":["null","string"]},"tag":{"type":["null","object"],"properties":{},"additionalProperties":true},"items_count":{"type":["null","integer"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"state":{"type":"string"},"account":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]}}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonCollectionsUpdate","summary":"Mastodon: Update a Collections item","tags":["Focus · Mastodon"],"description":"Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: `/v1/accounts/{accountId}/focus/collections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"sensitive":{"type":"boolean"},"discoverable":{"type":"boolean"},"language":{"type":"string"},"tag_name":{"type":"string"},"account_ids":{"type":"array","items":{"type":"string"},"maxItems":25}},"additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-collections-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"description":{"type":["null","string"]},"sensitive":{"type":["null","boolean"]},"discoverable":{"type":["null","boolean"]},"language":{"type":["null","string"]},"tag":{"type":["null","object"],"properties":{},"additionalProperties":true},"items_count":{"type":["null","integer"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"state":{"type":"string"},"account":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]}}}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonCollectionsDelete","summary":"Mastodon: Delete a Collections item","tags":["Focus · Mastodon"],"description":"Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: `/v1/accounts/{accountId}/focus/collections`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-collections-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/collections/{itemId}/add-item":{"post":{"operationId":"mastodonCollectionsAddItem","summary":"Mastodon: Add account (Collections)","tags":["Focus · Mastodon"],"description":"Add account. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: `/v1/accounts/{accountId}/focus/collections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"account_id":{"type":"string"}},"required":["account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-collections-add-item","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/collections/{itemId}/remove-item":{"post":{"operationId":"mastodonCollectionsRemoveItem","summary":"Mastodon: Remove account (Collections)","tags":["Focus · Mastodon"],"description":"Remove account. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: `/v1/accounts/{accountId}/focus/collections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"}},"required":["item_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-collections-remove-item","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/collections/{itemId}/revoke":{"post":{"operationId":"mastodonCollectionsRevoke","summary":"Mastodon: Remove me from this collection (Collections)","tags":["Focus · Mastodon"],"description":"Remove me from this collection. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Destructive. Requires scopes: read:collections, write:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: `/v1/accounts/{accountId}/focus/collections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"}},"required":["item_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-collections-revoke","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/collections/in-collections":{"post":{"operationId":"mastodonCollectionsInCollections","summary":"Mastodon: Collections featuring an account (Collections)","tags":["Focus · Mastodon"],"description":"Collections featuring an account. Curated sets of up to 25 accounts (Mastodon 4.6+, FEP-7aa9). Body fields beyond name/description are passed through (unverified). Requires scopes: read:collections. Network docs: https://docs.joinmastodon.org/methods/collections/ Generic route: `/v1/accounts/{accountId}/focus/collections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Opaque cursor from a previous next_cursor"},"limit":{"type":"integer","minimum":1,"maximum":80,"default":20},"account_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-collections-in-collections","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/suggestions":{"get":{"operationId":"mastodonSuggestionsList","summary":"Mastodon: List Who to follow","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/suggestions/ Generic route: `/v1/accounts/{accountId}/focus/suggestions`.","parameters":[{"schema":{"type":"integer","maximum":80,"default":40},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-suggestions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"},"sources":{"type":"array","items":{"type":"string"}}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/suggestions/{itemId}":{"delete":{"operationId":"mastodonSuggestionsDelete","summary":"Mastodon: Delete a Who to follow item","tags":["Focus · Mastodon"],"description":"Never suggest this account again. Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/suggestions/ Generic route: `/v1/accounts/{accountId}/focus/suggestions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-suggestions-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/suggestions/{itemId}/follow":{"post":{"operationId":"mastodonSuggestionsFollow","summary":"Mastodon: Follow (Who to follow)","tags":["Focus · Mastodon"],"description":"Follow. Requires scopes: read:accounts, write:follows. Network docs: https://docs.joinmastodon.org/methods/suggestions/ Generic route: `/v1/accounts/{accountId}/focus/suggestions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reblogs":{"type":"boolean","default":true},"notify":{"type":"boolean"},"languages":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-suggestions-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/directory":{"get":{"operationId":"mastodonDirectoryList","summary":"Mastodon: List Profile directory","tags":["Focus · Mastodon"],"description":"Discoverable accounts known to the instance. Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/directory/ Generic route: `/v1/accounts/{accountId}/focus/directory`.","parameters":[{"schema":{"type":"string","enum":["active","new"]},"in":"query","name":"order","required":false},{"schema":{"type":"boolean"},"in":"query","name":"local","required":false},{"schema":{"type":"integer","maximum":80,"default":40},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-directory-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/directory/{itemId}/follow":{"post":{"operationId":"mastodonDirectoryFollow","summary":"Mastodon: Follow (Profile directory)","tags":["Focus · Mastodon"],"description":"Follow. Discoverable accounts known to the instance. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/directory/ Generic route: `/v1/accounts/{accountId}/focus/directory`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reblogs":{"type":"boolean","default":true},"notify":{"type":"boolean"},"languages":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-directory-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/bookmarks":{"get":{"operationId":"mastodonBookmarksList","summary":"Mastodon: List Bookmarks","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:bookmarks. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: `/v1/accounts/{accountId}/focus/bookmarks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-bookmarks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonBookmarksCreate","summary":"Mastodon: Create a Bookmarks item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:bookmarks, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: `/v1/accounts/{accountId}/focus/bookmarks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status_id":{"type":"string"}},"required":["status_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-bookmarks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/bookmarks/{itemId}":{"delete":{"operationId":"mastodonBookmarksDelete","summary":"Mastodon: Delete a Bookmarks item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:bookmarks, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: `/v1/accounts/{accountId}/focus/bookmarks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-bookmarks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/bookmarks/{itemId}/favourite":{"post":{"operationId":"mastodonBookmarksFavourite","summary":"Mastodon: Favourite (Bookmarks)","tags":["Focus · Mastodon"],"description":"Favourite. Requires scopes: read:bookmarks, write:favourites. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: `/v1/accounts/{accountId}/focus/bookmarks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-bookmarks-favourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/bookmarks/{itemId}/boost":{"post":{"operationId":"mastodonBookmarksBoost","summary":"Mastodon: Boost (Bookmarks)","tags":["Focus · Mastodon"],"description":"Boost. Requires scopes: read:bookmarks, write:statuses. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: `/v1/accounts/{accountId}/focus/bookmarks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["public","unlisted","private"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-bookmarks-boost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/bookmarks/{itemId}/reply":{"post":{"operationId":"mastodonBookmarksReply","summary":"Mastodon: Reply (Bookmarks)","tags":["Focus · Mastodon"],"description":"Reply. Requires scopes: read:bookmarks, write:statuses. Network docs: https://docs.joinmastodon.org/methods/bookmarks/ Generic route: `/v1/accounts/{accountId}/focus/bookmarks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-bookmarks-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/favourites":{"get":{"operationId":"mastodonFavouritesList","summary":"Mastodon: List Favourites","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:favourites. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: `/v1/accounts/{accountId}/focus/favourites`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-favourites-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonFavouritesCreate","summary":"Mastodon: Create a Favourites item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:favourites, write:favourites. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: `/v1/accounts/{accountId}/focus/favourites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status_id":{"type":"string"}},"required":["status_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-favourites-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/favourites/{itemId}":{"delete":{"operationId":"mastodonFavouritesDelete","summary":"Mastodon: Delete a Favourites item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:favourites, write:favourites. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: `/v1/accounts/{accountId}/focus/favourites`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-favourites-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/favourites/{itemId}/bookmark":{"post":{"operationId":"mastodonFavouritesBookmark","summary":"Mastodon: Bookmark (Favourites)","tags":["Focus · Mastodon"],"description":"Bookmark. Requires scopes: read:favourites, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: `/v1/accounts/{accountId}/focus/favourites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-favourites-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/favourites/{itemId}/boost":{"post":{"operationId":"mastodonFavouritesBoost","summary":"Mastodon: Boost (Favourites)","tags":["Focus · Mastodon"],"description":"Boost. Requires scopes: read:favourites, write:statuses. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: `/v1/accounts/{accountId}/focus/favourites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["public","unlisted","private"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-favourites-boost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/favourites/{itemId}/reply":{"post":{"operationId":"mastodonFavouritesReply","summary":"Mastodon: Reply (Favourites)","tags":["Focus · Mastodon"],"description":"Reply. Requires scopes: read:favourites, write:statuses. Network docs: https://docs.joinmastodon.org/methods/favourites/ Generic route: `/v1/accounts/{accountId}/focus/favourites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-favourites-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/followed-tags":{"get":{"operationId":"mastodonFollowedTagsList","summary":"Mastodon: List Followed hashtags","tags":["Focus · Mastodon"],"description":"Hashtags whose posts appear in your home timeline. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: `/v1/accounts/{accountId}/focus/followed-tags`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-followed-tags-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"following":{"type":["null","boolean"]},"featuring":{"type":["null","boolean"]},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"uses":{"type":"string"},"accounts":{"type":"string"}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonFollowedTagsCreate","summary":"Mastodon: Create a Followed hashtags item","tags":["Focus · Mastodon"],"description":"Hashtags whose posts appear in your home timeline. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: `/v1/accounts/{accountId}/focus/followed-tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Without #"}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-followed-tags-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"following":{"type":["null","boolean"]},"featuring":{"type":["null","boolean"]},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"uses":{"type":"string"},"accounts":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/followed-tags/{itemId}":{"get":{"operationId":"mastodonFollowedTagsGet","summary":"Mastodon: Get a Followed hashtags item","tags":["Focus · Mastodon"],"description":"Hashtags whose posts appear in your home timeline. Requires scopes: read:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: `/v1/accounts/{accountId}/focus/followed-tags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-followed-tags-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"following":{"type":["null","boolean"]},"featuring":{"type":["null","boolean"]},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"uses":{"type":"string"},"accounts":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonFollowedTagsDelete","summary":"Mastodon: Delete a Followed hashtags item","tags":["Focus · Mastodon"],"description":"Hashtags whose posts appear in your home timeline. Requires scopes: read:follows, write:follows. Network docs: https://docs.joinmastodon.org/methods/followed_tags/ Generic route: `/v1/accounts/{accountId}/focus/followed-tags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-followed-tags-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/featured-tags":{"get":{"operationId":"mastodonFeaturedTagsList","summary":"Mastodon: List Featured hashtags","tags":["Focus · Mastodon"],"description":"Hashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: `/v1/accounts/{accountId}/focus/featured-tags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-featured-tags-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"statuses_count":{"type":"integer"},"last_status_at":{"type":["null","string"],"format":"date"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonFeaturedTagsCreate","summary":"Mastodon: Create a Featured hashtags item","tags":["Focus · Mastodon"],"description":"Hashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: `/v1/accounts/{accountId}/focus/featured-tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Without #"}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-featured-tags-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"statuses_count":{"type":"integer"},"last_status_at":{"type":["null","string"],"format":"date"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/featured-tags/{itemId}":{"delete":{"operationId":"mastodonFeaturedTagsDelete","summary":"Mastodon: Delete a Featured hashtags item","tags":["Focus · Mastodon"],"description":"Hashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: `/v1/accounts/{accountId}/focus/featured-tags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-featured-tags-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/featured-tags/suggestions":{"post":{"operationId":"mastodonFeaturedTagsSuggestions","summary":"Mastodon: Suggestions (Featured hashtags)","tags":["Focus · Mastodon"],"description":"Suggestions. Hashtags featured on your profile (max configuration.accounts.max_featured_tags, default 10). Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/featured_tags/ Generic route: `/v1/accounts/{accountId}/focus/featured-tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-featured-tags-suggestions","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/filters":{"get":{"operationId":"mastodonFiltersList","summary":"Mastodon: List Filters","tags":["Focus · Mastodon"],"description":"Keyword / status filters (v2) with warn, hide or blur actions. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: `/v1/accounts/{accountId}/focus/filters`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filters-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"context":{"type":"array","items":{"type":"string","enum":["home","notifications","public","thread","account"]},"minItems":1},"filter_action":{"type":"string","enum":["warn","hide","blur"]},"expires_at":{"type":["null","string"],"format":"date-time"},"keywords":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"keyword":{"type":"string"},"whole_word":{"type":"boolean"}}}},"statuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status_id":{"type":"string"}}}}},"required":["id","title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonFiltersCreate","summary":"Mastodon: Create a Filters item","tags":["Focus · Mastodon"],"description":"Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: `/v1/accounts/{accountId}/focus/filters`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"context":{"type":"array","items":{"type":"string","enum":["home","notifications","public","thread","account"]}},"filter_action":{"type":"string","enum":["warn","hide","blur"]},"expires_in":{"type":"integer","description":"Seconds; omit for never"},"keywords_attributes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"keyword":{"type":"string"},"whole_word":{"type":"boolean"},"_destroy":{"type":"boolean"}}}}},"required":["title","context"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filters-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"context":{"type":"array","items":{"type":"string","enum":["home","notifications","public","thread","account"]},"minItems":1},"filter_action":{"type":"string","enum":["warn","hide","blur"]},"expires_at":{"type":["null","string"],"format":"date-time"},"keywords":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"keyword":{"type":"string"},"whole_word":{"type":"boolean"}}}},"statuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status_id":{"type":"string"}}}}},"required":["id","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/filters/{itemId}":{"get":{"operationId":"mastodonFiltersGet","summary":"Mastodon: Get a Filters item","tags":["Focus · Mastodon"],"description":"Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: `/v1/accounts/{accountId}/focus/filters`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filters-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"context":{"type":"array","items":{"type":"string","enum":["home","notifications","public","thread","account"]},"minItems":1},"filter_action":{"type":"string","enum":["warn","hide","blur"]},"expires_at":{"type":["null","string"],"format":"date-time"},"keywords":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"keyword":{"type":"string"},"whole_word":{"type":"boolean"}}}},"statuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status_id":{"type":"string"}}}}},"required":["id","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonFiltersUpdate","summary":"Mastodon: Update a Filters item","tags":["Focus · Mastodon"],"description":"Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: `/v1/accounts/{accountId}/focus/filters`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"context":{"type":"array","items":{"type":"string","enum":["home","notifications","public","thread","account"]}},"filter_action":{"type":"string","enum":["warn","hide","blur"]},"expires_in":{"type":"integer","description":"Seconds; omit for never"},"keywords_attributes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"keyword":{"type":"string"},"whole_word":{"type":"boolean"},"_destroy":{"type":"boolean"}}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filters-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"context":{"type":"array","items":{"type":"string","enum":["home","notifications","public","thread","account"]},"minItems":1},"filter_action":{"type":"string","enum":["warn","hide","blur"]},"expires_at":{"type":["null","string"],"format":"date-time"},"keywords":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"keyword":{"type":"string"},"whole_word":{"type":"boolean"}}}},"statuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status_id":{"type":"string"}}}}},"required":["id","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonFiltersDelete","summary":"Mastodon: Delete a Filters item","tags":["Focus · Mastodon"],"description":"Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: `/v1/accounts/{accountId}/focus/filters`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filters-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/filters/{itemId}/add-keyword":{"post":{"operationId":"mastodonFiltersAddKeyword","summary":"Mastodon: Add keyword (Filters)","tags":["Focus · Mastodon"],"description":"Add keyword. Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: `/v1/accounts/{accountId}/focus/filters`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"whole_word":{"type":"boolean"}},"required":["keyword"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filters-add-keyword","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/filters/{itemId}/add-status":{"post":{"operationId":"mastodonFiltersAddStatus","summary":"Mastodon: Filter a status (Filters)","tags":["Focus · Mastodon"],"description":"Filter a status. Keyword / status filters (v2) with warn, hide or blur actions. Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/ Generic route: `/v1/accounts/{accountId}/focus/filters`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status_id":{"type":"string"}},"required":["status_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filters-add-status","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/filter-keywords":{"get":{"operationId":"mastodonFilterKeywordsList","summary":"Mastodon: List Filter keywords","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: `/v1/accounts/{accountId}/focus/filter-keywords`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"filter_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filter-keywords-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"keyword":{"type":"string"},"whole_word":{"type":"boolean"},"filter_id":{"type":"string"}},"required":["id","keyword"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonFilterKeywordsCreate","summary":"Mastodon: Create a Filter keywords item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: `/v1/accounts/{accountId}/focus/filter-keywords`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filter_id":{"type":"string"},"keyword":{"type":"string"},"whole_word":{"type":"boolean"}},"required":["filter_id","keyword"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filter-keywords-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"keyword":{"type":"string"},"whole_word":{"type":"boolean"},"filter_id":{"type":"string"}},"required":["id","keyword"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/filter-keywords/{itemId}":{"get":{"operationId":"mastodonFilterKeywordsGet","summary":"Mastodon: Get a Filter keywords item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: `/v1/accounts/{accountId}/focus/filter-keywords`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filter-keywords-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"keyword":{"type":"string"},"whole_word":{"type":"boolean"},"filter_id":{"type":"string"}},"required":["id","keyword"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonFilterKeywordsUpdate","summary":"Mastodon: Update a Filter keywords item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: `/v1/accounts/{accountId}/focus/filter-keywords`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"whole_word":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filter-keywords-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"keyword":{"type":"string"},"whole_word":{"type":"boolean"},"filter_id":{"type":"string"}},"required":["id","keyword"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonFilterKeywordsDelete","summary":"Mastodon: Delete a Filter keywords item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#keywords-get Generic route: `/v1/accounts/{accountId}/focus/filter-keywords`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filter-keywords-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/filter-statuses":{"get":{"operationId":"mastodonFilterStatusesList","summary":"Mastodon: List Filtered posts","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: `/v1/accounts/{accountId}/focus/filter-statuses`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"filter_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filter-statuses-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status_id":{"type":"string"},"filter_id":{"type":"string"}},"required":["id","status_id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonFilterStatusesCreate","summary":"Mastodon: Create a Filtered posts item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: `/v1/accounts/{accountId}/focus/filter-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filter_id":{"type":"string"},"status_id":{"type":"string"}},"required":["filter_id","status_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filter-statuses-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status_id":{"type":"string"},"filter_id":{"type":"string"}},"required":["id","status_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/filter-statuses/{itemId}":{"get":{"operationId":"mastodonFilterStatusesGet","summary":"Mastodon: Get a Filtered posts item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: `/v1/accounts/{accountId}/focus/filter-statuses`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filter-statuses-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status_id":{"type":"string"},"filter_id":{"type":"string"}},"required":["id","status_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonFilterStatusesDelete","summary":"Mastodon: Delete a Filtered posts item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:filters, write:filters. Network docs: https://docs.joinmastodon.org/methods/filters/#statuses-get Generic route: `/v1/accounts/{accountId}/focus/filter-statuses`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-filter-statuses-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/markers":{"get":{"operationId":"mastodonMarkersList","summary":"Mastodon: List Read markers","tags":["Focus · Mastodon"],"description":"Last-read position in home and notifications, synced across clients. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/markers/ Generic route: `/v1/accounts/{accountId}/focus/markers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-markers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["home","notifications"]},"last_read_id":{"type":"string"},"version":{"type":"integer"},"updated_at":{"type":"string","format":"date-time"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/markers/{itemId}":{"patch":{"operationId":"mastodonMarkersUpdate","summary":"Mastodon: Update a Read markers item","tags":["Focus · Mastodon"],"description":"Last-read position in home and notifications, synced across clients. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/markers/ Generic route: `/v1/accounts/{accountId}/focus/markers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"last_read_id":{"type":"string"}},"required":["last_read_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-markers-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","enum":["home","notifications"]},"last_read_id":{"type":"string"},"version":{"type":"integer"},"updated_at":{"type":"string","format":"date-time"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/home-timeline":{"get":{"operationId":"mastodonHomeTimelineList","summary":"Mastodon: List Home","tags":["Focus · Mastodon"],"description":"Posts from people and hashtags you follow. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-home-timeline-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/home-timeline/{itemId}/favourite":{"post":{"operationId":"mastodonHomeTimelineFavourite","summary":"Mastodon: Favourite (Home)","tags":["Focus · Mastodon"],"description":"Favourite. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-home-timeline-favourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/home-timeline/{itemId}/unfavourite":{"post":{"operationId":"mastodonHomeTimelineUnfavourite","summary":"Mastodon: Unfavourite (Home)","tags":["Focus · Mastodon"],"description":"Unfavourite. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-home-timeline-unfavourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/home-timeline/{itemId}/boost":{"post":{"operationId":"mastodonHomeTimelineBoost","summary":"Mastodon: Boost (Home)","tags":["Focus · Mastodon"],"description":"Boost. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["public","unlisted","private"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-home-timeline-boost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/home-timeline/{itemId}/unboost":{"post":{"operationId":"mastodonHomeTimelineUnboost","summary":"Mastodon: Undo boost (Home)","tags":["Focus · Mastodon"],"description":"Undo boost. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-home-timeline-unboost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/home-timeline/{itemId}/bookmark":{"post":{"operationId":"mastodonHomeTimelineBookmark","summary":"Mastodon: Bookmark (Home)","tags":["Focus · Mastodon"],"description":"Bookmark. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-home-timeline-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/home-timeline/{itemId}/unbookmark":{"post":{"operationId":"mastodonHomeTimelineUnbookmark","summary":"Mastodon: Remove bookmark (Home)","tags":["Focus · Mastodon"],"description":"Remove bookmark. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-home-timeline-unbookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/home-timeline/{itemId}/reply":{"post":{"operationId":"mastodonHomeTimelineReply","summary":"Mastodon: Reply (Home)","tags":["Focus · Mastodon"],"description":"Reply. Posts from people and hashtags you follow. Requires scopes: read:statuses, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-home-timeline-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/local-timeline":{"get":{"operationId":"mastodonLocalTimelineList","summary":"Mastodon: List Local","tags":["Focus · Mastodon"],"description":"Public posts from this server (may be restricted by configuration.timelines_access). Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/local-timeline`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"boolean"},"in":"query","name":"only_media","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-local-timeline-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/local-timeline/{itemId}/favourite":{"post":{"operationId":"mastodonLocalTimelineFavourite","summary":"Mastodon: Favourite (Local)","tags":["Focus · Mastodon"],"description":"Favourite. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/local-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-local-timeline-favourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/local-timeline/{itemId}/unfavourite":{"post":{"operationId":"mastodonLocalTimelineUnfavourite","summary":"Mastodon: Unfavourite (Local)","tags":["Focus · Mastodon"],"description":"Unfavourite. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/local-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-local-timeline-unfavourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/local-timeline/{itemId}/boost":{"post":{"operationId":"mastodonLocalTimelineBoost","summary":"Mastodon: Boost (Local)","tags":["Focus · Mastodon"],"description":"Boost. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/local-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["public","unlisted","private"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-local-timeline-boost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/local-timeline/{itemId}/unboost":{"post":{"operationId":"mastodonLocalTimelineUnboost","summary":"Mastodon: Undo boost (Local)","tags":["Focus · Mastodon"],"description":"Undo boost. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/local-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-local-timeline-unboost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/local-timeline/{itemId}/bookmark":{"post":{"operationId":"mastodonLocalTimelineBookmark","summary":"Mastodon: Bookmark (Local)","tags":["Focus · Mastodon"],"description":"Bookmark. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/local-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-local-timeline-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/local-timeline/{itemId}/unbookmark":{"post":{"operationId":"mastodonLocalTimelineUnbookmark","summary":"Mastodon: Remove bookmark (Local)","tags":["Focus · Mastodon"],"description":"Remove bookmark. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/local-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-local-timeline-unbookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/local-timeline/{itemId}/reply":{"post":{"operationId":"mastodonLocalTimelineReply","summary":"Mastodon: Reply (Local)","tags":["Focus · Mastodon"],"description":"Reply. Public posts from this server (may be restricted by configuration.timelines_access). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/local-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-local-timeline-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/federated-timeline":{"get":{"operationId":"mastodonFederatedTimelineList","summary":"Mastodon: List Federated","tags":["Focus · Mastodon"],"description":"Public posts from across the fediverse known to this server. Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/federated-timeline`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"boolean"},"in":"query","name":"only_media","required":false},{"schema":{"type":"boolean"},"in":"query","name":"remote","required":false,"description":"Only remote posts"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-federated-timeline-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/federated-timeline/{itemId}/favourite":{"post":{"operationId":"mastodonFederatedTimelineFavourite","summary":"Mastodon: Favourite (Federated)","tags":["Focus · Mastodon"],"description":"Favourite. Public posts from across the fediverse known to this server. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/federated-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-federated-timeline-favourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unfavourite":{"post":{"operationId":"mastodonFederatedTimelineUnfavourite","summary":"Mastodon: Unfavourite (Federated)","tags":["Focus · Mastodon"],"description":"Unfavourite. Public posts from across the fediverse known to this server. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/federated-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-federated-timeline-unfavourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/federated-timeline/{itemId}/boost":{"post":{"operationId":"mastodonFederatedTimelineBoost","summary":"Mastodon: Boost (Federated)","tags":["Focus · Mastodon"],"description":"Boost. Public posts from across the fediverse known to this server. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/federated-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["public","unlisted","private"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-federated-timeline-boost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unboost":{"post":{"operationId":"mastodonFederatedTimelineUnboost","summary":"Mastodon: Undo boost (Federated)","tags":["Focus · Mastodon"],"description":"Undo boost. Public posts from across the fediverse known to this server. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/federated-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-federated-timeline-unboost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/federated-timeline/{itemId}/bookmark":{"post":{"operationId":"mastodonFederatedTimelineBookmark","summary":"Mastodon: Bookmark (Federated)","tags":["Focus · Mastodon"],"description":"Bookmark. Public posts from across the fediverse known to this server. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/federated-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-federated-timeline-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/federated-timeline/{itemId}/unbookmark":{"post":{"operationId":"mastodonFederatedTimelineUnbookmark","summary":"Mastodon: Remove bookmark (Federated)","tags":["Focus · Mastodon"],"description":"Remove bookmark. Public posts from across the fediverse known to this server. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/federated-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-federated-timeline-unbookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/federated-timeline/{itemId}/reply":{"post":{"operationId":"mastodonFederatedTimelineReply","summary":"Mastodon: Reply (Federated)","tags":["Focus · Mastodon"],"description":"Reply. Public posts from across the fediverse known to this server. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/federated-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-federated-timeline-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/hashtag-timeline":{"get":{"operationId":"mastodonHashtagTimelineList","summary":"Mastodon: List Hashtag","tags":["Focus · Mastodon"],"description":"Public posts with a hashtag (any/all/none combinations). Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/hashtag-timeline`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"tag","required":true},{"schema":{"type":"array","items":{"type":"string"}},"in":"query","name":"any","required":false},{"schema":{"type":"array","items":{"type":"string"}},"in":"query","name":"all","required":false},{"schema":{"type":"array","items":{"type":"string"}},"in":"query","name":"none","required":false},{"schema":{"type":"boolean"},"in":"query","name":"local","required":false},{"schema":{"type":"boolean"},"in":"query","name":"remote","required":false},{"schema":{"type":"boolean"},"in":"query","name":"only_media","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-hashtag-timeline-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/favourite":{"post":{"operationId":"mastodonHashtagTimelineFavourite","summary":"Mastodon: Favourite (Hashtag)","tags":["Focus · Mastodon"],"description":"Favourite. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/hashtag-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-hashtag-timeline-favourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unfavourite":{"post":{"operationId":"mastodonHashtagTimelineUnfavourite","summary":"Mastodon: Unfavourite (Hashtag)","tags":["Focus · Mastodon"],"description":"Unfavourite. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/hashtag-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-hashtag-timeline-unfavourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/boost":{"post":{"operationId":"mastodonHashtagTimelineBoost","summary":"Mastodon: Boost (Hashtag)","tags":["Focus · Mastodon"],"description":"Boost. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/hashtag-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["public","unlisted","private"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-hashtag-timeline-boost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unboost":{"post":{"operationId":"mastodonHashtagTimelineUnboost","summary":"Mastodon: Undo boost (Hashtag)","tags":["Focus · Mastodon"],"description":"Undo boost. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/hashtag-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-hashtag-timeline-unboost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/bookmark":{"post":{"operationId":"mastodonHashtagTimelineBookmark","summary":"Mastodon: Bookmark (Hashtag)","tags":["Focus · Mastodon"],"description":"Bookmark. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/hashtag-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-hashtag-timeline-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/unbookmark":{"post":{"operationId":"mastodonHashtagTimelineUnbookmark","summary":"Mastodon: Remove bookmark (Hashtag)","tags":["Focus · Mastodon"],"description":"Remove bookmark. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/hashtag-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-hashtag-timeline-unbookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/hashtag-timeline/{itemId}/reply":{"post":{"operationId":"mastodonHashtagTimelineReply","summary":"Mastodon: Reply (Hashtag)","tags":["Focus · Mastodon"],"description":"Reply. Public posts with a hashtag (any/all/none combinations). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/hashtag-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-hashtag-timeline-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/link-timeline":{"get":{"operationId":"mastodonLinkTimelineList","summary":"Mastodon: List Link","tags":["Focus · Mastodon"],"description":"Posts sharing a trending link (4.3+). Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/link-timeline`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","format":"uri"},"in":"query","name":"url","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-link-timeline-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/link-timeline/{itemId}/favourite":{"post":{"operationId":"mastodonLinkTimelineFavourite","summary":"Mastodon: Favourite (Link)","tags":["Focus · Mastodon"],"description":"Favourite. Posts sharing a trending link (4.3+). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/link-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-link-timeline-favourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/link-timeline/{itemId}/unfavourite":{"post":{"operationId":"mastodonLinkTimelineUnfavourite","summary":"Mastodon: Unfavourite (Link)","tags":["Focus · Mastodon"],"description":"Unfavourite. Posts sharing a trending link (4.3+). Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/link-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-link-timeline-unfavourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/link-timeline/{itemId}/boost":{"post":{"operationId":"mastodonLinkTimelineBoost","summary":"Mastodon: Boost (Link)","tags":["Focus · Mastodon"],"description":"Boost. Posts sharing a trending link (4.3+). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/link-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["public","unlisted","private"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-link-timeline-boost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/link-timeline/{itemId}/unboost":{"post":{"operationId":"mastodonLinkTimelineUnboost","summary":"Mastodon: Undo boost (Link)","tags":["Focus · Mastodon"],"description":"Undo boost. Posts sharing a trending link (4.3+). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/link-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-link-timeline-unboost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/link-timeline/{itemId}/bookmark":{"post":{"operationId":"mastodonLinkTimelineBookmark","summary":"Mastodon: Bookmark (Link)","tags":["Focus · Mastodon"],"description":"Bookmark. Posts sharing a trending link (4.3+). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/link-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-link-timeline-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/link-timeline/{itemId}/unbookmark":{"post":{"operationId":"mastodonLinkTimelineUnbookmark","summary":"Mastodon: Remove bookmark (Link)","tags":["Focus · Mastodon"],"description":"Remove bookmark. Posts sharing a trending link (4.3+). Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/link-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-link-timeline-unbookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/link-timeline/{itemId}/reply":{"post":{"operationId":"mastodonLinkTimelineReply","summary":"Mastodon: Reply (Link)","tags":["Focus · Mastodon"],"description":"Reply. Posts sharing a trending link (4.3+). Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/link-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-link-timeline-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/list-timeline":{"get":{"operationId":"mastodonListTimelineList","summary":"Mastodon: List List","tags":["Focus · Mastodon"],"description":"Posts from the members of one of your lists. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:lists. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/list-timeline`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"list_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-timeline-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/list-timeline/{itemId}/favourite":{"post":{"operationId":"mastodonListTimelineFavourite","summary":"Mastodon: Favourite (List)","tags":["Focus · Mastodon"],"description":"Favourite. Posts from the members of one of your lists. Requires scopes: read:lists, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/list-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-timeline-favourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/list-timeline/{itemId}/unfavourite":{"post":{"operationId":"mastodonListTimelineUnfavourite","summary":"Mastodon: Unfavourite (List)","tags":["Focus · Mastodon"],"description":"Unfavourite. Posts from the members of one of your lists. Requires scopes: read:lists, write:favourites. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/list-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-timeline-unfavourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/list-timeline/{itemId}/boost":{"post":{"operationId":"mastodonListTimelineBoost","summary":"Mastodon: Boost (List)","tags":["Focus · Mastodon"],"description":"Boost. Posts from the members of one of your lists. Requires scopes: read:lists, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/list-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["public","unlisted","private"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-timeline-boost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/list-timeline/{itemId}/unboost":{"post":{"operationId":"mastodonListTimelineUnboost","summary":"Mastodon: Undo boost (List)","tags":["Focus · Mastodon"],"description":"Undo boost. Posts from the members of one of your lists. Requires scopes: read:lists, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/list-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-timeline-unboost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/list-timeline/{itemId}/bookmark":{"post":{"operationId":"mastodonListTimelineBookmark","summary":"Mastodon: Bookmark (List)","tags":["Focus · Mastodon"],"description":"Bookmark. Posts from the members of one of your lists. Requires scopes: read:lists, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/list-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-timeline-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/list-timeline/{itemId}/unbookmark":{"post":{"operationId":"mastodonListTimelineUnbookmark","summary":"Mastodon: Remove bookmark (List)","tags":["Focus · Mastodon"],"description":"Remove bookmark. Posts from the members of one of your lists. Requires scopes: read:lists, write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/list-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-timeline-unbookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/list-timeline/{itemId}/reply":{"post":{"operationId":"mastodonListTimelineReply","summary":"Mastodon: Reply (List)","tags":["Focus · Mastodon"],"description":"Reply. Posts from the members of one of your lists. Requires scopes: read:lists, write:statuses. Network docs: https://docs.joinmastodon.org/methods/timelines/ Generic route: `/v1/accounts/{accountId}/focus/list-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-list-timeline-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-tags":{"get":{"operationId":"mastodonTrendsTagsList","summary":"Mastodon: List Trending hashtags","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/trends/#tags Generic route: `/v1/accounts/{accountId}/focus/trends-tags`.","parameters":[{"schema":{"type":"integer","maximum":20,"default":10},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-tags-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"following":{"type":["null","boolean"]},"featuring":{"type":["null","boolean"]},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"uses":{"type":"string"},"accounts":{"type":"string"}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-tags/{itemId}/follow":{"post":{"operationId":"mastodonTrendsTagsFollow","summary":"Mastodon: Follow hashtag (Trending hashtags)","tags":["Focus · Mastodon"],"description":"Follow hashtag. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/trends/#tags Generic route: `/v1/accounts/{accountId}/focus/trends-tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-tags-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-statuses":{"get":{"operationId":"mastodonTrendsStatusesList","summary":"Mastodon: List Trending posts","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: `/v1/accounts/{accountId}/focus/trends-statuses`.","parameters":[{"schema":{"type":"integer","maximum":40,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-statuses-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-statuses/{itemId}/favourite":{"post":{"operationId":"mastodonTrendsStatusesFavourite","summary":"Mastodon: Favourite (Trending posts)","tags":["Focus · Mastodon"],"description":"Favourite. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: `/v1/accounts/{accountId}/focus/trends-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-statuses-favourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unfavourite":{"post":{"operationId":"mastodonTrendsStatusesUnfavourite","summary":"Mastodon: Unfavourite (Trending posts)","tags":["Focus · Mastodon"],"description":"Unfavourite. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: `/v1/accounts/{accountId}/focus/trends-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-statuses-unfavourite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-statuses/{itemId}/boost":{"post":{"operationId":"mastodonTrendsStatusesBoost","summary":"Mastodon: Boost (Trending posts)","tags":["Focus · Mastodon"],"description":"Boost. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: `/v1/accounts/{accountId}/focus/trends-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"visibility":{"type":"string","enum":["public","unlisted","private"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-statuses-boost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unboost":{"post":{"operationId":"mastodonTrendsStatusesUnboost","summary":"Mastodon: Undo boost (Trending posts)","tags":["Focus · Mastodon"],"description":"Undo boost. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: `/v1/accounts/{accountId}/focus/trends-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-statuses-unboost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-statuses/{itemId}/bookmark":{"post":{"operationId":"mastodonTrendsStatusesBookmark","summary":"Mastodon: Bookmark (Trending posts)","tags":["Focus · Mastodon"],"description":"Bookmark. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: `/v1/accounts/{accountId}/focus/trends-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-statuses-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-statuses/{itemId}/unbookmark":{"post":{"operationId":"mastodonTrendsStatusesUnbookmark","summary":"Mastodon: Remove bookmark (Trending posts)","tags":["Focus · Mastodon"],"description":"Remove bookmark. Requires scopes: write:bookmarks. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: `/v1/accounts/{accountId}/focus/trends-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-statuses-unbookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-statuses/{itemId}/reply":{"post":{"operationId":"mastodonTrendsStatusesReply","summary":"Mastodon: Reply (Trending posts)","tags":["Focus · Mastodon"],"description":"Reply. Requires scopes: write:statuses. Network docs: https://docs.joinmastodon.org/methods/trends/#statuses Generic route: `/v1/accounts/{accountId}/focus/trends-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","title":"Text","description":"Plain text; URLs count as 23 characters"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"language":{"type":"string","description":"ISO 639-1"},"media":{"type":"array","items":{"type":"string"},"description":"Socialit media ids (uploaded to the instance on publish)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"Already-uploaded Mastodon media ids"},"alt_texts":{"type":"array","items":{"type":"string"},"description":"Alt text per media item, by index"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2},"expires_in":{"type":"integer","default":86400},"multiple":{"type":"boolean"},"hide_totals":{"type":"boolean"}}},"in_reply_to_id":{"type":"string"},"quoted_status_id":{"type":"string","description":"Mastodon 4.5+"},"quote_approval_policy":{"type":"string","enum":["public","followers","nobody"]},"scheduled_at":{"type":"string","format":"date-time","description":"≥ 5 minutes ahead → ScheduledStatus"},"thread":{"type":"array","items":{"type":"string"},"description":"Follow-up replies posted as a self-thread"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-statuses-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/trends-links":{"get":{"operationId":"mastodonTrendsLinksList","summary":"Mastodon: List Trending links","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/trends/#links Generic route: `/v1/accounts/{accountId}/focus/trends-links`.","parameters":[{"schema":{"type":"integer","maximum":20,"default":10},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-trends-links-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"description":{"type":"string"},"type":{"type":"string","enum":["link","photo","video","rich"]},"provider_name":{"type":"string"},"author_name":{"type":"string"},"image":{"type":["null","string"],"format":"uri"},"published_at":{"type":["null","string"],"format":"date-time"},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"uses":{"type":"string"},"accounts":{"type":"string"}}}}},"required":["url"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/search":{"get":{"operationId":"mastodonSearchList","summary":"Mastodon: List Search","tags":["Focus · Mastodon"],"description":"Search accounts, posts and hashtags. resolve=true imports a remote post or account by URL / handle. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:search. Network docs: https://docs.joinmastodon.org/methods/search/ Generic route: `/v1/accounts/{accountId}/focus/search`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"type":"string","enum":["accounts","statuses","hashtags"]},"in":"query","name":"type","required":false},{"schema":{"type":"boolean"},"in":"query","name":"resolve","required":false},{"schema":{"type":"boolean"},"in":"query","name":"following","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"boolean"},"in":"query","name":"exclude_unreviewed","required":false},{"schema":{"type":"integer","maximum":40,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"offset=<n>"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-search-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["account","status","hashtag"]},"title":{"type":"string"},"url":{"type":["null","string"],"format":"uri"},"account":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]},"status":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"]},"hashtag":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"following":{"type":["null","boolean"]},"featuring":{"type":["null","boolean"]},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"uses":{"type":"string"},"accounts":{"type":"string"}}}}}}},"required":["id","kind"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/tags/{itemId}":{"get":{"operationId":"mastodonTagsGet","summary":"Mastodon: Get a Hashtags item","tags":["Focus · Mastodon"],"description":"Hashtag details; follow or feature it on your profile. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: `/v1/accounts/{accountId}/focus/tags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-tags-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"following":{"type":["null","boolean"]},"featuring":{"type":["null","boolean"]},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"uses":{"type":"string"},"accounts":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/tags/{itemId}/follow":{"post":{"operationId":"mastodonTagsFollow","summary":"Mastodon: Follow (Hashtags)","tags":["Focus · Mastodon"],"description":"Follow. Hashtag details; follow or feature it on your profile. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: `/v1/accounts/{accountId}/focus/tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-tags-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/tags/{itemId}/unfollow":{"post":{"operationId":"mastodonTagsUnfollow","summary":"Mastodon: Unfollow (Hashtags)","tags":["Focus · Mastodon"],"description":"Unfollow. Hashtag details; follow or feature it on your profile. Requires scopes: write:follows. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: `/v1/accounts/{accountId}/focus/tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-tags-unfollow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/tags/{itemId}/feature":{"post":{"operationId":"mastodonTagsFeature","summary":"Mastodon: Feature on profile (Hashtags)","tags":["Focus · Mastodon"],"description":"Feature on profile. Hashtag details; follow or feature it on your profile. Requires scopes: write:accounts. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: `/v1/accounts/{accountId}/focus/tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-tags-feature","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/tags/{itemId}/unfeature":{"post":{"operationId":"mastodonTagsUnfeature","summary":"Mastodon: Unfeature (Hashtags)","tags":["Focus · Mastodon"],"description":"Unfeature. Hashtag details; follow or feature it on your profile. Requires scopes: write:accounts. Network docs: https://docs.joinmastodon.org/methods/tags/ Generic route: `/v1/accounts/{accountId}/focus/tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-tags-unfeature","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/blocks":{"get":{"operationId":"mastodonBlocksList","summary":"Mastodon: List Blocked accounts","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:blocks. Network docs: https://docs.joinmastodon.org/methods/blocks/ Generic route: `/v1/accounts/{accountId}/focus/blocks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-blocks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonBlocksCreate","summary":"Mastodon: Create a Blocked accounts item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/blocks/ Generic route: `/v1/accounts/{accountId}/focus/blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"account_id":{"type":"string"}},"required":["account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-blocks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/blocks/{itemId}":{"delete":{"operationId":"mastodonBlocksDelete","summary":"Mastodon: Delete a Blocked accounts item","tags":["Focus · Mastodon"],"description":"Unblock. Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/blocks/ Generic route: `/v1/accounts/{accountId}/focus/blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-blocks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/mutes":{"get":{"operationId":"mastodonMutesList","summary":"Mastodon: List Muted accounts","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:mutes. Network docs: https://docs.joinmastodon.org/methods/mutes/ Generic route: `/v1/accounts/{accountId}/focus/mutes`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-mutes-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"},"mute_expires_at":{"type":["null","string"],"format":"date-time"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonMutesCreate","summary":"Mastodon: Create a Muted accounts item","tags":["Focus · Mastodon"],"description":"Requires scopes: read:mutes, write:mutes. Network docs: https://docs.joinmastodon.org/methods/mutes/ Generic route: `/v1/accounts/{accountId}/focus/mutes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"account_id":{"type":"string"},"notifications":{"type":"boolean","default":true},"duration":{"type":"integer","minimum":0,"description":"Seconds; 0 = indefinite"}},"required":["account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-mutes-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"},"mute_expires_at":{"type":["null","string"],"format":"date-time"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/mutes/{itemId}":{"delete":{"operationId":"mastodonMutesDelete","summary":"Mastodon: Delete a Muted accounts item","tags":["Focus · Mastodon"],"description":"Unmute. Requires scopes: read:mutes, write:mutes. Network docs: https://docs.joinmastodon.org/methods/mutes/ Generic route: `/v1/accounts/{accountId}/focus/mutes`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-mutes-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/domain-blocks":{"get":{"operationId":"mastodonDomainBlocksList","summary":"Mastodon: List Blocked servers","tags":["Focus · Mastodon"],"description":"Hide everything from a domain and remove its followers. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:blocks. Network docs: https://docs.joinmastodon.org/methods/domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/domain-blocks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-domain-blocks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"domain":{"type":"string"}},"required":["domain"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonDomainBlocksCreate","summary":"Mastodon: Create a Blocked servers item","tags":["Focus · Mastodon"],"description":"Hide everything from a domain and remove its followers. Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/domain-blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-domain-blocks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"domain":{"type":"string"}},"required":["domain"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/domain-blocks/{itemId}":{"delete":{"operationId":"mastodonDomainBlocksDelete","summary":"Mastodon: Delete a Blocked servers item","tags":["Focus · Mastodon"],"description":"Hide everything from a domain and remove its followers. Requires scopes: read:blocks, write:blocks. Network docs: https://docs.joinmastodon.org/methods/domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/domain-blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-domain-blocks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/reports":{"post":{"operationId":"mastodonReportsCreate","summary":"Mastodon: Create a Report item","tags":["Focus · Mastodon"],"description":"Report an account, posts or collections to moderators (400 / 24 h). Rule ids come from Server › Rules. Requires scopes: write:reports. Network docs: https://docs.joinmastodon.org/methods/reports/ Generic route: `/v1/accounts/{accountId}/focus/reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"account_id":{"type":"string"},"status_ids":{"type":"array","items":{"type":"string"}},"collection_ids":{"type":"array","items":{"type":"string","description":"4.6+"}},"comment":{"type":"string"},"forward":{"type":"boolean"},"forward_to_domains":{"type":"array","items":{"type":"string"}},"category":{"type":"string","enum":["spam","legal","violation","other"]},"rule_ids":{"type":"array","items":{"type":"string"}}},"required":["account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-reports-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"account_id":{"type":"string"},"status_ids":{"type":"array","items":{"type":"string"}},"collection_ids":{"type":"array","items":{"type":"string"}},"comment":{"type":"string","maxLength":1000},"forward":{"type":"boolean","description":"Also send to the remote server"},"forward_to_domains":{"type":"array","items":{"type":"string"}},"category":{"type":"string","enum":["spam","legal","violation","other"]},"rule_ids":{"type":"array","items":{"type":"string"}},"action_taken":{"type":"boolean","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true}},"required":["account_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/profile":{"get":{"operationId":"mastodonProfileGet","summary":"Mastodon: Get Profile","tags":["Focus · Mastodon"],"description":"Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: `/v1/accounts/{accountId}/focus/profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"},"avatar_description":{"type":["null","string"],"description":"4.6+"},"header_description":{"type":["null","string"],"description":"4.6+"},"hide_collections":{"type":["null","boolean"]},"show_media":{"type":["null","boolean"]},"show_media_replies":{"type":["null","boolean"]},"show_featured":{"type":["null","boolean"]},"attribution_domains":{"type":["null","array"],"items":{"type":"string"},"maxItems":10},"source":{"type":"object","properties":{"privacy":{"type":"string","enum":["public","unlisted","private","direct"]},"sensitive":{"type":"boolean"},"language":{"type":["null","string"]},"note":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"quote_policy":{"type":["null","string"],"enum":["public","followers","nobody",null]}}}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonProfileUpdate","summary":"Mastodon: Update Profile","tags":["Focus · Mastodon"],"description":"PATCH /api/v1/profile (4.6+) or /api/v1/accounts/update_credentials. Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Requires scopes: write:accounts. Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: `/v1/accounts/{accountId}/focus/profile`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"type":"string","description":"configuration.accounts.max_display_name_length (40 on 4.6+)"},"note":{"type":"string","title":"Bio","description":"max_note_length (500)"},"avatar":{"type":"string","description":"Image (Socialit media id)"},"avatar_description":{"type":"string"},"header":{"type":"string"},"header_description":{"type":"string"},"locked":{"type":"boolean","title":"Approve followers manually"},"bot":{"type":"boolean","title":"Automated account"},"discoverable":{"type":"boolean"},"indexable":{"type":"boolean"},"hide_collections":{"type":"boolean"},"show_media":{"type":"boolean"},"show_media_replies":{"type":"boolean"},"show_featured":{"type":"boolean"},"attribution_domains":{"type":"array","items":{"type":"string"},"maxItems":10},"fields_attributes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}},"maxItems":4},"source":{"type":"object","properties":{"privacy":{"type":"string","enum":["public","unlisted","private"]},"sensitive":{"type":"boolean"},"language":{"type":"string"},"quote_policy":{"type":"string","enum":["public","followers","nobody"]}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-profile-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"},"avatar_description":{"type":["null","string"],"description":"4.6+"},"header_description":{"type":["null","string"],"description":"4.6+"},"hide_collections":{"type":["null","boolean"]},"show_media":{"type":["null","boolean"]},"show_media_replies":{"type":["null","boolean"]},"show_featured":{"type":["null","boolean"]},"attribution_domains":{"type":["null","array"],"items":{"type":"string"},"maxItems":10},"source":{"type":"object","properties":{"privacy":{"type":"string","enum":["public","unlisted","private","direct"]},"sensitive":{"type":"boolean"},"language":{"type":["null","string"]},"note":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"quote_policy":{"type":["null","string"],"enum":["public","followers","nobody",null]}}}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/profile/delete-avatar":{"post":{"operationId":"mastodonProfileDeleteAvatar","summary":"Mastodon: Remove avatar (Profile)","tags":["Focus · Mastodon"],"description":"Remove avatar. Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Destructive. Requires scopes: write:accounts. Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: `/v1/accounts/{accountId}/focus/profile`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-profile-delete-avatar","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/profile/delete-header":{"post":{"operationId":"mastodonProfileDeleteHeader","summary":"Mastodon: Remove header (Profile)","tags":["Focus · Mastodon"],"description":"Remove header. Your public profile, posting defaults and the bot flag (many servers require it for automated accounts). Destructive. Requires scopes: write:accounts. Requires one of: profile | read:accounts. Network docs: https://docs.joinmastodon.org/methods/profile/ Generic route: `/v1/accounts/{accountId}/focus/profile`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-profile-delete-header","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/preferences":{"get":{"operationId":"mastodonPreferencesGet","summary":"Mastodon: Get Preferences","tags":["Focus · Mastodon"],"description":"Posting defaults (visibility, sensitivity, language, quote policy) and reading preferences. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/preferences/ Generic route: `/v1/accounts/{accountId}/focus/preferences`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-preferences-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"posting:default:visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"posting:default:sensitive":{"type":"boolean"},"posting:default:language":{"type":["null","string"]},"posting:default:quote_policy":{"type":["null","string"],"enum":["public","followers","nobody",null]},"reading:expand:media":{"type":"string","enum":["default","show_all","hide_all"]},"reading:expand:spoilers":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/annual-reports":{"get":{"operationId":"mastodonAnnualReportsList","summary":"Mastodon: List Year in review","tags":["Focus · Mastodon"],"description":"Wrapstodon annual reports (available Dec 10–31 when the server enables them). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: `/v1/accounts/{accountId}/focus/annual-reports`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-annual-reports-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"year":{"type":"integer"},"schema_version":{"type":"integer"},"data":{"type":"object","properties":{},"additionalProperties":true}},"required":["year"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/annual-reports/{itemId}":{"get":{"operationId":"mastodonAnnualReportsGet","summary":"Mastodon: Get a Year in review item","tags":["Focus · Mastodon"],"description":"Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: `/v1/accounts/{accountId}/focus/annual-reports`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-annual-reports-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"year":{"type":"integer"},"schema_version":{"type":"integer"},"data":{"type":"object","properties":{},"additionalProperties":true}},"required":["year"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/annual-reports/{itemId}/mark-read":{"post":{"operationId":"mastodonAnnualReportsMarkRead","summary":"Mastodon: Mark as read (Year in review)","tags":["Focus · Mastodon"],"description":"Mark as read. Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: `/v1/accounts/{accountId}/focus/annual-reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-annual-reports-mark-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/annual-reports/{itemId}/generate":{"post":{"operationId":"mastodonAnnualReportsGenerate","summary":"Mastodon: Generate (Year in review)","tags":["Focus · Mastodon"],"description":"Generate. Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts, write:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: `/v1/accounts/{accountId}/focus/annual-reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-annual-reports-generate","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/annual-reports/{itemId}/state":{"post":{"operationId":"mastodonAnnualReportsState","summary":"Mastodon: Generation state (Year in review)","tags":["Focus · Mastodon"],"description":"Generation state. Wrapstodon annual reports (available Dec 10–31 when the server enables them). Requires scopes: read:accounts. Network docs: https://docs.joinmastodon.org/methods/annual_reports/ Generic route: `/v1/accounts/{accountId}/focus/annual-reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-annual-reports-state","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/push-subscription":{"get":{"operationId":"mastodonPushSubscriptionGet","summary":"Mastodon: Get Push subscription","tags":["Focus · Mastodon"],"description":"Web Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: `/v1/accounts/{accountId}/focus/push-subscription`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-push-subscription-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"endpoint":{"type":"string","format":"uri"},"standard":{"type":"boolean","description":"RFC 8291 aes128gcm (4.4+)"},"policy":{"type":"string","enum":["all","followed","follower","none"]},"server_key":{"type":"string","readOnly":true},"alerts":{"type":"object","properties":{"mention":{"type":"boolean"},"status":{"type":"boolean"},"reblog":{"type":"boolean"},"follow":{"type":"boolean"},"follow_request":{"type":"boolean"},"favourite":{"type":"boolean"},"poll":{"type":"boolean"},"update":{"type":"boolean"},"quote":{"type":"boolean"},"quoted_update":{"type":"boolean"},"admin.sign_up":{"type":"boolean"},"admin.report":{"type":"boolean"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonPushSubscriptionCreate","summary":"Mastodon: Create a Push subscription item","tags":["Focus · Mastodon"],"description":"Web Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: `/v1/accounts/{accountId}/focus/push-subscription`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string","format":"uri"},"keys":{"type":"object","properties":{"p256dh":{"type":"string"},"auth":{"type":"string"}},"required":["p256dh","auth"]},"alerts":{"type":"object","properties":{"mention":{"type":"boolean"},"status":{"type":"boolean"},"reblog":{"type":"boolean"},"follow":{"type":"boolean"},"follow_request":{"type":"boolean"},"favourite":{"type":"boolean"},"poll":{"type":"boolean"},"update":{"type":"boolean"},"quote":{"type":"boolean"},"quoted_update":{"type":"boolean"},"admin.sign_up":{"type":"boolean"},"admin.report":{"type":"boolean"}}},"policy":{"type":"string","enum":["all","followed","follower","none"]},"standard":{"type":"boolean","default":true}},"required":["endpoint","keys"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-push-subscription-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"endpoint":{"type":"string","format":"uri"},"standard":{"type":"boolean","description":"RFC 8291 aes128gcm (4.4+)"},"policy":{"type":"string","enum":["all","followed","follower","none"]},"server_key":{"type":"string","readOnly":true},"alerts":{"type":"object","properties":{"mention":{"type":"boolean"},"status":{"type":"boolean"},"reblog":{"type":"boolean"},"follow":{"type":"boolean"},"follow_request":{"type":"boolean"},"favourite":{"type":"boolean"},"poll":{"type":"boolean"},"update":{"type":"boolean"},"quote":{"type":"boolean"},"quoted_update":{"type":"boolean"},"admin.sign_up":{"type":"boolean"},"admin.report":{"type":"boolean"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonPushSubscriptionUpdate","summary":"Mastodon: Update Push subscription","tags":["Focus · Mastodon"],"description":"Web Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: `/v1/accounts/{accountId}/focus/push-subscription`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"alerts":{"type":"object","properties":{"mention":{"type":"boolean"},"status":{"type":"boolean"},"reblog":{"type":"boolean"},"follow":{"type":"boolean"},"follow_request":{"type":"boolean"},"favourite":{"type":"boolean"},"poll":{"type":"boolean"},"update":{"type":"boolean"},"quote":{"type":"boolean"},"quoted_update":{"type":"boolean"},"admin.sign_up":{"type":"boolean"},"admin.report":{"type":"boolean"}}},"policy":{"type":"string","enum":["all","followed","follower","none"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-push-subscription-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"endpoint":{"type":"string","format":"uri"},"standard":{"type":"boolean","description":"RFC 8291 aes128gcm (4.4+)"},"policy":{"type":"string","enum":["all","followed","follower","none"]},"server_key":{"type":"string","readOnly":true},"alerts":{"type":"object","properties":{"mention":{"type":"boolean"},"status":{"type":"boolean"},"reblog":{"type":"boolean"},"follow":{"type":"boolean"},"follow_request":{"type":"boolean"},"favourite":{"type":"boolean"},"poll":{"type":"boolean"},"update":{"type":"boolean"},"quote":{"type":"boolean"},"quoted_update":{"type":"boolean"},"admin.sign_up":{"type":"boolean"},"admin.report":{"type":"boolean"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonPushSubscriptionDelete","summary":"Mastodon: Delete Push subscription","tags":["Focus · Mastodon"],"description":"Web Push subscription of this token (one per token; creating replaces it). Socialit uses it as a webhook. Requires scopes: push. Network docs: https://docs.joinmastodon.org/methods/push/ Generic route: `/v1/accounts/{accountId}/focus/push-subscription`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-push-subscription-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/instance":{"get":{"operationId":"mastodonInstanceGet","summary":"Mastodon: Get Server","tags":["Focus · Mastodon"],"description":"Server info, limits (characters, media, polls), API level, registrations, contact. Network docs: https://docs.joinmastodon.org/methods/instance/#v2 Generic route: `/v1/accounts/{accountId}/focus/instance`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-instance-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"title":{"type":"string"},"version":{"type":"string"},"description":{"type":"string"},"source_url":{"type":["null","string"],"format":"uri"},"languages":{"type":"array","items":{"type":"string"}},"api_versions":{"type":"object","properties":{"mastodon":{"type":"integer"}}},"limits":{"type":"object","properties":{},"additionalProperties":true,"readOnly":true},"configuration":{"type":"object","properties":{},"additionalProperties":true},"registrations":{"type":"object","properties":{"enabled":{"type":"boolean"},"approval_required":{"type":"boolean"},"message":{"type":["null","string"]}}},"contact":{"type":"object","properties":{"email":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{},"additionalProperties":true}}}},"required":["domain"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/instance-rules":{"get":{"operationId":"mastodonInstanceRulesList","summary":"Mastodon: List Server rules","tags":["Focus · Mastodon"],"description":"Rules every post must follow (check automation / bot rules). Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/instance/#rules Generic route: `/v1/accounts/{accountId}/focus/instance-rules`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-instance-rules-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"hint":{"type":["null","string"]},"translations":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/terms-of-service":{"get":{"operationId":"mastodonTermsOfServiceGet","summary":"Mastodon: Get Terms of service","tags":["Focus · Mastodon"],"description":"Network docs: https://docs.joinmastodon.org/methods/instance/#terms_of_service Generic route: `/v1/accounts/{accountId}/focus/terms-of-service`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-terms-of-service-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"updated_at":{"type":["null","string"],"format":"date-time"},"content":{"type":"string"},"effective_date":{"type":["null","string"],"format":"date"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/privacy-policy":{"get":{"operationId":"mastodonPrivacyPolicyGet","summary":"Mastodon: Get Privacy policy","tags":["Focus · Mastodon"],"description":"Network docs: https://docs.joinmastodon.org/methods/instance/#privacy_policy Generic route: `/v1/accounts/{accountId}/focus/privacy-policy`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-privacy-policy-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"updated_at":{"type":["null","string"],"format":"date-time"},"content":{"type":"string"},"effective_date":{"type":["null","string"],"format":"date"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/extended-description":{"get":{"operationId":"mastodonExtendedDescriptionGet","summary":"Mastodon: Get About this server","tags":["Focus · Mastodon"],"description":"Network docs: https://docs.joinmastodon.org/methods/instance/#extended_description Generic route: `/v1/accounts/{accountId}/focus/extended-description`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-extended-description-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"updated_at":{"type":["null","string"],"format":"date-time"},"content":{"type":"string"},"effective_date":{"type":["null","string"],"format":"date"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/instance-peers":{"get":{"operationId":"mastodonInstancePeersList","summary":"Mastodon: List Known servers","tags":["Focus · Mastodon"],"description":"Domains this server has federated with (admins may disable it). Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/instance/#peers Generic route: `/v1/accounts/{accountId}/focus/instance-peers`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-instance-peers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"domain":{"type":"string"}},"required":["domain"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/instance-activity":{"get":{"operationId":"mastodonInstanceActivityList","summary":"Mastodon: List Server activity","tags":["Focus · Mastodon"],"description":"Weekly posts, logins and registrations (last 12 weeks). Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/instance/#activity Generic route: `/v1/accounts/{accountId}/focus/instance-activity`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-instance-activity-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"week":{"type":"string","format":"date"},"statuses":{"type":"integer"},"logins":{"type":"integer"},"registrations":{"type":"integer"}},"required":["week"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/instance-domain-blocks":{"get":{"operationId":"mastodonInstanceDomainBlocksList","summary":"Mastodon: List Moderated servers","tags":["Focus · Mastodon"],"description":"Servers this instance limits or suspends (when published by the admins). Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/instance/#domain_blocks Generic route: `/v1/accounts/{accountId}/focus/instance-domain-blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-instance-domain-blocks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"digest":{"type":"string"},"severity":{"type":"string","enum":["silence","suspend"]},"comment":{"type":["null","string"]}},"required":["domain"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/translation-languages":{"get":{"operationId":"mastodonTranslationLanguagesList","summary":"Mastodon: List Translation languages","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/instance/#translation_languages Generic route: `/v1/accounts/{accountId}/focus/translation-languages`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-translation-languages-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"targets":{"type":"array","items":{"type":"string"}}},"required":["source"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/custom-emojis":{"get":{"operationId":"mastodonCustomEmojisList","summary":"Mastodon: List Custom emoji","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/custom_emojis/ Generic route: `/v1/accounts/{accountId}/focus/custom-emojis`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-custom-emojis-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"shortcode":{"type":"string"},"url":{"type":"string","format":"uri"},"static_url":{"type":"string","format":"uri"},"visible_in_picker":{"type":"boolean"},"category":{"type":["null","string"]}},"required":["shortcode"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/announcements":{"get":{"operationId":"mastodonAnnouncementsList","summary":"Mastodon: List Announcements","tags":["Focus · Mastodon"],"description":"Server announcements; dismiss or react. Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: `/v1/accounts/{accountId}/focus/announcements`.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"with_dismissed","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-announcements-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"starts_at":{"type":["null","string"],"format":"date-time"},"ends_at":{"type":["null","string"],"format":"date-time"},"published_at":{"type":"string","format":"date-time"},"read":{"type":"boolean"},"reactions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"},"me":{"type":"boolean"}}}}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/announcements/{itemId}/dismiss":{"post":{"operationId":"mastodonAnnouncementsDismiss","summary":"Mastodon: Dismiss (Announcements)","tags":["Focus · Mastodon"],"description":"Dismiss. Server announcements; dismiss or react. Requires scopes: write:accounts. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: `/v1/accounts/{accountId}/focus/announcements`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-announcements-dismiss","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/announcements/{itemId}/react":{"post":{"operationId":"mastodonAnnouncementsReact","summary":"Mastodon: React (Announcements)","tags":["Focus · Mastodon"],"description":"React. Server announcements; dismiss or react. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: `/v1/accounts/{accountId}/focus/announcements`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Unicode emoji or custom shortcode"}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-announcements-react","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/announcements/{itemId}/unreact":{"post":{"operationId":"mastodonAnnouncementsUnreact","summary":"Mastodon: Remove reaction (Announcements)","tags":["Focus · Mastodon"],"description":"Remove reaction. Server announcements; dismiss or react. Requires scopes: write:favourites. Network docs: https://docs.joinmastodon.org/methods/announcements/ Generic route: `/v1/accounts/{accountId}/focus/announcements`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-announcements-unreact","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/account-overview":{"get":{"operationId":"mastodonAccountOverviewList","summary":"Mastodon: List Account overview","tags":["Focus · Mastodon"],"description":"Daily engagement on posts created in the window (favourites, replies, boosts, quotes) plus current followers. Mastodon keeps no history, so engagement is attributed to the post’s creation day. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:accounts, read:statuses. Network docs: https://docs.joinmastodon.org/methods/accounts/#statuses Generic route: `/v1/accounts/{accountId}/focus/account-overview`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Default: 30 days ago"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"Default: today"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-account-overview-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"posts":{"type":"integer"},"likes":{"type":"integer"},"comments":{"type":"integer"},"shares":{"type":"integer"},"quotes":{"type":"integer"},"engagements":{"type":"integer"},"followers":{"type":["null","integer"]},"following":{"type":["null","integer"]}},"required":["date"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/post-performance":{"get":{"operationId":"mastodonPostPerformanceList","summary":"Mastodon: List Post performance","tags":["Focus · Mastodon"],"description":"Your posts in the window ranked by engagements (favourites + replies + boosts + quotes). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read:accounts, read:statuses. Network docs: https://docs.joinmastodon.org/methods/accounts/#statuses Generic route: `/v1/accounts/{accountId}/focus/post-performance`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Default: 30 days ago"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"Default: today"},{"schema":{"type":"integer","default":20,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-post-performance-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"text":{"type":"string"},"likes":{"type":"integer"},"comments":{"type":"integer"},"shares":{"type":"integer"},"quotes":{"type":"integer"},"engagements":{"type":"integer"},"url":{"type":["null","string"],"format":"uri"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-accounts":{"get":{"operationId":"mastodonAdminAccountsList","summary":"Mastodon: List Accounts","tags":["Focus · Mastodon"],"description":"GET /api/v2/admin/accounts. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: `/v1/accounts/{accountId}/focus/admin-accounts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["local","remote"]},"in":"query","name":"origin","required":false},{"schema":{"type":"string","enum":["active","pending","disabled","silenced","suspended"]},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["staff"]},"in":"query","name":"permissions","required":false},{"schema":{"type":"array","items":{"type":"string"}},"in":"query","name":"role_ids","required":false},{"schema":{"type":"string"},"in":"query","name":"invited_by","required":false},{"schema":{"type":"string"},"in":"query","name":"username","required":false},{"schema":{"type":"string"},"in":"query","name":"display_name","required":false},{"schema":{"type":"string"},"in":"query","name":"by_domain","required":false},{"schema":{"type":"string"},"in":"query","name":"email","required":false},{"schema":{"type":"string"},"in":"query","name":"ip","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-accounts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string"},"domain":{"type":["null","string"]},"acct":{"type":"string"},"display_name":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"email":{"type":["null","string"],"format":"email"},"ip":{"type":["null","string"]},"locale":{"type":["null","string"]},"role":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"permissions":{"type":"string"}}},"confirmed":{"type":"boolean"},"approved":{"type":"boolean"},"disabled":{"type":"boolean"},"silenced":{"type":"boolean"},"suspended":{"type":"boolean"},"sensitized":{"type":"boolean"},"invite_request":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-accounts/{itemId}":{"get":{"operationId":"mastodonAdminAccountsGet","summary":"Mastodon: Get a Accounts item","tags":["Focus · Mastodon"],"description":"Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: `/v1/accounts/{accountId}/focus/admin-accounts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-accounts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string"},"domain":{"type":["null","string"]},"acct":{"type":"string"},"display_name":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"email":{"type":["null","string"],"format":"email"},"ip":{"type":["null","string"]},"locale":{"type":["null","string"]},"role":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"permissions":{"type":"string"}}},"confirmed":{"type":"boolean"},"approved":{"type":"boolean"},"disabled":{"type":"boolean"},"silenced":{"type":"boolean"},"suspended":{"type":"boolean"},"sensitized":{"type":"boolean"},"invite_request":{"type":["null","string"]},"account":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"acct":{"type":"string","title":"Handle"},"username":{"type":"string"},"display_name":{"type":"string","title":"Name"},"url":{"type":"string","format":"uri","title":"Profile"},"avatar":{"type":"string"},"header":{"type":"string"},"note":{"type":"string"},"note_text":{"type":"string","title":"Bio"},"locked":{"type":"boolean"},"bot":{"type":"boolean"},"group":{"type":"boolean"},"discoverable":{"type":["null","boolean"]},"indexable":{"type":["null","boolean"]},"followers_count":{"type":"integer","title":"Followers"},"following_count":{"type":"integer","title":"Following"},"statuses_count":{"type":"integer","title":"Posts"},"created_at":{"type":"string","format":"date-time"},"last_status_at":{"type":["null","string"],"format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"},"verified_at":{"type":["null","string"],"format":"date-time"}}}},"moved":{"type":["null","object"],"properties":{},"additionalProperties":true},"suspended":{"type":"boolean"},"limited":{"type":"boolean"}},"required":["id","acct"]}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonAdminAccountsDelete","summary":"Mastodon: Delete a Accounts item","tags":["Focus · Mastodon"],"description":"Delete the data of a suspended account. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: `/v1/accounts/{accountId}/focus/admin-accounts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-accounts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-accounts/{itemId}/approve":{"post":{"operationId":"mastodonAdminAccountsApprove","summary":"Mastodon: Approve sign-up (Accounts)","tags":["Focus · Mastodon"],"description":"Approve sign-up. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: `/v1/accounts/{accountId}/focus/admin-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-accounts-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-accounts/{itemId}/reject":{"post":{"operationId":"mastodonAdminAccountsReject","summary":"Mastodon: Reject sign-up (Accounts)","tags":["Focus · Mastodon"],"description":"Reject sign-up. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Destructive. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: `/v1/accounts/{accountId}/focus/admin-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-accounts-reject","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-accounts/{itemId}/action":{"post":{"operationId":"mastodonAdminAccountsAction","summary":"Mastodon: Moderate (Accounts)","tags":["Focus · Mastodon"],"description":"Moderate. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Destructive. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: `/v1/accounts/{accountId}/focus/admin-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["none","sensitive","disable","silence","suspend"]},"report_id":{"type":"string"},"warning_preset_id":{"type":"string"},"text":{"type":"string"},"send_email_notification":{"type":"boolean","default":true}},"required":["type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-accounts-action","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-accounts/{itemId}/enable":{"post":{"operationId":"mastodonAdminAccountsEnable","summary":"Mastodon: Re-enable login (Accounts)","tags":["Focus · Mastodon"],"description":"Re-enable login. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: `/v1/accounts/{accountId}/focus/admin-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-accounts-enable","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsilence":{"post":{"operationId":"mastodonAdminAccountsUnsilence","summary":"Mastodon: Unlimit (Accounts)","tags":["Focus · Mastodon"],"description":"Unlimit. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: `/v1/accounts/{accountId}/focus/admin-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-accounts-unsilence","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsuspend":{"post":{"operationId":"mastodonAdminAccountsUnsuspend","summary":"Mastodon: Unsuspend (Accounts)","tags":["Focus · Mastodon"],"description":"Unsuspend. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: `/v1/accounts/{accountId}/focus/admin-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-accounts-unsuspend","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-accounts/{itemId}/unsensitive":{"post":{"operationId":"mastodonAdminAccountsUnsensitive","summary":"Mastodon: Unmark sensitive (Accounts)","tags":["Focus · Mastodon"],"description":"Unmark sensitive. Moderate local and remote accounts: approve sign-ups, warn, limit, suspend. Requires scopes: admin:write:accounts. Requires one of: admin:read | admin:read:accounts. Network docs: https://docs.joinmastodon.org/methods/admin/accounts/ Generic route: `/v1/accounts/{accountId}/focus/admin-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-accounts-unsensitive","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-reports":{"get":{"operationId":"mastodonAdminReportsList","summary":"Mastodon: List Reports","tags":["Focus · Mastodon"],"description":"Moderation reports: assign, resolve, reopen, recategorize. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: `/v1/accounts/{accountId}/focus/admin-reports`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"boolean"},"in":"query","name":"resolved","required":false},{"schema":{"type":"string"},"in":"query","name":"account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"target_account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-reports-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"category":{"type":"string","enum":["spam","legal","violation","other"]},"comment":{"type":"string"},"forwarded":{"type":"boolean"},"action_taken":{"type":"boolean"},"action_taken_at":{"type":["null","string"],"format":"date-time"},"reporter":{"type":["null","string"]},"target":{"type":["null","string"]},"assigned_to":{"type":["null","string"]},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"}}}},"statuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"]}}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-reports/{itemId}":{"get":{"operationId":"mastodonAdminReportsGet","summary":"Mastodon: Get a Reports item","tags":["Focus · Mastodon"],"description":"Moderation reports: assign, resolve, reopen, recategorize. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: `/v1/accounts/{accountId}/focus/admin-reports`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-reports-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"category":{"type":"string","enum":["spam","legal","violation","other"]},"comment":{"type":"string"},"forwarded":{"type":"boolean"},"action_taken":{"type":"boolean"},"action_taken_at":{"type":["null","string"],"format":"date-time"},"reporter":{"type":["null","string"]},"target":{"type":["null","string"]},"assigned_to":{"type":["null","string"]},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"}}}},"statuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"]}}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonAdminReportsUpdate","summary":"Mastodon: Update a Reports item","tags":["Focus · Mastodon"],"description":"Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: `/v1/accounts/{accountId}/focus/admin-reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["spam","legal","violation","other"]},"rule_ids":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-reports-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"category":{"type":"string","enum":["spam","legal","violation","other"]},"comment":{"type":"string"},"forwarded":{"type":"boolean"},"action_taken":{"type":"boolean"},"action_taken_at":{"type":["null","string"],"format":"date-time"},"reporter":{"type":["null","string"]},"target":{"type":["null","string"]},"assigned_to":{"type":["null","string"]},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"}}}},"statuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true}},"required":["id"]}}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-reports/{itemId}/assign":{"post":{"operationId":"mastodonAdminReportsAssign","summary":"Mastodon: Assign to me (Reports)","tags":["Focus · Mastodon"],"description":"Assign to me. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: `/v1/accounts/{accountId}/focus/admin-reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-reports-assign","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-reports/{itemId}/unassign":{"post":{"operationId":"mastodonAdminReportsUnassign","summary":"Mastodon: Unassign (Reports)","tags":["Focus · Mastodon"],"description":"Unassign. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: `/v1/accounts/{accountId}/focus/admin-reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-reports-unassign","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-reports/{itemId}/resolve":{"post":{"operationId":"mastodonAdminReportsResolve","summary":"Mastodon: Resolve (Reports)","tags":["Focus · Mastodon"],"description":"Resolve. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: `/v1/accounts/{accountId}/focus/admin-reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-reports-resolve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-reports/{itemId}/reopen":{"post":{"operationId":"mastodonAdminReportsReopen","summary":"Mastodon: Reopen (Reports)","tags":["Focus · Mastodon"],"description":"Reopen. Moderation reports: assign, resolve, reopen, recategorize. Requires scopes: admin:write:reports. Requires one of: admin:read | admin:read:reports. Network docs: https://docs.joinmastodon.org/methods/admin/reports/ Generic route: `/v1/accounts/{accountId}/focus/admin-reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-reports-reopen","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-domain-blocks":{"get":{"operationId":"mastodonAdminDomainBlocksList","summary":"Mastodon: List Domain blocks","tags":["Focus · Mastodon"],"description":"Limit or suspend remote servers (4.0+). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-domain-blocks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-domain-blocks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"digest":{"type":"string"},"domain":{"type":"string"},"severity":{"type":"string","enum":["silence","suspend","noop"]},"reject_media":{"type":"boolean"},"reject_reports":{"type":"boolean"},"private_comment":{"type":"string"},"public_comment":{"type":"string"},"obfuscate":{"type":"boolean"}},"required":["id","domain"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonAdminDomainBlocksCreate","summary":"Mastodon: Create a Domain blocks item","tags":["Focus · Mastodon"],"description":"Limit or suspend remote servers (4.0+). Requires scopes: admin:write:domain_blocks. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-domain-blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"severity":{"type":"string","enum":["silence","suspend","noop"]},"reject_media":{"type":"boolean"},"reject_reports":{"type":"boolean"},"private_comment":{"type":"string"},"public_comment":{"type":"string"},"obfuscate":{"type":"boolean"}},"required":["domain"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-domain-blocks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"digest":{"type":"string"},"domain":{"type":"string"},"severity":{"type":"string","enum":["silence","suspend","noop"]},"reject_media":{"type":"boolean"},"reject_reports":{"type":"boolean"},"private_comment":{"type":"string"},"public_comment":{"type":"string"},"obfuscate":{"type":"boolean"}},"required":["id","domain"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-domain-blocks/{itemId}":{"get":{"operationId":"mastodonAdminDomainBlocksGet","summary":"Mastodon: Get a Domain blocks item","tags":["Focus · Mastodon"],"description":"Limit or suspend remote servers (4.0+). Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-domain-blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-domain-blocks-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"digest":{"type":"string"},"domain":{"type":"string"},"severity":{"type":"string","enum":["silence","suspend","noop"]},"reject_media":{"type":"boolean"},"reject_reports":{"type":"boolean"},"private_comment":{"type":"string"},"public_comment":{"type":"string"},"obfuscate":{"type":"boolean"}},"required":["id","domain"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonAdminDomainBlocksUpdate","summary":"Mastodon: Update a Domain blocks item","tags":["Focus · Mastodon"],"description":"Limit or suspend remote servers (4.0+). Requires scopes: admin:write:domain_blocks. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-domain-blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"severity":{"type":"string","enum":["silence","suspend","noop"]},"reject_media":{"type":"boolean"},"reject_reports":{"type":"boolean"},"private_comment":{"type":"string"},"public_comment":{"type":"string"},"obfuscate":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-domain-blocks-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"digest":{"type":"string"},"domain":{"type":"string"},"severity":{"type":"string","enum":["silence","suspend","noop"]},"reject_media":{"type":"boolean"},"reject_reports":{"type":"boolean"},"private_comment":{"type":"string"},"public_comment":{"type":"string"},"obfuscate":{"type":"boolean"}},"required":["id","domain"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonAdminDomainBlocksDelete","summary":"Mastodon: Delete a Domain blocks item","tags":["Focus · Mastodon"],"description":"Limit or suspend remote servers (4.0+). Requires scopes: admin:write:domain_blocks. Requires one of: admin:read | admin:read:domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-domain-blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-domain-blocks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-domain-allows":{"get":{"operationId":"mastodonAdminDomainAllowsList","summary":"Mastodon: List Domain allows","tags":["Focus · Mastodon"],"description":"Allowed servers in limited-federation mode. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: `/v1/accounts/{accountId}/focus/admin-domain-allows`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-domain-allows-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"domain":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"required":["id","domain"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonAdminDomainAllowsCreate","summary":"Mastodon: Create a Domain allows item","tags":["Focus · Mastodon"],"description":"Allowed servers in limited-federation mode. Requires scopes: admin:write:domain_allows. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: `/v1/accounts/{accountId}/focus/admin-domain-allows`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-domain-allows-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"domain":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"required":["id","domain"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-domain-allows/{itemId}":{"get":{"operationId":"mastodonAdminDomainAllowsGet","summary":"Mastodon: Get a Domain allows item","tags":["Focus · Mastodon"],"description":"Allowed servers in limited-federation mode. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: `/v1/accounts/{accountId}/focus/admin-domain-allows`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-domain-allows-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"domain":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"required":["id","domain"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonAdminDomainAllowsDelete","summary":"Mastodon: Delete a Domain allows item","tags":["Focus · Mastodon"],"description":"Allowed servers in limited-federation mode. Requires scopes: admin:write:domain_allows. Requires one of: admin:read | admin:read:domain_allows. Network docs: https://docs.joinmastodon.org/methods/admin/domain_allows/ Generic route: `/v1/accounts/{accountId}/focus/admin-domain-allows`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-domain-allows-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-ip-blocks":{"get":{"operationId":"mastodonAdminIpBlocksList","summary":"Mastodon: List IP blocks","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-ip-blocks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-ip-blocks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":["null","string"],"format":"date-time"},"ip":{"type":"string","description":"IP or CIDR range"},"severity":{"type":"string","enum":["sign_up_requires_approval","sign_up_block","no_access"]},"comment":{"type":"string"},"expires_in":{"type":"integer","description":"Seconds"}},"required":["id","ip"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonAdminIpBlocksCreate","summary":"Mastodon: Create a IP blocks item","tags":["Focus · Mastodon"],"description":"Requires scopes: admin:write:ip_blocks. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-ip-blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ip":{"type":"string","description":"IP or CIDR range"},"severity":{"type":"string","enum":["sign_up_requires_approval","sign_up_block","no_access"]},"comment":{"type":"string"},"expires_in":{"type":"integer","description":"Seconds"}},"required":["ip","severity"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-ip-blocks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":["null","string"],"format":"date-time"},"ip":{"type":"string","description":"IP or CIDR range"},"severity":{"type":"string","enum":["sign_up_requires_approval","sign_up_block","no_access"]},"comment":{"type":"string"},"expires_in":{"type":"integer","description":"Seconds"}},"required":["id","ip"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-ip-blocks/{itemId}":{"get":{"operationId":"mastodonAdminIpBlocksGet","summary":"Mastodon: Get a IP blocks item","tags":["Focus · Mastodon"],"description":"Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-ip-blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-ip-blocks-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":["null","string"],"format":"date-time"},"ip":{"type":"string","description":"IP or CIDR range"},"severity":{"type":"string","enum":["sign_up_requires_approval","sign_up_block","no_access"]},"comment":{"type":"string"},"expires_in":{"type":"integer","description":"Seconds"}},"required":["id","ip"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"mastodonAdminIpBlocksUpdate","summary":"Mastodon: Update a IP blocks item","tags":["Focus · Mastodon"],"description":"Requires scopes: admin:write:ip_blocks. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-ip-blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ip":{"type":"string","description":"IP or CIDR range"},"severity":{"type":"string","enum":["sign_up_requires_approval","sign_up_block","no_access"]},"comment":{"type":"string"},"expires_in":{"type":"integer","description":"Seconds"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-ip-blocks-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":["null","string"],"format":"date-time"},"ip":{"type":"string","description":"IP or CIDR range"},"severity":{"type":"string","enum":["sign_up_requires_approval","sign_up_block","no_access"]},"comment":{"type":"string"},"expires_in":{"type":"integer","description":"Seconds"}},"required":["id","ip"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonAdminIpBlocksDelete","summary":"Mastodon: Delete a IP blocks item","tags":["Focus · Mastodon"],"description":"Requires scopes: admin:write:ip_blocks. Requires one of: admin:read | admin:read:ip_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/ip_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-ip-blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-ip-blocks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-email-domain-blocks":{"get":{"operationId":"mastodonAdminEmailDomainBlocksList","summary":"Mastodon: List Email domain blocks","tags":["Focus · Mastodon"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-email-domain-blocks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-email-domain-blocks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"domain":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"accounts":{"type":"string"},"uses":{"type":"string"}}}}},"required":["id","domain"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonAdminEmailDomainBlocksCreate","summary":"Mastodon: Create a Email domain blocks item","tags":["Focus · Mastodon"],"description":"Requires scopes: admin:write:email_domain_blocks. Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-email-domain-blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-email-domain-blocks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"domain":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"accounts":{"type":"string"},"uses":{"type":"string"}}}}},"required":["id","domain"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-email-domain-blocks/{itemId}":{"get":{"operationId":"mastodonAdminEmailDomainBlocksGet","summary":"Mastodon: Get a Email domain blocks item","tags":["Focus · Mastodon"],"description":"Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-email-domain-blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-email-domain-blocks-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"domain":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"accounts":{"type":"string"},"uses":{"type":"string"}}}}},"required":["id","domain"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonAdminEmailDomainBlocksDelete","summary":"Mastodon: Delete a Email domain blocks item","tags":["Focus · Mastodon"],"description":"Requires scopes: admin:write:email_domain_blocks. Requires one of: admin:read | admin:read:email_domain_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/email_domain_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-email-domain-blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-email-domain-blocks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-canonical-email-blocks":{"get":{"operationId":"mastodonAdminCanonicalEmailBlocksList","summary":"Mastodon: List Email blocks","tags":["Focus · Mastodon"],"description":"Block specific (canonicalized) email addresses. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-canonical-email-blocks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from a previous next_cursor"},{"schema":{"type":"integer","minimum":1,"maximum":80,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-canonical-email-blocks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"canonical_email_hash":{"type":"string"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"mastodonAdminCanonicalEmailBlocksCreate","summary":"Mastodon: Create a Email blocks item","tags":["Focus · Mastodon"],"description":"Block specific (canonicalized) email addresses. Requires scopes: admin:write:canonical_email_blocks. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-canonical-email-blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"canonical_email_hash":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-canonical-email-blocks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"canonical_email_hash":{"type":"string"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-canonical-email-blocks/{itemId}":{"get":{"operationId":"mastodonAdminCanonicalEmailBlocksGet","summary":"Mastodon: Get a Email blocks item","tags":["Focus · Mastodon"],"description":"Block specific (canonicalized) email addresses. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-canonical-email-blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-canonical-email-blocks-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"canonical_email_hash":{"type":"string"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"mastodonAdminCanonicalEmailBlocksDelete","summary":"Mastodon: Delete a Email blocks item","tags":["Focus · Mastodon"],"description":"Block specific (canonicalized) email addresses. Requires scopes: admin:write:canonical_email_blocks. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-canonical-email-blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-canonical-email-blocks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-canonical-email-blocks/test":{"post":{"operationId":"mastodonAdminCanonicalEmailBlocksTest","summary":"Mastodon: Test an email (Email blocks)","tags":["Focus · Mastodon"],"description":"Test an email. Block specific (canonicalized) email addresses. Requires one of: admin:read | admin:read:canonical_email_blocks. Network docs: https://docs.joinmastodon.org/methods/admin/canonical_email_blocks/ Generic route: `/v1/accounts/{accountId}/focus/admin-canonical-email-blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"}},"required":["email"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-canonical-email-blocks-test","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-measures":{"get":{"operationId":"mastodonAdminMeasuresList","summary":"Mastodon: List Server metrics","tags":["Focus · Mastodon"],"description":"Active users, sign-ups, interactions, reports per day. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/measures/ Generic route: `/v1/accounts/{accountId}/focus/admin-measures`.","parameters":[{"schema":{"type":"array","items":{"type":"string","enum":["active_users","new_users","interactions","opened_reports","resolved_reports","tag_accounts","tag_uses","tag_servers","instance_accounts","instance_media_attachments","instance_reports","instance_statuses","instance_follows","instance_followers"]}},"in":"query","name":"keys","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false},{"schema":{},"in":"query","name":"params","required":false,"description":"Per-key params, e.g. { tag_accounts: { id } } · JSON-encoded object or array"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-measures-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"key":{"type":"string","enum":["active_users","new_users","interactions","opened_reports","resolved_reports","tag_accounts","tag_uses","tag_servers","instance_accounts","instance_media_attachments","instance_reports","instance_statuses","instance_follows","instance_followers"]},"date":{"type":"string","format":"date"},"value":{"type":"number"}},"required":["key","date"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-dimensions":{"get":{"operationId":"mastodonAdminDimensionsList","summary":"Mastodon: List Server breakdowns","tags":["Focus · Mastodon"],"description":"Top languages, sign-up sources, servers, software versions, space usage. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/dimensions/ Generic route: `/v1/accounts/{accountId}/focus/admin-dimensions`.","parameters":[{"schema":{"type":"array","items":{"type":"string","enum":["languages","sources","servers","space_usage","software_versions","tag_servers","tag_languages","instance_accounts","instance_languages"]}},"in":"query","name":"keys","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false},{"schema":{"type":"integer","default":10},"in":"query","name":"limit","required":false},{"schema":{},"in":"query","name":"params","required":false,"description":"JSON-encoded object or array"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-dimensions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"key":{"type":"string","enum":["languages","sources","servers","space_usage","software_versions","tag_servers","tag_languages","instance_accounts","instance_languages"]},"item":{"type":"string"},"label":{"type":"string"},"value":{"type":"number"}},"required":["key"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-retention":{"get":{"operationId":"mastodonAdminRetentionList","summary":"Mastodon: List Retention","tags":["Focus · Mastodon"],"description":"Sign-up cohorts and how many stay active. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/retention/ Generic route: `/v1/accounts/{accountId}/focus/admin-retention`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false},{"schema":{"type":"string","enum":["day","month"]},"in":"query","name":"frequency","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-retention-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"cohort":{"type":"string","format":"date"},"date":{"type":"string","format":"date"},"rate":{"type":"number"},"value":{"type":"integer"}},"required":["cohort","date"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-trends-links":{"get":{"operationId":"mastodonAdminTrendsLinksList","summary":"Mastodon: List Trending links review","tags":["Focus · Mastodon"],"description":"Review trending links: approve to allow them in public trends, reject to hide. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: `/v1/accounts/{accountId}/focus/admin-trends-links`.","parameters":[{"schema":{"type":"integer","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-trends-links-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string"},"provider_name":{"type":"string"},"requires_review":{"type":"boolean"}},"required":["url"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-trends-links/{itemId}/approve":{"post":{"operationId":"mastodonAdminTrendsLinksApprove","summary":"Mastodon: Approve (Trending links review)","tags":["Focus · Mastodon"],"description":"Approve. Review trending links: approve to allow them in public trends, reject to hide. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: `/v1/accounts/{accountId}/focus/admin-trends-links`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-trends-links-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-trends-links/{itemId}/reject":{"post":{"operationId":"mastodonAdminTrendsLinksReject","summary":"Mastodon: Reject (Trending links review)","tags":["Focus · Mastodon"],"description":"Reject. Review trending links: approve to allow them in public trends, reject to hide. Destructive. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: `/v1/accounts/{accountId}/focus/admin-trends-links`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-trends-links-reject","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-trends-statuses":{"get":{"operationId":"mastodonAdminTrendsStatusesList","summary":"Mastodon: List Trending posts review","tags":["Focus · Mastodon"],"description":"Review trending statuses: approve to allow them in public trends, reject to hide. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: `/v1/accounts/{accountId}/focus/admin-trends-statuses`.","parameters":[{"schema":{"type":"integer","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-trends-statuses-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"uri":{"type":"string","format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"text":{"type":"string","title":"Text","readOnly":true},"content":{"type":"string"},"spoiler_text":{"type":"string","title":"Content warning"},"sensitive":{"type":"boolean"},"visibility":{"type":"string","enum":["public","unlisted","private","direct"]},"language":{"type":["null","string"]},"in_reply_to_id":{"type":["null","string"]},"in_reply_to_account_id":{"type":["null","string"]},"replies_count":{"type":"integer","title":"Replies"},"reblogs_count":{"type":"integer","title":"Boosts"},"favourites_count":{"type":"integer","title":"Favourites"},"quotes_count":{"type":["null","integer"],"title":"Quotes"},"author":{"type":"string","title":"Author"},"author_name":{"type":["null","string"]},"media_attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["image","gifv","video","audio","unknown"]},"url":{"type":["null","string"],"format":"uri"},"preview_url":{"type":["null","string"],"format":"uri"},"remote_url":{"type":["null","string"],"format":"uri"},"description":{"type":["null","string"],"title":"Alt text"},"blurhash":{"type":["null","string"]},"meta":{"type":"object","properties":{},"additionalProperties":true}}}},"poll":{"type":["null","object"],"properties":{"id":{"type":"string","readOnly":true},"expires_at":{"type":["null","string"],"format":"date-time"},"expired":{"type":"boolean"},"multiple":{"type":"boolean"},"votes_count":{"type":"integer"},"voters_count":{"type":["null","integer"]},"voted":{"type":"boolean"},"own_votes":{"type":"array","items":{"type":"integer"}},"options":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"votes_count":{"type":["null","integer"]}}}}}},"favourited":{"type":"boolean"},"reblogged":{"type":"boolean"},"bookmarked":{"type":"boolean"},"muted":{"type":"boolean"},"pinned":{"type":"boolean"},"is_reblog":{"type":"boolean"},"quote":{"type":["null","object"],"properties":{"state":{"type":"string"},"quoted_status":{"type":["null","object"],"properties":{},"additionalProperties":true}}},"quote_approval":{"type":["null","object"],"properties":{},"additionalProperties":true},"requires_review":{"type":"boolean"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-trends-statuses/{itemId}/approve":{"post":{"operationId":"mastodonAdminTrendsStatusesApprove","summary":"Mastodon: Approve (Trending posts review)","tags":["Focus · Mastodon"],"description":"Approve. Review trending statuses: approve to allow them in public trends, reject to hide. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: `/v1/accounts/{accountId}/focus/admin-trends-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-trends-statuses-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-trends-statuses/{itemId}/reject":{"post":{"operationId":"mastodonAdminTrendsStatusesReject","summary":"Mastodon: Reject (Trending posts review)","tags":["Focus · Mastodon"],"description":"Reject. Review trending statuses: approve to allow them in public trends, reject to hide. Destructive. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: `/v1/accounts/{accountId}/focus/admin-trends-statuses`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-trends-statuses-reject","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-trends-tags":{"get":{"operationId":"mastodonAdminTrendsTagsList","summary":"Mastodon: List Trending hashtags review","tags":["Focus · Mastodon"],"description":"Review trending tags: approve to allow them in public trends, reject to hide. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: admin:read. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: `/v1/accounts/{accountId}/focus/admin-trends-tags`.","parameters":[{"schema":{"type":"integer","default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-trends-tags-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"]},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"following":{"type":["null","boolean"]},"featuring":{"type":["null","boolean"]},"history":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"uses":{"type":"string"},"accounts":{"type":"string"}}}},"requires_review":{"type":"boolean"},"trendable":{"type":"boolean"},"usable":{"type":"boolean"}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-trends-tags/{itemId}/approve":{"post":{"operationId":"mastodonAdminTrendsTagsApprove","summary":"Mastodon: Approve (Trending hashtags review)","tags":["Focus · Mastodon"],"description":"Approve. Review trending tags: approve to allow them in public trends, reject to hide. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: `/v1/accounts/{accountId}/focus/admin-trends-tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-trends-tags-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/mastodon/admin-trends-tags/{itemId}/reject":{"post":{"operationId":"mastodonAdminTrendsTagsReject","summary":"Mastodon: Reject (Trending hashtags review)","tags":["Focus · Mastodon"],"description":"Reject. Review trending tags: approve to allow them in public trends, reject to hide. Destructive. Requires scopes: admin:read, admin:write. Network docs: https://docs.joinmastodon.org/methods/admin/trends/ Generic route: `/v1/accounts/{accountId}/focus/admin-trends-tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_mastodon","x-mcp-tool":"mastodon-admin-trends-tags-reject","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/profile":{"get":{"operationId":"pinterestProfileGet","summary":"Pinterest: Get Profile","tags":["Focus · Pinterest"],"description":"Account details and counts (followers, following, Pins, boards, monthly views). Pinterest does not allow profile edits via API. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_account/get Generic route: `/v1/accounts/{accountId}/focus/profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"account_type":{"type":"string","enum":["PINNER","BUSINESS"],"readOnly":true},"business_name":{"type":["null","string"],"readOnly":true},"about":{"type":["null","string"],"readOnly":true},"profile_image":{"type":["null","string"],"format":"uri","readOnly":true},"website_url":{"type":["null","string"],"format":"uri","readOnly":true},"follower_count":{"type":["null","integer"],"readOnly":true},"following_count":{"type":["null","integer"],"readOnly":true},"pin_count":{"type":["null","integer"],"readOnly":true},"board_count":{"type":["null","integer"],"readOnly":true},"monthly_views":{"type":["null","integer"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/linked-businesses":{"get":{"operationId":"pinterestLinkedBusinessesList","summary":"Pinterest: List Linked businesses","tags":["Focus · Pinterest"],"description":"Business accounts linked to this Pinterest user. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/linked_business_accounts/get Generic route: `/v1/accounts/{accountId}/focus/linked-businesses`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-linked-businesses-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","readOnly":true},"image_small_url":{"type":["null","string"],"format":"uri","readOnly":true},"image_medium_url":{"type":["null","string"],"format":"uri","readOnly":true},"image_large_url":{"type":["null","string"],"format":"uri","readOnly":true},"image_xlarge_url":{"type":["null","string"],"format":"uri","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/followers":{"get":{"operationId":"pinterestFollowersList","summary":"Pinterest: List Followers","tags":["Focus · Pinterest"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/followers/list Generic route: `/v1/accounts/{accountId}/focus/followers`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-followers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","readOnly":true},"type":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/following":{"get":{"operationId":"pinterestFollowingList","summary":"Pinterest: List Following","tags":["Focus · Pinterest"],"description":"Users this account follows. Follow is a single, user-initiated action (no automated follows). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_following/get Generic route: `/v1/accounts/{accountId}/focus/following`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["ALL","RANKED","CREATOR_ONLY","RANKED_CREATOR_ONLY"]},"in":"query","name":"feed_type","required":false},{"schema":{"type":"boolean"},"in":"query","name":"explicit_following","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-following-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string","readOnly":true},"type":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/following/follow":{"post":{"operationId":"pinterestFollowingFollow","summary":"Pinterest: Follow user (Following)","tags":["Focus · Pinterest"],"description":"Follow user. Users this account follows. Follow is a single, user-initiated action (no automated follows). Requires scopes: user_accounts:read, user_accounts:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_following/get Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-following-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/following-boards":{"get":{"operationId":"pinterestFollowingBoardsList","summary":"Pinterest: List Followed boards","tags":["Focus · Pinterest"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/boards_user_follows/list Generic route: `/v1/accounts/{accountId}/focus/following-boards`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"boolean"},"in":"query","name":"explicit_following","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-following-boards-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":180},"description":{"type":["null","string"]},"privacy":{"type":"string","enum":["PUBLIC","PROTECTED","SECRET"],"default":"PUBLIC"},"url":{"type":["null","string"],"format":"uri","readOnly":true,"description":"Best-effort board URL"},"pin_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"collaborator_count":{"type":"integer","readOnly":true},"is_ads_only":{"type":"boolean","default":false},"image_cover_url":{"type":["null","string"],"format":"uri","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"board_pins_modified_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/interests":{"get":{"operationId":"pinterestInterestsList","summary":"Pinterest: List Followed interests","tags":["Focus · Pinterest"],"description":"Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_account/followed_interests Generic route: `/v1/accounts/{accountId}/focus/interests`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"username","required":false,"description":"Defaults to the connected account"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-interests-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"key":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"canonical_url":{"type":["null","string"],"format":"uri","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/websites":{"get":{"operationId":"pinterestWebsitesList","summary":"Pinterest: List Claimed websites","tags":["Focus · Pinterest"],"description":"Claim a website (meta tag, HTML file or DNS TXT) to unlock website analytics and attribution. Item id = website. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_websites/get Generic route: `/v1/accounts/{accountId}/focus/websites`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-websites-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"website":{"type":"string","description":"Domain or domain/path"},"status":{"type":["null","string"],"readOnly":true},"verified_at":{"type":["null","string"],"readOnly":true},"verification_method":{"type":"string","enum":["METATAG","FILENAME","DNSTXT"],"writeOnly":true,"default":"METATAG"}},"required":["website"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"pinterestWebsitesCreate","summary":"Pinterest: Create a Claimed websites item","tags":["Focus · Pinterest"],"description":"Verify (claim) the website once the verification code is in place. Claim a website (meta tag, HTML file or DNS TXT) to unlock website analytics and attribution. Item id = website. Requires scopes: user_accounts:read, user_accounts:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_websites/get Generic route: `/v1/accounts/{accountId}/focus/websites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"website":{"type":"string"},"verification_method":{"type":"string","enum":["METATAG","FILENAME","DNSTXT"],"default":"METATAG"}},"required":["website"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-websites-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"website":{"type":"string","description":"Domain or domain/path"},"status":{"type":["null","string"],"readOnly":true},"verified_at":{"type":["null","string"],"readOnly":true},"verification_method":{"type":"string","enum":["METATAG","FILENAME","DNSTXT"],"writeOnly":true,"default":"METATAG"}},"required":["website"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/websites/{itemId}":{"delete":{"operationId":"pinterestWebsitesDelete","summary":"Pinterest: Delete a Claimed websites item","tags":["Focus · Pinterest"],"description":"Unclaim the website. Claim a website (meta tag, HTML file or DNS TXT) to unlock website analytics and attribution. Item id = website. Requires scopes: user_accounts:read, user_accounts:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_websites/get Generic route: `/v1/accounts/{accountId}/focus/websites`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-websites-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/websites/verification-code":{"post":{"operationId":"pinterestWebsitesVerificationCode","summary":"Pinterest: Get verification code (Claimed websites)","tags":["Focus · Pinterest"],"description":"Meta tag, HTML file, DNS TXT record and code to place on the site. Claim a website (meta tag, HTML file or DNS TXT) to unlock website analytics and attribution. Item id = website. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_websites/get Generic route: `/v1/accounts/{accountId}/focus/websites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-websites-verification-code","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/boards":{"get":{"operationId":"pinterestBoardsList","summary":"Pinterest: List Boards","tags":["Focus · Pinterest"],"description":"List boards, filter by privacy or search by name (search needs boards:read_secret). Boards (public, protected and secret), the default board used for publishing, and board Pins. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: boards:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: `/v1/accounts/{accountId}/focus/boards`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["ALL","PUBLIC","PROTECTED","SECRET","PUBLIC_AND_SECRET"]},"in":"query","name":"privacy","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false,"description":"Search boards by name"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-boards-list","x-zernio":["GET /v1/accounts/{accountId}/pinterest-boards"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":180},"description":{"type":["null","string"]},"privacy":{"type":"string","enum":["PUBLIC","PROTECTED","SECRET"],"default":"PUBLIC"},"url":{"type":["null","string"],"format":"uri","readOnly":true,"description":"Best-effort board URL"},"pin_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"collaborator_count":{"type":"integer","readOnly":true},"is_ads_only":{"type":"boolean","default":false},"image_cover_url":{"type":["null","string"],"format":"uri","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"board_pins_modified_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"pinterestBoardsCreate","summary":"Pinterest: Create a Boards item","tags":["Focus · Pinterest"],"description":"Create a board (SECRET needs boards:write_secret). Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: `/v1/accounts/{accountId}/focus/boards`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":180},"description":{"type":"string"},"privacy":{"type":"string","enum":["PUBLIC","PROTECTED","SECRET"],"default":"PUBLIC"},"is_ads_only":{"type":"boolean","default":false}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-boards-create","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/pinterest-boards"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":180},"description":{"type":["null","string"]},"privacy":{"type":"string","enum":["PUBLIC","PROTECTED","SECRET"],"default":"PUBLIC"},"url":{"type":["null","string"],"format":"uri","readOnly":true,"description":"Best-effort board URL"},"pin_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"collaborator_count":{"type":"integer","readOnly":true},"is_ads_only":{"type":"boolean","default":false},"image_cover_url":{"type":["null","string"],"format":"uri","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"board_pins_modified_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/boards/{itemId}":{"get":{"operationId":"pinterestBoardsGet","summary":"Pinterest: Get a Boards item","tags":["Focus · Pinterest"],"description":"Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: `/v1/accounts/{accountId}/focus/boards`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-boards-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":180},"description":{"type":["null","string"]},"privacy":{"type":"string","enum":["PUBLIC","PROTECTED","SECRET"],"default":"PUBLIC"},"url":{"type":["null","string"],"format":"uri","readOnly":true,"description":"Best-effort board URL"},"pin_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"collaborator_count":{"type":"integer","readOnly":true},"is_ads_only":{"type":"boolean","default":false},"image_cover_url":{"type":["null","string"],"format":"uri","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"board_pins_modified_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"pinterestBoardsUpdate","summary":"Pinterest: Update a Boards item","tags":["Focus · Pinterest"],"description":"Rename, describe or change privacy (PUBLIC / SECRET; needs boards:write_secret). Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: `/v1/accounts/{accountId}/focus/boards`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":180},"description":{"type":"string"},"privacy":{"type":"string","enum":["PUBLIC","SECRET"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-boards-update","x-zernio":["PUT /v1/accounts/{accountId}/pinterest-boards"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","maxLength":180},"description":{"type":["null","string"]},"privacy":{"type":"string","enum":["PUBLIC","PROTECTED","SECRET"],"default":"PUBLIC"},"url":{"type":["null","string"],"format":"uri","readOnly":true,"description":"Best-effort board URL"},"pin_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"collaborator_count":{"type":"integer","readOnly":true},"is_ads_only":{"type":"boolean","default":false},"image_cover_url":{"type":["null","string"],"format":"uri","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true},"board_pins_modified_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"pinterestBoardsDelete","summary":"Pinterest: Delete a Boards item","tags":["Focus · Pinterest"],"description":"Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: `/v1/accounts/{accountId}/focus/boards`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-boards-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/boards/{itemId}/set-default":{"post":{"operationId":"pinterestBoardsSetDefault","summary":"Pinterest: Set as default board (Boards)","tags":["Focus · Pinterest"],"description":"Default destination for Pins (Zernio PUT pinterest-boards). Returns `metadata` to persist on the account. Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: `/v1/accounts/{accountId}/focus/boards`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-boards-set-default","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/boards/{itemId}/pins":{"post":{"operationId":"pinterestBoardsPins","summary":"Pinterest: Pins on board (Boards)","tags":["Focus · Pinterest"],"description":"Pins on board. Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: `/v1/accounts/{accountId}/focus/boards`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Pagination cursor (Pinterest bookmark)"},"limit":{"type":"integer","minimum":1,"maximum":250,"default":25},"pin_metrics":{"type":"boolean"},"creative_types":{"type":"array","items":{"type":"string","enum":["REGULAR","VIDEO","SHOPPING","CAROUSEL","MAX_VIDEO","SHOP_THE_PIN","COLLECTION","IDEA","SHOWCASE","QUIZ","COLLAGE","MAX_WIDTH_REGULAR_COLLECTION","MAX_WIDTH_VIDEO_COLLECTION","APP"]}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-boards-pins","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/board-sections":{"get":{"operationId":"pinterestBoardSectionsList","summary":"Pinterest: List Board sections","tags":["Focus · Pinterest"],"description":"Sections inside a board. Ids are `<board_id>_<section_id>`. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: boards:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards/operation/board_sections/list Generic route: `/v1/accounts/{accountId}/focus/board-sections`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"board_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-board-sections-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"section_id":{"type":"string","readOnly":true},"board_id":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":180}},"required":["board_id","name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"pinterestBoardSectionsCreate","summary":"Pinterest: Create a Board sections item","tags":["Focus · Pinterest"],"description":"Sections inside a board. Ids are `<board_id>_<section_id>`. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards/operation/board_sections/list Generic route: `/v1/accounts/{accountId}/focus/board-sections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"board_id":{"type":"string"},"name":{"type":"string","maxLength":180}},"required":["board_id","name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-board-sections-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"section_id":{"type":"string","readOnly":true},"board_id":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":180}},"required":["board_id","name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/board-sections/{itemId}":{"patch":{"operationId":"pinterestBoardSectionsUpdate","summary":"Pinterest: Update a Board sections item","tags":["Focus · Pinterest"],"description":"Sections inside a board. Ids are `<board_id>_<section_id>`. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards/operation/board_sections/list Generic route: `/v1/accounts/{accountId}/focus/board-sections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":180}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-board-sections-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"section_id":{"type":"string","readOnly":true},"board_id":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":180}},"required":["board_id","name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"pinterestBoardSectionsDelete","summary":"Pinterest: Delete a Board sections item","tags":["Focus · Pinterest"],"description":"Sections inside a board. Ids are `<board_id>_<section_id>`. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards/operation/board_sections/list Generic route: `/v1/accounts/{accountId}/focus/board-sections`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-board-sections-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/board-sections/{itemId}/pins":{"post":{"operationId":"pinterestBoardSectionsPins","summary":"Pinterest: Pins in section (Board sections)","tags":["Focus · Pinterest"],"description":"Pins in section. Sections inside a board. Ids are `<board_id>_<section_id>`. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards/operation/board_sections/list Generic route: `/v1/accounts/{accountId}/focus/board-sections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Pagination cursor (Pinterest bookmark)"},"limit":{"type":"integer","minimum":1,"maximum":250,"default":25}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-board-sections-pins","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/pins":{"get":{"operationId":"pinterestPinsList","summary":"Pinterest: List Pins","tags":["Focus · Pinterest"],"description":"List Pins (all, by board/section, private, or search with q; search needs *_secret scopes). Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false,"description":"Search your Pins"},{"schema":{"type":"string"},"in":"query","name":"board_id","required":false},{"schema":{"type":"string"},"in":"query","name":"board_section_id","required":false},{"schema":{"type":"string","enum":["exclude_native","exclude_repins","has_been_promoted"]},"in":"query","name":"pin_filter","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["REGULAR","VIDEO","SHOPPING","CAROUSEL","MAX_VIDEO","SHOP_THE_PIN","COLLECTION","IDEA","SHOWCASE","QUIZ","COLLAGE","MAX_WIDTH_REGULAR_COLLECTION","MAX_WIDTH_VIDEO_COLLECTION","APP"]}},"in":"query","name":"creative_types","required":false},{"schema":{"type":"boolean"},"in":"query","name":"include_protected_pins","required":false},{"schema":{"type":"string","enum":["PRIVATE"]},"in":"query","name":"pin_type","required":false},{"schema":{"type":"array","items":{"type":"string"},"maxItems":100},"in":"query","name":"domains","required":false},{"schema":{"type":"boolean"},"in":"query","name":"pin_metrics","required":false,"description":"Include 90-day and lifetime metrics"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-pins-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":["null","string"],"maxLength":100},"description":{"type":["null","string"],"maxLength":800},"link":{"type":["null","string"],"format":"uri","maxLength":2048},"alt_text":{"type":["null","string"],"maxLength":500},"board_id":{"type":"string"},"board_section_id":{"type":["null","string"]},"dominant_color":{"type":["null","string"],"pattern":"^#[0-9A-Fa-f]{6}$"},"media_type":{"type":["null","string"],"enum":["image","video","multiple_images","multiple_videos","multiple_mixed",null],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"creative_type":{"type":["null","string"],"enum":["REGULAR","VIDEO","SHOPPING","CAROUSEL","MAX_VIDEO","SHOP_THE_PIN","COLLECTION","IDEA","SHOWCASE","QUIZ","COLLAGE","MAX_WIDTH_REGULAR_COLLECTION","MAX_WIDTH_VIDEO_COLLECTION","APP",null],"readOnly":true},"ai_disclosures":{"type":"array","items":{"type":"string","enum":["AI_MODIFIED","SYNTHETIC_PERFORMER"]}},"parent_pin_id":{"type":["null","string"]},"is_owner":{"type":"boolean","readOnly":true},"is_standard":{"type":"boolean","readOnly":true},"is_product":{"type":"boolean","readOnly":true},"has_been_promoted":{"type":"boolean","readOnly":true},"pin_metrics":{"type":["null","object"],"properties":{},"readOnly":true,"additionalProperties":true},"url":{"type":"string","format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"pinterestPinsCreate","summary":"Pinterest: Create a Pins item","tags":["Focus · Pinterest"],"description":"Publish a Pin now (Socialit schedules; Pinterest has no publish_at). Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"board_id":{"type":"string"},"board_section_id":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":800},"link":{"type":"string","format":"uri","maxLength":2048},"alt_text":{"type":"string","maxLength":500},"dominant_color":{"type":"string","pattern":"^#?[0-9A-Fa-f]{6}$"},"media_ids":{"type":"array","items":{"type":"string"},"maxItems":5,"description":"Socialit media: 1 image, 2-5 images (carousel) or 1 video (+ optional cover image)"},"image_urls":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":5},"video_url":{"type":"string","format":"uri"},"pinterest_media_id":{"type":"string","description":"Processed video from Video uploads"},"cover_image_url":{"type":"string","format":"uri"},"cover_image_key_frame_time":{"type":"integer","minimum":0},"carousel_items":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"link":{"type":"string","format":"uri"}}},"maxItems":5},"pin_type":{"type":"string","enum":["auto","image","carousel","video","product"],"default":"auto"},"is_affiliate_link":{"type":"boolean"},"is_ai_generated":{"type":"boolean"},"ai_disclosures":{"type":"array","items":{"type":"string","enum":["AI_MODIFIED","SYNTHETIC_PERFORMER"]}},"parent_pin_id":{"type":"string"},"is_standard":{"type":"boolean","default":true,"description":"false = simplified (idea-style) Pin, beta"}},"required":["board_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-pins-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":["null","string"],"maxLength":100},"description":{"type":["null","string"],"maxLength":800},"link":{"type":["null","string"],"format":"uri","maxLength":2048},"alt_text":{"type":["null","string"],"maxLength":500},"board_id":{"type":"string"},"board_section_id":{"type":["null","string"]},"dominant_color":{"type":["null","string"],"pattern":"^#[0-9A-Fa-f]{6}$"},"media_type":{"type":["null","string"],"enum":["image","video","multiple_images","multiple_videos","multiple_mixed",null],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"creative_type":{"type":["null","string"],"enum":["REGULAR","VIDEO","SHOPPING","CAROUSEL","MAX_VIDEO","SHOP_THE_PIN","COLLECTION","IDEA","SHOWCASE","QUIZ","COLLAGE","MAX_WIDTH_REGULAR_COLLECTION","MAX_WIDTH_VIDEO_COLLECTION","APP",null],"readOnly":true},"ai_disclosures":{"type":"array","items":{"type":"string","enum":["AI_MODIFIED","SYNTHETIC_PERFORMER"]}},"parent_pin_id":{"type":["null","string"]},"is_owner":{"type":"boolean","readOnly":true},"is_standard":{"type":"boolean","readOnly":true},"is_product":{"type":"boolean","readOnly":true},"has_been_promoted":{"type":"boolean","readOnly":true},"pin_metrics":{"type":["null","object"],"properties":{},"readOnly":true,"additionalProperties":true},"url":{"type":"string","format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/pins/{itemId}":{"get":{"operationId":"pinterestPinsGet","summary":"Pinterest: Get a Pins item","tags":["Focus · Pinterest"],"description":"Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"pin_metrics","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-pins-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":["null","string"],"maxLength":100},"description":{"type":["null","string"],"maxLength":800},"link":{"type":["null","string"],"format":"uri","maxLength":2048},"alt_text":{"type":["null","string"],"maxLength":500},"board_id":{"type":"string"},"board_section_id":{"type":["null","string"]},"dominant_color":{"type":["null","string"],"pattern":"^#[0-9A-Fa-f]{6}$"},"media_type":{"type":["null","string"],"enum":["image","video","multiple_images","multiple_videos","multiple_mixed",null],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"creative_type":{"type":["null","string"],"enum":["REGULAR","VIDEO","SHOPPING","CAROUSEL","MAX_VIDEO","SHOP_THE_PIN","COLLECTION","IDEA","SHOWCASE","QUIZ","COLLAGE","MAX_WIDTH_REGULAR_COLLECTION","MAX_WIDTH_VIDEO_COLLECTION","APP",null],"readOnly":true},"ai_disclosures":{"type":"array","items":{"type":"string","enum":["AI_MODIFIED","SYNTHETIC_PERFORMER"]}},"parent_pin_id":{"type":["null","string"]},"is_owner":{"type":"boolean","readOnly":true},"is_standard":{"type":"boolean","readOnly":true},"is_product":{"type":"boolean","readOnly":true},"has_been_promoted":{"type":"boolean","readOnly":true},"pin_metrics":{"type":["null","object"],"properties":{},"readOnly":true,"additionalProperties":true},"url":{"type":"string","format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"pinterestPinsUpdate","summary":"Pinterest: Update a Pins item","tags":["Focus · Pinterest"],"description":"Edit title, description, link, alt text, board/section, carousel slots, AI disclosure. Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":800},"link":{"type":"string","format":"uri","maxLength":2048},"alt_text":{"type":"string","maxLength":500},"board_id":{"type":"string"},"board_section_id":{"type":["string","null"]},"carousel_slots":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"link":{"type":"string","format":"uri"}}}},"ai_disclosures":{"type":"array","items":{"type":"string","enum":["AI_MODIFIED","SYNTHETIC_PERFORMER"]}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-pins-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":["null","string"],"maxLength":100},"description":{"type":["null","string"],"maxLength":800},"link":{"type":["null","string"],"format":"uri","maxLength":2048},"alt_text":{"type":["null","string"],"maxLength":500},"board_id":{"type":"string"},"board_section_id":{"type":["null","string"]},"dominant_color":{"type":["null","string"],"pattern":"^#[0-9A-Fa-f]{6}$"},"media_type":{"type":["null","string"],"enum":["image","video","multiple_images","multiple_videos","multiple_mixed",null],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"creative_type":{"type":["null","string"],"enum":["REGULAR","VIDEO","SHOPPING","CAROUSEL","MAX_VIDEO","SHOP_THE_PIN","COLLECTION","IDEA","SHOWCASE","QUIZ","COLLAGE","MAX_WIDTH_REGULAR_COLLECTION","MAX_WIDTH_VIDEO_COLLECTION","APP",null],"readOnly":true},"ai_disclosures":{"type":"array","items":{"type":"string","enum":["AI_MODIFIED","SYNTHETIC_PERFORMER"]}},"parent_pin_id":{"type":["null","string"]},"is_owner":{"type":"boolean","readOnly":true},"is_standard":{"type":"boolean","readOnly":true},"is_product":{"type":"boolean","readOnly":true},"has_been_promoted":{"type":"boolean","readOnly":true},"pin_metrics":{"type":["null","object"],"properties":{},"readOnly":true,"additionalProperties":true},"url":{"type":"string","format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"pinterestPinsDelete","summary":"Pinterest: Delete a Pins item","tags":["Focus · Pinterest"],"description":"Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-pins-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/pins/{itemId}/save":{"post":{"operationId":"pinterestPinsSave","summary":"Pinterest: Save to board (Pins)","tags":["Focus · Pinterest"],"description":"Save (repin) to a board or section. Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"board_id":{"type":"string"},"board_section_id":{"type":"string"}},"required":["board_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-pins-save","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/pins/{itemId}/move":{"post":{"operationId":"pinterestPinsMove","summary":"Pinterest: Move (Pins)","tags":["Focus · Pinterest"],"description":"Move to another board and/or section. Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"board_id":{"type":"string"},"board_section_id":{"type":["string","null"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-pins-move","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/pins/{itemId}/analytics":{"post":{"operationId":"pinterestPinsAnalytics","summary":"Pinterest: Analytics (Pins)","tags":["Focus · Pinterest"],"description":"Daily analytics for this Pin (90-day window). Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date"},"until":{"type":"string","format":"date"},"video":{"type":"boolean"},"split_field":{"type":"string","enum":["NO_SPLIT","APP_TYPE"]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-pins-analytics","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/pins/{itemId}/metrics":{"post":{"operationId":"pinterestPinsMetrics","summary":"Pinterest: Lifetime metrics (Pins)","tags":["Focus · Pinterest"],"description":"Lifetime metrics. Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: `/v1/accounts/{accountId}/focus/pins`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-pins-metrics","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/video-uploads":{"get":{"operationId":"pinterestVideoUploadsList","summary":"Pinterest: List Video uploads","tags":["Focus · Pinterest"],"description":"Pinterest video media uploads and their processing status. Use a succeeded media_id as pinterest_media_id when creating a Pin. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/media Generic route: `/v1/accounts/{accountId}/focus/video-uploads`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-video-uploads-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"media_id":{"type":"string","readOnly":true},"media_type":{"type":"string","enum":["video"],"readOnly":true},"status":{"type":"string","enum":["registered","processing","succeeded","failed"],"readOnly":true},"upload_url":{"type":["null","string"],"format":"uri","readOnly":true},"upload_parameters":{"type":["null","object"],"properties":{},"readOnly":true,"additionalProperties":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"pinterestVideoUploadsCreate","summary":"Pinterest: Create a Video uploads item","tags":["Focus · Pinterest"],"description":"Upload a video (from Socialit media or a URL), or register only to upload directly to S3. Pinterest video media uploads and their processing status. Use a succeeded media_id as pinterest_media_id when creating a Pin. Requires scopes: pins:read, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/media Generic route: `/v1/accounts/{accountId}/focus/video-uploads`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string","description":"Socialit media id of the video"},"url":{"type":"string","format":"uri"},"wait":{"type":"boolean","default":false,"description":"Wait until processing finishes"},"register_only":{"type":"boolean","default":false,"description":"Return upload_url + upload_parameters for a direct upload"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-video-uploads-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string","readOnly":true},"media_type":{"type":"string","enum":["video"],"readOnly":true},"status":{"type":"string","enum":["registered","processing","succeeded","failed"],"readOnly":true},"upload_url":{"type":["null","string"],"format":"uri","readOnly":true},"upload_parameters":{"type":["null","object"],"properties":{},"readOnly":true,"additionalProperties":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/video-uploads/{itemId}":{"get":{"operationId":"pinterestVideoUploadsGet","summary":"Pinterest: Get a Video uploads item","tags":["Focus · Pinterest"],"description":"Pinterest video media uploads and their processing status. Use a succeeded media_id as pinterest_media_id when creating a Pin. Requires scopes: pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/media Generic route: `/v1/accounts/{accountId}/focus/video-uploads`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-video-uploads-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string","readOnly":true},"media_type":{"type":"string","enum":["video"],"readOnly":true},"status":{"type":"string","enum":["registered","processing","succeeded","failed"],"readOnly":true},"upload_url":{"type":["null","string"],"format":"uri","readOnly":true},"upload_parameters":{"type":["null","object"],"properties":{},"readOnly":true,"additionalProperties":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/video-uploads/{itemId}/wait":{"post":{"operationId":"pinterestVideoUploadsWait","summary":"Pinterest: Wait for processing (Video uploads)","tags":["Focus · Pinterest"],"description":"Wait for processing. Pinterest video media uploads and their processing status. Use a succeeded media_id as pinterest_media_id when creating a Pin. Requires scopes: pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/media Generic route: `/v1/accounts/{accountId}/focus/video-uploads`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timeout_seconds":{"type":"integer","minimum":1,"maximum":300,"default":60}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-video-uploads-wait","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/product-tags":{"get":{"operationId":"pinterestProductTagsList","summary":"Pinterest: List Product tags","tags":["Focus · Pinterest"],"description":"Product Pins tagged onto a hero Pin (max 24 per request). Ids are `<hero_pin_id>_<product_pin_id>`. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/product_tags Generic route: `/v1/accounts/{accountId}/focus/product-tags`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"pin_id","required":true,"description":"Hero Pin id"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-product-tags-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"hero_pin_id":{"type":"string"},"pin_id":{"type":"string","description":"Product Pin id"}},"required":["hero_pin_id","pin_id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"pinterestProductTagsCreate","summary":"Pinterest: Create a Product tags item","tags":["Focus · Pinterest"],"description":"Product Pins tagged onto a hero Pin (max 24 per request). Ids are `<hero_pin_id>_<product_pin_id>`. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/product_tags Generic route: `/v1/accounts/{accountId}/focus/product-tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hero_pin_id":{"type":"string"},"product_pin_ids":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":24}},"required":["hero_pin_id","product_pin_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-product-tags-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"hero_pin_id":{"type":"string"},"pin_id":{"type":"string","description":"Product Pin id"}},"required":["hero_pin_id","pin_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/product-tags/{itemId}":{"delete":{"operationId":"pinterestProductTagsDelete","summary":"Pinterest: Delete a Product tags item","tags":["Focus · Pinterest"],"description":"Product Pins tagged onto a hero Pin (max 24 per request). Ids are `<hero_pin_id>_<product_pin_id>`. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/product_tags Generic route: `/v1/accounts/{accountId}/focus/product-tags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-product-tags-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/product-tags/remove-many":{"post":{"operationId":"pinterestProductTagsRemoveMany","summary":"Pinterest: Remove product tags (Product tags)","tags":["Focus · Pinterest"],"description":"Remove product tags. Product Pins tagged onto a hero Pin (max 24 per request). Ids are `<hero_pin_id>_<product_pin_id>`. Destructive. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/product_tags Generic route: `/v1/accounts/{accountId}/focus/product-tags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hero_pin_id":{"type":"string"},"product_pin_ids":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":24}},"required":["hero_pin_id","product_pin_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-product-tags-remove-many","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/account-analytics":{"get":{"operationId":"pinterestAccountAnalyticsGet","summary":"Pinterest: Get Account analytics","tags":["Focus · Pinterest"],"description":"Impressions, saves, Pin clicks, outbound clicks and engagement per day (90-day lookback), optionally split by app, source, owned content or Pin format. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_account/analytics Generic route: `/v1/accounts/{accountId}/focus/account-analytics`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Start date (UTC). Max 90 days back."},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"End date (UTC). Defaults to today."},{"schema":{"type":"string","enum":["OTHER","CLAIMED","BOTH"],"default":"BOTH"},"in":"query","name":"from_claimed_content","required":false},{"schema":{"type":"string","enum":["ALL","ORGANIC_IMAGE","ORGANIC_PRODUCT","ORGANIC_VIDEO","ADS_STANDARD","ADS_PRODUCT","ADS_VIDEO","ADS_IDEA"],"default":"ALL"},"in":"query","name":"pin_format","required":false},{"schema":{"type":"string","enum":["ALL","MOBILE","TABLET","WEB"],"default":"ALL"},"in":"query","name":"app_types","required":false},{"schema":{"type":"string","enum":["ALL","PAID","ORGANIC"],"default":"ALL"},"in":"query","name":"content_type","required":false},{"schema":{"type":"string","enum":["ALL","YOUR_PINS","OTHER_PINS"],"default":"ALL"},"in":"query","name":"source","required":false},{"schema":{"type":"string","enum":["NO_SPLIT","APP_TYPE","OWNED_CONTENT","SOURCE","PIN_FORMAT"],"default":"NO_SPLIT"},"in":"query","name":"split_field","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-account-analytics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"report":{"type":"string"},"window":{"type":"object","properties":{"start_date":{"type":"string","format":"date"},"end_date":{"type":"string","format":"date"},"clamped":{"type":"boolean"}}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"metrics":{"type":"object","properties":{"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"}}}}}},"totals":{"type":"object","properties":{"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"}}},"splits":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"metrics":{"type":"object","properties":{"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"}}}}}},"totals":{"type":"object","properties":{"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"}}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/top-pins":{"get":{"operationId":"pinterestTopPinsList","summary":"Pinterest: List Top Pins","tags":["Focus · Pinterest"],"description":"Top Pins (up to 50) by engagement, saves, impressions, outbound clicks or Pin clicks. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pins:read, user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_account/analytics/top_pins Generic route: `/v1/accounts/{accountId}/focus/top-pins`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Start date (UTC). Max 90 days back."},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"End date (UTC). Defaults to today."},{"schema":{"type":"string","enum":["OTHER","CLAIMED","BOTH"],"default":"BOTH"},"in":"query","name":"from_claimed_content","required":false},{"schema":{"type":"string","enum":["ALL","ORGANIC_IMAGE","ORGANIC_PRODUCT","ORGANIC_VIDEO","ADS_STANDARD","ADS_PRODUCT","ADS_VIDEO","ADS_IDEA"],"default":"ALL"},"in":"query","name":"pin_format","required":false},{"schema":{"type":"string","enum":["ALL","MOBILE","TABLET","WEB"],"default":"ALL"},"in":"query","name":"app_types","required":false},{"schema":{"type":"string","enum":["ALL","PAID","ORGANIC"],"default":"ALL"},"in":"query","name":"content_type","required":false},{"schema":{"type":"string","enum":["ALL","YOUR_PINS","OTHER_PINS"],"default":"ALL"},"in":"query","name":"source","required":false},{"schema":{"type":"string","enum":["ENGAGEMENT","SAVE","IMPRESSION","OUTBOUND_CLICK","PIN_CLICK"],"default":"IMPRESSION"},"in":"query","name":"sort_by","required":false},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"in":"query","name":"num_of_pins","required":false},{"schema":{"type":"integer","enum":[30]},"in":"query","name":"created_in_last_n_days","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"include_pins","required":false,"description":"Fetch title and image for each Pin"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-top-pins-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"rank":{"type":"integer"},"pin_id":{"type":"string"},"title":{"type":["null","string"]},"image_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"},"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"},"raw_metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/top-video-pins":{"get":{"operationId":"pinterestTopVideoPinsList","summary":"Pinterest: List Top video Pins","tags":["Focus · Pinterest"],"description":"Top video Pins (up to 50) with views, average watch time, total watch time, 95% views, 10-second views and starts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: pins:read, user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_account/analytics/top_video_pins Generic route: `/v1/accounts/{accountId}/focus/top-video-pins`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Start date (UTC). Max 90 days back."},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"End date (UTC). Defaults to today."},{"schema":{"type":"string","enum":["OTHER","CLAIMED","BOTH"],"default":"BOTH"},"in":"query","name":"from_claimed_content","required":false},{"schema":{"type":"string","enum":["ALL","ORGANIC_IMAGE","ORGANIC_PRODUCT","ORGANIC_VIDEO","ADS_STANDARD","ADS_PRODUCT","ADS_VIDEO","ADS_IDEA"],"default":"ALL"},"in":"query","name":"pin_format","required":false},{"schema":{"type":"string","enum":["ALL","MOBILE","TABLET","WEB"],"default":"ALL"},"in":"query","name":"app_types","required":false},{"schema":{"type":"string","enum":["ALL","PAID","ORGANIC"],"default":"ALL"},"in":"query","name":"content_type","required":false},{"schema":{"type":"string","enum":["ALL","YOUR_PINS","OTHER_PINS"],"default":"ALL"},"in":"query","name":"source","required":false},{"schema":{"type":"string","enum":["SAVE","IMPRESSION","OUTBOUND_CLICK","VIDEO_MRC_VIEW","VIDEO_AVG_WATCH_TIME","VIDEO_V50_WATCH_TIME","QUARTILE_95_PERCENT_VIEW","VIDEO_10S_VIEW","VIDEO_START"],"default":"IMPRESSION"},"in":"query","name":"sort_by","required":false},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"in":"query","name":"num_of_pins","required":false},{"schema":{"type":"integer","enum":[30]},"in":"query","name":"created_in_last_n_days","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"include_pins","required":false,"description":"Fetch title and image for each Pin"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-top-video-pins-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"rank":{"type":"integer"},"pin_id":{"type":"string"},"title":{"type":["null","string"]},"image_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"},"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"},"raw_metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/pin-analytics":{"get":{"operationId":"pinterestPinAnalyticsGet","summary":"Pinterest: Get Pin analytics","tags":["Focus · Pinterest"],"description":"Daily metrics for one Pin (90-day window), including video metrics and an APP_TYPE split. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/pins/analytics Generic route: `/v1/accounts/{accountId}/focus/pin-analytics`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"pin_id","required":true},{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Start date (UTC). Max 90 days back."},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"End date (UTC). Defaults to today."},{"schema":{"type":"boolean"},"in":"query","name":"video","required":false,"description":"Request video metrics"},{"schema":{"type":"string","enum":["NO_SPLIT","APP_TYPE"]},"in":"query","name":"split_field","required":false},{"schema":{"type":"string","enum":["ALL","MOBILE","TABLET","WEB"]},"in":"query","name":"app_types","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-pin-analytics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"report":{"type":"string"},"pin_id":{"type":"string"},"window":{"type":"object","properties":{"start_date":{"type":"string","format":"date"},"end_date":{"type":"string","format":"date"},"clamped":{"type":"boolean"}}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"metrics":{"type":"object","properties":{"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"}}}}}},"totals":{"type":"object","properties":{"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/video-analytics":{"get":{"operationId":"pinterestVideoAnalyticsGet","summary":"Pinterest: Get Video analytics","tags":["Focus · Pinterest"],"description":"Organic video Pin performance per day plus the top video Pins and their combined video metrics. Requires scopes: pins:read, user_accounts:read. Generic route: `/v1/accounts/{accountId}/focus/video-analytics`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"Start date (UTC). Max 90 days back."},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"End date (UTC). Defaults to today."},{"schema":{"type":"string","enum":["SAVE","IMPRESSION","OUTBOUND_CLICK","VIDEO_MRC_VIEW","VIDEO_AVG_WATCH_TIME","VIDEO_V50_WATCH_TIME","QUARTILE_95_PERCENT_VIEW","VIDEO_10S_VIEW","VIDEO_START"],"default":"VIDEO_MRC_VIEW"},"in":"query","name":"sort_by","required":false},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"num_of_pins","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-video-analytics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"report":{"type":"string"},"window":{"type":"object","properties":{"start_date":{"type":"string","format":"date"},"end_date":{"type":"string","format":"date"},"clamped":{"type":"boolean"}}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"metrics":{"type":"object","properties":{"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"}}}}}},"totals":{"type":"object","properties":{"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"}}},"top_video_totals":{"type":"object","properties":{"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"}}},"top_video_pins":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"pin_id":{"type":"string"},"metrics":{"type":"object","properties":{"impressions":{"type":"number"},"saves":{"type":"number"},"pin_clicks":{"type":"number"},"outbound_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"},"comments":{"type":"number"},"likes":{"type":"number"},"profile_views":{"type":"number"},"follower_change":{"type":"number"},"views":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"}}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/audience-insights":{"get":{"operationId":"pinterestAudienceInsightsGet","summary":"Pinterest: Get Audience insights","tags":["Focus · Pinterest"],"description":"Audience age, gender, country, metro, device and interest distribution (via the linked ad account; needs ads:read). Requires scopes: ads:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/audience_insights/get Generic route: `/v1/accounts/{accountId}/focus/audience-insights`.","parameters":[{"schema":{"type":"string","enum":["YOUR_TOTAL_AUDIENCE","YOUR_ENGAGED_AUDIENCE","PINTEREST_TOTAL_AUDIENCE"],"default":"YOUR_TOTAL_AUDIENCE"},"in":"query","name":"audience_insight_type","required":false},{"schema":{"type":"string"},"in":"query","name":"ad_account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-audience-insights-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"audience_type":{"type":"string","enum":["YOUR_TOTAL_AUDIENCE","YOUR_ENGAGED_AUDIENCE","PINTEREST_TOTAL_AUDIENCE"]},"ad_account_id":{"type":"string"},"total":{"type":["null","integer"]},"size_is_upper_bound":{"type":["null","boolean"]},"date":{"type":["null","string"],"format":"date"},"ages":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":["null","string"]},"value":{"type":"number","description":"Share of audience 0..1"}}}},"genders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":["null","string"]},"value":{"type":"number","description":"Share of audience 0..1"}}}},"countries":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":["null","string"]},"value":{"type":"number","description":"Share of audience 0..1"}}}},"metros":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":["null","string"]},"value":{"type":"number","description":"Share of audience 0..1"}}}},"devices":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":["null","string"]},"value":{"type":"number","description":"Share of audience 0..1"}}}},"interests":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":["null","string"]},"value":{"type":"number"},"index":{"type":["null","number"]}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/trending-keywords":{"get":{"operationId":"pinterestTrendingKeywordsList","summary":"Pinterest: List Trending keywords","tags":["Focus · Pinterest"],"description":"Top growing, monthly, yearly or seasonal search keywords by region, with optional demographic filters. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/trending_keywords/list Generic route: `/v1/accounts/{accountId}/focus/trending-keywords`.","parameters":[{"schema":{"type":"string","enum":["US","CA","DE","FR","ES","IT","DE+AT+CH","GB+IE","IT+ES+PT+GR+MT","PL+RO+HU+SK+CZ","SE+DK+FI+NO","NL+BE+LU","AR","BR","CO","MX","MX+AR+CO+CL","AU+NZ"],"default":"US"},"in":"query","name":"region","required":true},{"schema":{"type":"string","enum":["growing","monthly","yearly","seasonal"],"default":"growing"},"in":"query","name":"trend_type","required":true},{"schema":{"type":"array","items":{"type":"string","enum":["animals","architecture","art","beauty","childrens_fashion","design","diy_and_crafts","education","electronics","entertainment","event_planning","finance","food_and_drinks","gardening","health","home_decor","mens_fashion","parenting","quotes","sport","travel","vehicles","wedding","womens_fashion"]}},"in":"query","name":"interests","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["male","female","unknown"]}},"in":"query","name":"genders","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["18-24","25-34","35-44","45-49","50-54","55-64","65+"]}},"in":"query","name":"ages","required":false},{"schema":{"type":"array","items":{"type":"string"},"maxItems":50},"in":"query","name":"include_keywords","required":false},{"schema":{"type":"boolean"},"in":"query","name":"normalize_against_group","required":false},{"schema":{"type":"boolean"},"in":"query","name":"include_demographics","required":false},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-trending-keywords-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string","readOnly":true},"pct_growth_wow":{"type":["null","integer"]},"pct_growth_mom":{"type":["null","integer"]},"pct_growth_yoy":{"type":["null","integer"]},"time_series":{"type":["null","object"],"properties":{},"additionalProperties":{"type":"number"}},"demographics":{"type":["null","object"],"properties":{},"additionalProperties":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/featured-topics":{"get":{"operationId":"pinterestFeaturedTopicsList","summary":"Pinterest: List Featured trends","tags":["Focus · Pinterest"],"description":"Editorially featured trending topics per interest, with related searches and example Pins. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/trends_featured_topics/list Generic route: `/v1/accounts/{accountId}/focus/featured-topics`.","parameters":[{"schema":{"type":"string","enum":["US","GB+IE","CA"],"default":"US"},"in":"query","name":"region","required":true},{"schema":{"type":"string","enum":["ALL","ANIMALS","ARCHITECTURE","ART","BEAUTY","DIY_AND_CRAFTS","EDUCATION","EVENT_PLANNING","FASHION","FOOD_AND_DRINKS","GARDENING","HEALTH","HOME_DECOR","PARENTING","TRAVEL","WEDDING"]},"in":"query","name":"interest","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-featured-topics-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"interest":{"type":"string","enum":["ALL","ANIMALS","ARCHITECTURE","ART","BEAUTY","DIY_AND_CRAFTS","EDUCATION","EVENT_PLANNING","FASHION","FOOD_AND_DRINKS","GARDENING","HEALTH","HOME_DECOR","PARENTING","TRAVEL","WEDDING"],"readOnly":true},"percent_growth_mom":{"type":["null","integer"]},"related_searches":{"type":"array","items":{"type":"string"}},"related_interests":{"type":"array","items":{"type":"string"}},"pins":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"time_series":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/editorial-articles":{"get":{"operationId":"pinterestEditorialArticlesList","summary":"Pinterest: List Editorial articles","tags":["Focus · Pinterest"],"description":"Pinterest editorial trend articles with their boards, Pins and related keywords. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/trends_editorial_articles/list Generic route: `/v1/accounts/{accountId}/focus/editorial-articles`.","parameters":[{"schema":{"type":"string","enum":["US","GB+IE","CA"],"default":"US"},"in":"query","name":"region","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-editorial-articles-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"board_url":{"type":"string","format":"uri","readOnly":true},"pins_url":{"type":"array","items":{"type":"string","format":"uri"}},"interests":{"type":"array","items":{"type":"string"}},"related_keywords":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/trending-product-categories":{"get":{"operationId":"pinterestTrendingProductCategoriesList","summary":"Pinterest: List Trending shopping categories","tags":["Focus · Pinterest"],"description":"Trending shopping product categories by region, vertical and demographic. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/trends_product_categories_trending/list Generic route: `/v1/accounts/{accountId}/focus/trending-product-categories`.","parameters":[{"schema":{"type":"string","enum":["US","GB+IE","CA"],"default":"US"},"in":"query","name":"region","required":true},{"schema":{"type":"array","items":{"type":"string","enum":["FASHION","HOME_DECOR","BEAUTY"]}},"in":"query","name":"verticals","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["18-24","25-34","35-44","45-49","50-54","55-64","65+"]}},"in":"query","name":"ages","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["MALE","FEMALE","UNSPECIFIED"]}},"in":"query","name":"genders","required":false},{"schema":{"type":"string","enum":["ENGAGEMENT","OUTBOUND_CLICK","SAVE"],"default":"ENGAGEMENT"},"in":"query","name":"engagement_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-trending-product-categories-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"pinterest_product_category_id":{"type":"integer","readOnly":true},"product_category":{"type":"string","readOnly":true},"verticals":{"type":"array","items":{"type":"string"}},"engagement_type":{"type":"string","enum":["ENGAGEMENT","OUTBOUND_CLICK","SAVE"]},"pct_change_mom":{"type":"integer"},"percent_relative_volume":{"type":"integer"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/trending-product-categories/details":{"post":{"operationId":"pinterestTrendingProductCategoriesDetails","summary":"Pinterest: Category details (Trending shopping categories)","tags":["Focus · Pinterest"],"description":"Category details. Trending shopping product categories by region, vertical and demographic. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/trends_product_categories_trending/list Generic route: `/v1/accounts/{accountId}/focus/trending-product-categories`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_categories":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"region":{"type":"string","enum":["US","GB+IE","CA"],"default":"US"},"lookback_window":{"type":"integer","enum":[90,180,365,730],"default":365},"engagement_type":{"type":"string","enum":["ENGAGEMENT","OUTBOUND_CLICK","SAVE"]}},"required":["product_categories","region"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-trending-product-categories-details","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/ad-accounts":{"get":{"operationId":"pinterestAdAccountsList","summary":"Pinterest: List Ad accounts (Business Access)","tags":["Focus · Pinterest"],"description":"Ad accounts this user can access. \"Act as\" makes Socialit call Pinterest with ad_account_id so you manage the client profile behind it. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: ads:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/ad_accounts/list Generic route: `/v1/accounts/{accountId}/focus/ad-accounts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"include_shared_accounts","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-ad-accounts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"country":{"type":["null","string"],"readOnly":true},"currency":{"type":["null","string"],"readOnly":true},"time_zone":{"type":["null","string"],"readOnly":true},"owner":{"type":["null","object"],"properties":{"id":{"type":"string"},"username":{"type":"string"}},"readOnly":true},"permissions":{"type":"array","items":{"type":"string"},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/ad-accounts/{itemId}/act-as":{"post":{"operationId":"pinterestAdAccountsActAs","summary":"Pinterest: Act as this profile (Ad accounts (Business Access))","tags":["Focus · Pinterest"],"description":"Returns `metadata` (operatingAdAccountId) to persist on the account. Ad accounts this user can access. \"Act as\" makes Socialit call Pinterest with ad_account_id so you manage the client profile behind it. Requires scopes: ads:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/ad_accounts/list Generic route: `/v1/accounts/{accountId}/focus/ad-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-ad-accounts-act-as","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/ad-accounts/stop-acting":{"post":{"operationId":"pinterestAdAccountsStopActing","summary":"Pinterest: Stop acting as a client (Ad accounts (Business Access))","tags":["Focus · Pinterest"],"description":"Stop acting as a client. Ad accounts this user can access. \"Act as\" makes Socialit call Pinterest with ad_account_id so you manage the client profile behind it. Requires scopes: ads:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/ad_accounts/list Generic route: `/v1/accounts/{accountId}/focus/ad-accounts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-ad-accounts-stop-acting","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/businesses":{"get":{"operationId":"pinterestBusinessesList","summary":"Pinterest: List Businesses","tags":["Focus · Pinterest"],"description":"Businesses this user is a member of (Business Access employers). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: biz_access:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_employers Generic route: `/v1/accounts/{accountId}/focus/businesses`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-businesses-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"business_roles":{"type":"array","items":{"type":"string"},"readOnly":true},"created_by_business":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"created_by_user":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"created_time":{"type":["null","integer"],"readOnly":true},"user":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"is_shared_partner":{"type":["null","boolean"],"readOnly":true},"assets_summary":{"type":["null","object"],"properties":{},"additionalProperties":true,"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/business-members":{"get":{"operationId":"pinterestBusinessMembersList","summary":"Pinterest: List Business members","tags":["Focus · Pinterest"],"description":"Members of a business and their role. Ids are `<business_id>_<member_id>`. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: biz_access:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_members Generic route: `/v1/accounts/{accountId}/focus/business-members`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"business_id","required":true},{"schema":{"type":"array","items":{"type":"string","enum":["EMPLOYEE","BIZ_ADMIN"]}},"in":"query","name":"business_roles","required":false},{"schema":{"type":"boolean"},"in":"query","name":"assets_summary","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-business-members-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"business_roles":{"type":"array","items":{"type":"string"},"readOnly":true},"created_by_business":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"created_by_user":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"created_time":{"type":["null","integer"],"readOnly":true},"user":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"is_shared_partner":{"type":["null","boolean"],"readOnly":true},"assets_summary":{"type":["null","object"],"properties":{},"additionalProperties":true,"readOnly":true},"member_id":{"type":"string","readOnly":true},"business_id":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/business-members/{itemId}":{"patch":{"operationId":"pinterestBusinessMembersUpdate","summary":"Pinterest: Update a Business members item","tags":["Focus · Pinterest"],"description":"Change the member role. Members of a business and their role. Ids are `<business_id>_<member_id>`. Requires scopes: biz_access:read, biz_access:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_members Generic route: `/v1/accounts/{accountId}/focus/business-members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"business_role":{"type":"string","enum":["EMPLOYEE","BIZ_ADMIN"]}},"required":["business_role"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-business-members-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"business_roles":{"type":"array","items":{"type":"string"},"readOnly":true},"created_by_business":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"created_by_user":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"created_time":{"type":["null","integer"],"readOnly":true},"user":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"is_shared_partner":{"type":["null","boolean"],"readOnly":true},"assets_summary":{"type":["null","object"],"properties":{},"additionalProperties":true,"readOnly":true},"member_id":{"type":"string","readOnly":true},"business_id":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"pinterestBusinessMembersDelete","summary":"Pinterest: Delete a Business members item","tags":["Focus · Pinterest"],"description":"Members of a business and their role. Ids are `<business_id>_<member_id>`. Requires scopes: biz_access:read, biz_access:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_members Generic route: `/v1/accounts/{accountId}/focus/business-members`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-business-members-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/business-partners":{"get":{"operationId":"pinterestBusinessPartnersList","summary":"Pinterest: List Business partners","tags":["Focus · Pinterest"],"description":"Partner businesses with access to (or sharing) assets. Ids are `<business_id>_<partner_id>`. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: biz_access:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_partners Generic route: `/v1/accounts/{accountId}/focus/business-partners`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"business_id","required":true},{"schema":{"type":"string","enum":["INTERNAL","EXTERNAL"]},"in":"query","name":"partner_type","required":false},{"schema":{"type":"boolean"},"in":"query","name":"assets_summary","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-business-partners-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"business_roles":{"type":"array","items":{"type":"string"},"readOnly":true},"created_by_business":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"created_by_user":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"created_time":{"type":["null","integer"],"readOnly":true},"user":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"is_shared_partner":{"type":["null","boolean"],"readOnly":true},"assets_summary":{"type":["null","object"],"properties":{},"additionalProperties":true,"readOnly":true},"partner_id":{"type":"string","readOnly":true},"business_id":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/business-partners/{itemId}":{"delete":{"operationId":"pinterestBusinessPartnersDelete","summary":"Pinterest: Delete a Business partners item","tags":["Focus · Pinterest"],"description":"Partner businesses with access to (or sharing) assets. Ids are `<business_id>_<partner_id>`. Requires scopes: biz_access:read, biz_access:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_partners Generic route: `/v1/accounts/{accountId}/focus/business-partners`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-business-partners-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/business-assets":{"get":{"operationId":"pinterestBusinessAssetsList","summary":"Pinterest: List Business assets","tags":["Focus · Pinterest"],"description":"Profiles, ad accounts, asset groups and catalogs owned by or shared with a business. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: biz_access:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/business_assets/get Generic route: `/v1/accounts/{accountId}/focus/business-assets`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"business_id","required":true},{"schema":{"type":"string","enum":["AD_ACCOUNT","PROFILE","ASSET_GROUP","CATALOG","CONSUMER"],"default":"AD_ACCOUNT"},"in":"query","name":"asset_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-business-assets-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","readOnly":true},"asset_type":{"type":"string","enum":["AD_ACCOUNT","PROFILE","ASSET_GROUP","CATALOG","CONSUMER"],"readOnly":true},"permissions":{"type":"array","items":{"type":"string"},"readOnly":true},"asset_group_info":{"type":["null","object"],"properties":{},"additionalProperties":true},"catalog_info":{"type":["null","object"],"properties":{},"additionalProperties":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/business-invites":{"get":{"operationId":"pinterestBusinessInvitesList","summary":"Pinterest: List Business invites","tags":["Focus · Pinterest"],"description":"Pending member/partner invites and partner access requests. Ids are `<business_id>_<invite_id>`. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: biz_access:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/invites Generic route: `/v1/accounts/{accountId}/focus/business-invites`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Pinterest bookmark)"},{"schema":{"type":"integer","minimum":1,"maximum":250,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"business_id","required":true},{"schema":{"type":"string","enum":["MEMBER_INVITE","PARTNER_INVITE","PARTNER_REQUEST"]},"in":"query","name":"invite_type","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["PENDING","EXPIRED"]}},"in":"query","name":"invite_status","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"is_member","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-business-invites-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"invite_id":{"type":"string","readOnly":true},"business_id":{"type":"string","readOnly":true},"business_roles":{"type":"array","items":{"type":"string"},"readOnly":true},"user":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"invite_data":{"type":["null","object"],"properties":{"invite_status":{"type":"string"},"invite_type":{"type":"string"},"invite_expiration":{"type":"integer"},"sent_at":{"type":"integer"}},"readOnly":true},"is_received_invite":{"type":["null","boolean"],"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"pinterestBusinessInvitesCreate","summary":"Pinterest: Create a Business invites item","tags":["Focus · Pinterest"],"description":"Invite members (usernames/emails) or partners, or request partner access. Pending member/partner invites and partner access requests. Ids are `<business_id>_<invite_id>`. Requires scopes: biz_access:read, biz_access:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/invites Generic route: `/v1/accounts/{accountId}/focus/business-invites`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"business_id":{"type":"string"},"business_role":{"type":"string","enum":["EMPLOYEE","BIZ_ADMIN","PARTNER"]},"invite_type":{"type":"string","enum":["MEMBER_INVITE","PARTNER_INVITE","PARTNER_REQUEST"]},"members":{"type":"array","items":{"type":"string"},"maxItems":50},"partners":{"type":"array","items":{"type":"string"},"maxItems":50}},"required":["business_id","business_role","invite_type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-business-invites-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"invite_id":{"type":"string","readOnly":true},"business_id":{"type":"string","readOnly":true},"business_roles":{"type":"array","items":{"type":"string"},"readOnly":true},"user":{"type":["null","object"],"properties":{"id":{"type":["null","string"]},"username":{"type":["null","string"]},"email":{"type":["null","string"]}}},"invite_data":{"type":["null","object"],"properties":{"invite_status":{"type":"string"},"invite_type":{"type":"string"},"invite_expiration":{"type":"integer"},"sent_at":{"type":"integer"}},"readOnly":true},"is_received_invite":{"type":["null","boolean"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/pinterest/business-invites/{itemId}":{"delete":{"operationId":"pinterestBusinessInvitesDelete","summary":"Pinterest: Delete a Business invites item","tags":["Focus · Pinterest"],"description":"Pending member/partner invites and partner access requests. Ids are `<business_id>_<invite_id>`. Requires scopes: biz_access:read, biz_access:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/invites Generic route: `/v1/accounts/{accountId}/focus/business-invites`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_pinterest","x-mcp-tool":"pinterest-business-invites-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/profile":{"get":{"operationId":"redditProfileGet","summary":"Reddit: Get Profile","tags":["Focus · Reddit"],"description":"GET /api/v1/me. Your Reddit account: karma, followers, account age and inbox state. Requires scopes: identity. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"t2_ fullname"},"username":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"link_karma":{"type":"integer"},"comment_karma":{"type":"integer"},"total_karma":{"type":"integer"},"awarder_karma":{"type":["null","integer"]},"awardee_karma":{"type":["null","integer"]},"icon_url":{"type":["null","string"],"format":"uri"},"snoovatar_url":{"type":["null","string"],"format":"uri"},"followers":{"type":["null","integer"],"description":"Profile followers"},"profile_title":{"type":["null","string"]},"profile_description":{"type":["null","string"]},"over_18":{"type":["null","boolean"]},"is_mod":{"type":["null","boolean"]},"has_verified_email":{"type":["null","boolean"]},"is_suspended":{"type":["null","boolean"]},"accept_followers":{"type":["null","boolean"]},"inbox_count":{"type":["null","integer"]},"has_mail":{"type":["null","boolean"]},"has_mod_mail":{"type":["null","boolean"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/preferences":{"get":{"operationId":"redditPreferencesGet","summary":"Reddit: Get Preferences","tags":["Focus · Reddit"],"description":"GET /api/v1/me/prefs. Account preferences (privacy, content, messaging). Email and password are never exposed. Requires scopes: identity. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/preferences`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-preferences-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"lang":{"type":"string","description":"Interface language (e.g. en)"},"over_18":{"type":"boolean","description":"I am over 18 and willing to view adult content"},"search_include_over_18":{"type":"boolean"},"label_nsfw":{"type":"boolean"},"hide_from_robots":{"type":"boolean","description":"Hide profile from search engines"},"show_presence":{"type":"boolean","description":"Show online status"},"enable_followers":{"type":"boolean","description":"Allow people to follow you"},"accept_pms":{"type":"string","enum":["everyone","whitelisted"]},"show_location_based_recommendations":{"type":"boolean"},"activity_relevant_ads":{"type":"boolean"},"third_party_data_personalized_ads":{"type":"boolean"},"third_party_site_data_personalized_ads":{"type":"boolean"},"third_party_site_data_personalized_content":{"type":"boolean"},"allow_clicktracking":{"type":"boolean"},"media":{"type":"string","enum":["on","off","subreddit"]},"media_preview":{"type":"string","enum":["on","off","subreddit"]},"nightmode":{"type":"boolean"},"default_comment_sort":{"type":"string","enum":["confidence","top","new","controversial","old","random","qa","live"]},"ignore_suggested_sort":{"type":"boolean"},"send_welcome_messages":{"type":"boolean"},"email_messages":{"type":"boolean"},"email_unsubscribe_all":{"type":"boolean"},"feed_recommendations_enabled":{"type":"boolean"},"top_karma_subreddits":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"redditPreferencesUpdate","summary":"Reddit: Update Preferences","tags":["Focus · Reddit"],"description":"PATCH /api/v1/me/prefs. Account preferences (privacy, content, messaging). Email and password are never exposed. Requires scopes: identity, account. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/preferences`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lang":{"type":"string","description":"Interface language (e.g. en)"},"over_18":{"type":"boolean","description":"I am over 18 and willing to view adult content"},"search_include_over_18":{"type":"boolean"},"label_nsfw":{"type":"boolean"},"hide_from_robots":{"type":"boolean","description":"Hide profile from search engines"},"show_presence":{"type":"boolean","description":"Show online status"},"enable_followers":{"type":"boolean","description":"Allow people to follow you"},"accept_pms":{"type":"string","enum":["everyone","whitelisted"]},"show_location_based_recommendations":{"type":"boolean"},"activity_relevant_ads":{"type":"boolean"},"third_party_data_personalized_ads":{"type":"boolean"},"third_party_site_data_personalized_ads":{"type":"boolean"},"third_party_site_data_personalized_content":{"type":"boolean"},"allow_clicktracking":{"type":"boolean"},"media":{"type":"string","enum":["on","off","subreddit"]},"media_preview":{"type":"string","enum":["on","off","subreddit"]},"nightmode":{"type":"boolean"},"default_comment_sort":{"type":"string","enum":["confidence","top","new","controversial","old","random","qa","live"]},"ignore_suggested_sort":{"type":"boolean"},"send_welcome_messages":{"type":"boolean"},"email_messages":{"type":"boolean"},"email_unsubscribe_all":{"type":"boolean"},"feed_recommendations_enabled":{"type":"boolean"},"top_karma_subreddits":{"type":"boolean"}},"additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-preferences-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"lang":{"type":"string","description":"Interface language (e.g. en)"},"over_18":{"type":"boolean","description":"I am over 18 and willing to view adult content"},"search_include_over_18":{"type":"boolean"},"label_nsfw":{"type":"boolean"},"hide_from_robots":{"type":"boolean","description":"Hide profile from search engines"},"show_presence":{"type":"boolean","description":"Show online status"},"enable_followers":{"type":"boolean","description":"Allow people to follow you"},"accept_pms":{"type":"string","enum":["everyone","whitelisted"]},"show_location_based_recommendations":{"type":"boolean"},"activity_relevant_ads":{"type":"boolean"},"third_party_data_personalized_ads":{"type":"boolean"},"third_party_site_data_personalized_ads":{"type":"boolean"},"third_party_site_data_personalized_content":{"type":"boolean"},"allow_clicktracking":{"type":"boolean"},"media":{"type":"string","enum":["on","off","subreddit"]},"media_preview":{"type":"string","enum":["on","off","subreddit"]},"nightmode":{"type":"boolean"},"default_comment_sort":{"type":"string","enum":["confidence","top","new","controversial","old","random","qa","live"]},"ignore_suggested_sort":{"type":"boolean"},"send_welcome_messages":{"type":"boolean"},"email_messages":{"type":"boolean"},"email_unsubscribe_all":{"type":"boolean"},"feed_recommendations_enabled":{"type":"boolean"},"top_karma_subreddits":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/trophies":{"get":{"operationId":"redditTrophiesList","summary":"Reddit: List Trophies","tags":["Focus · Reddit"],"description":"GET /api/v1/me/trophies. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: identity. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/trophies`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-trophies-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":["null","string"]},"icon_url":{"type":["null","string"],"format":"uri"},"granted_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/friends":{"get":{"operationId":"redditFriendsList","summary":"Reddit: List Followed users","tags":["Focus · Reddit"],"description":"GET /api/v1/me/friends. Users you follow (Reddit \"friends\"). Following must be a human action. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/friends`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-friends-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"username"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditFriendsCreate","summary":"Reddit: Create a Followed users item","tags":["Focus · Reddit"],"description":"PUT /api/v1/me/friends/{username}. Users you follow (Reddit \"friends\"). Following must be a human action. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/friends`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","minLength":1}},"required":["username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-friends-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"username"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/friends/{itemId}":{"delete":{"operationId":"redditFriendsDelete","summary":"Reddit: Delete a Followed users item","tags":["Focus · Reddit"],"description":"DELETE /api/v1/me/friends/{username}. Users you follow (Reddit \"friends\"). Following must be a human action. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/friends`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-friends-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/blocked-users":{"get":{"operationId":"redditBlockedUsersList","summary":"Reddit: List Blocked users","tags":["Focus · Reddit"],"description":"GET /prefs/blocked. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/blocked-users`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-blocked-users-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"username"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditBlockedUsersCreate","summary":"Reddit: Create a Blocked users item","tags":["Focus · Reddit"],"description":"POST /api/block_user (approved OAuth apps only). Requires scopes: read, account. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/blocked-users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","minLength":1}},"required":["username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-blocked-users-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"username"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/blocked-users/{itemId}":{"delete":{"operationId":"redditBlockedUsersDelete","summary":"Reddit: Delete a Blocked users item","tags":["Focus · Reddit"],"description":"POST /r/all/api/unfriend type=enemy (scope unverified). Requires scopes: read, account. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/blocked-users`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-blocked-users-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts":{"get":{"operationId":"redditMyPostsList","summary":"Reddit: List My posts","tags":["Focus · Reddit"],"description":"GET /user/{me}/submitted. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["new","hot","top","controversial"],"default":"new"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"]},"in":"query","name":"t","required":false,"description":"Time filter for top/controversial"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-list","x-zernio":["GET /v1/accounts/{accountId}/posts","GET /v1/inbox/comments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t3_ fullname"},"short_id":{"type":"string"},"title":{"type":"string","maxLength":300},"text":{"type":"string","description":"Markdown body (self posts)"},"url":{"type":["null","string"],"format":"uri"},"permalink":{"type":"string","format":"uri"},"subreddit":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"upvote_ratio":{"type":["null","number"],"minimum":0,"maximum":1},"num_comments":{"type":"integer"},"num_crossposts":{"type":"integer"},"awards":{"type":"integer"},"view_count":{"type":["null","integer"]},"kind":{"type":"string","enum":["self","link","image","video","gallery","poll","crosspost"]},"domain":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"flair_text":{"type":["null","string"]},"flair_template_id":{"type":["null","string"]},"over_18":{"type":"boolean"},"spoiler":{"type":"boolean"},"locked":{"type":"boolean"},"stickied":{"type":"boolean"},"archived":{"type":"boolean"},"distinguished":{"type":["null","string"]},"send_replies":{"type":["null","boolean"]},"saved":{"type":"boolean"},"hidden":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed_by_category":{"type":["null","string"]},"num_reports":{"type":["null","integer"]},"poll":{"type":["null","object"],"properties":{"total_votes":{"type":["null","integer"]},"ends_at":{"type":["null","string"],"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"votes":{"type":["null","integer"]}}}}}},"gallery":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":"string"},"caption":{"type":["null","string"]},"outbound_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"video_url":{"type":["null","string"],"format":"uri"}},"required":["id","title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditMyPostsCreate","summary":"Reddit: Create a My posts item","tags":["Focus · Reddit"],"description":"Publish now (POST /api/submit | submit_gallery_post | submit_poll_post). Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"title":{"type":"string","minLength":1,"maxLength":300},"text":{"type":"string","description":"Markdown body. Use {media1}… placeholders to position inline media."},"kind":{"type":"string","enum":["auto","self","link","image","video","videogif","gallery","poll","crosspost"],"default":"auto"},"url":{"type":"string","format":"uri","description":"Link post URL"},"media":{"type":"array","items":{"type":"string"},"maxItems":20},"flairId":{"type":"string","maxLength":36},"flairText":{"type":"string","maxLength":64},"nsfw":{"type":"boolean","default":false},"spoiler":{"type":"boolean","default":false},"sendReplies":{"type":"boolean","default":true},"videogif":{"type":"boolean"},"nativeVideo":{"type":"boolean","default":true},"bodyWithMedia":{"type":"string","enum":["inline","comment","drop"],"default":"inline"},"poll":{"type":"object","properties":{"options":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":6},"duration":{"type":"integer","minimum":1,"maximum":7,"default":3}}},"crosspostOf":{"type":"string","description":"t3_ id or permalink"},"collectionId":{"type":"string"},"firstComment":{"type":"string"},"firstCommentSticky":{"type":"boolean"}},"required":["subreddit","title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-create","x-idempotent":true,"x-zernio":["POST /v1/posts/{postId}/edit","POST /v1/posts/{postId}/unpublish","POST /v1/accounts/{accountId}/reddit-flairs"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"t3_ fullname"},"short_id":{"type":"string"},"title":{"type":"string","maxLength":300},"text":{"type":"string","description":"Markdown body (self posts)"},"url":{"type":["null","string"],"format":"uri"},"permalink":{"type":"string","format":"uri"},"subreddit":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"upvote_ratio":{"type":["null","number"],"minimum":0,"maximum":1},"num_comments":{"type":"integer"},"num_crossposts":{"type":"integer"},"awards":{"type":"integer"},"view_count":{"type":["null","integer"]},"kind":{"type":"string","enum":["self","link","image","video","gallery","poll","crosspost"]},"domain":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"flair_text":{"type":["null","string"]},"flair_template_id":{"type":["null","string"]},"over_18":{"type":"boolean"},"spoiler":{"type":"boolean"},"locked":{"type":"boolean"},"stickied":{"type":"boolean"},"archived":{"type":"boolean"},"distinguished":{"type":["null","string"]},"send_replies":{"type":["null","boolean"]},"saved":{"type":"boolean"},"hidden":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed_by_category":{"type":["null","string"]},"num_reports":{"type":["null","integer"]},"poll":{"type":["null","object"],"properties":{"total_votes":{"type":["null","integer"]},"ends_at":{"type":["null","string"],"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"votes":{"type":["null","integer"]}}}}}},"gallery":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":"string"},"caption":{"type":["null","string"]},"outbound_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"video_url":{"type":["null","string"],"format":"uri"}},"required":["id","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}":{"get":{"operationId":"redditMyPostsGet","summary":"Reddit: Get a My posts item","tags":["Focus · Reddit"],"description":"GET /api/info. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"t3_ fullname"},"short_id":{"type":"string"},"title":{"type":"string","maxLength":300},"text":{"type":"string","description":"Markdown body (self posts)"},"url":{"type":["null","string"],"format":"uri"},"permalink":{"type":"string","format":"uri"},"subreddit":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"upvote_ratio":{"type":["null","number"],"minimum":0,"maximum":1},"num_comments":{"type":"integer"},"num_crossposts":{"type":"integer"},"awards":{"type":"integer"},"view_count":{"type":["null","integer"]},"kind":{"type":"string","enum":["self","link","image","video","gallery","poll","crosspost"]},"domain":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"flair_text":{"type":["null","string"]},"flair_template_id":{"type":["null","string"]},"over_18":{"type":"boolean"},"spoiler":{"type":"boolean"},"locked":{"type":"boolean"},"stickied":{"type":"boolean"},"archived":{"type":"boolean"},"distinguished":{"type":["null","string"]},"send_replies":{"type":["null","boolean"]},"saved":{"type":"boolean"},"hidden":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed_by_category":{"type":["null","string"]},"num_reports":{"type":["null","integer"]},"poll":{"type":["null","object"],"properties":{"total_votes":{"type":["null","integer"]},"ends_at":{"type":["null","string"],"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"votes":{"type":["null","integer"]}}}}}},"gallery":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":"string"},"caption":{"type":["null","string"]},"outbound_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"video_url":{"type":["null","string"],"format":"uri"}},"required":["id","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"redditMyPostsUpdate","summary":"Reddit: Update a My posts item","tags":["Focus · Reddit"],"description":"POST /api/editusertext (+ flags/flair). Titles cannot be edited. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"nsfw":{"type":"boolean"},"spoiler":{"type":"boolean"},"sendReplies":{"type":"boolean"},"flairId":{"type":"string"},"flairText":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"t3_ fullname"},"short_id":{"type":"string"},"title":{"type":"string","maxLength":300},"text":{"type":"string","description":"Markdown body (self posts)"},"url":{"type":["null","string"],"format":"uri"},"permalink":{"type":"string","format":"uri"},"subreddit":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"upvote_ratio":{"type":["null","number"],"minimum":0,"maximum":1},"num_comments":{"type":"integer"},"num_crossposts":{"type":"integer"},"awards":{"type":"integer"},"view_count":{"type":["null","integer"]},"kind":{"type":"string","enum":["self","link","image","video","gallery","poll","crosspost"]},"domain":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"flair_text":{"type":["null","string"]},"flair_template_id":{"type":["null","string"]},"over_18":{"type":"boolean"},"spoiler":{"type":"boolean"},"locked":{"type":"boolean"},"stickied":{"type":"boolean"},"archived":{"type":"boolean"},"distinguished":{"type":["null","string"]},"send_replies":{"type":["null","boolean"]},"saved":{"type":"boolean"},"hidden":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed_by_category":{"type":["null","string"]},"num_reports":{"type":["null","integer"]},"poll":{"type":["null","object"],"properties":{"total_votes":{"type":["null","integer"]},"ends_at":{"type":["null","string"],"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"votes":{"type":["null","integer"]}}}}}},"gallery":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":"string"},"caption":{"type":["null","string"]},"outbound_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"video_url":{"type":["null","string"],"format":"uri"}},"required":["id","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditMyPostsDelete","summary":"Reddit: Delete a My posts item","tags":["Focus · Reddit"],"description":"POST /api/del. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/set-flair":{"post":{"operationId":"redditMyPostsSetFlair","summary":"Reddit: Set flair (My posts)","tags":["Focus · Reddit"],"description":"Set flair. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, flair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"flairTemplateId":{"type":"string"},"text":{"type":"string","maxLength":64},"subreddit":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-set-flair","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/toggle-replies":{"post":{"operationId":"redditMyPostsToggleReplies","summary":"Reddit: Inbox replies on/off (My posts)","tags":["Focus · Reddit"],"description":"Inbox replies on/off. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"boolean"}},"required":["state"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-toggle-replies","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/comment":{"post":{"operationId":"redditMyPostsComment","summary":"Reddit: Add comment (My posts)","tags":["Focus · Reddit"],"description":"Add comment. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-comment","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/reconcile":{"post":{"operationId":"redditMyPostsReconcile","summary":"Reddit: Find processed media post (My posts)","tags":["Focus · Reddit"],"description":"Resolve an image/video post whose processing outlived publish() (title + subreddit + submittedAt). Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"subreddit":{"type":"string"},"submittedAt":{"type":"string","format":"date-time"}},"required":["title","subreddit"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-reconcile","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/vote":{"post":{"operationId":"redditMyPostsVote","summary":"Reddit: Vote (My posts)","tags":["Focus · Reddit"],"description":"Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"direction":{"type":"integer","enum":[1,0,-1]}},"required":["direction"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-vote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/save":{"post":{"operationId":"redditMyPostsSave","summary":"Reddit: Save (My posts)","tags":["Focus · Reddit"],"description":"Save. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"Saved category (Reddit Premium)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-save","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/unsave":{"post":{"operationId":"redditMyPostsUnsave","summary":"Reddit: Unsave (My posts)","tags":["Focus · Reddit"],"description":"Unsave. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-unsave","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/report":{"post":{"operationId":"redditMyPostsReport","summary":"Reddit: Report (My posts)","tags":["Focus · Reddit"],"description":"Report. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":100,"description":"Reason text"},"rule_reason":{"type":"string","description":"Subreddit rule short_name"},"site_reason":{"type":"string","description":"Site-wide rule"},"custom_text":{"type":"string","maxLength":2000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-report","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/hide":{"post":{"operationId":"redditMyPostsHide","summary":"Reddit: Hide (My posts)","tags":["Focus · Reddit"],"description":"Hide. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/unhide":{"post":{"operationId":"redditMyPostsUnhide","summary":"Reddit: Unhide (My posts)","tags":["Focus · Reddit"],"description":"Unhide. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-unhide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/follow":{"post":{"operationId":"redditMyPostsFollow","summary":"Reddit: Follow post (My posts)","tags":["Focus · Reddit"],"description":"Follow post. Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"follow":{"type":"boolean","default":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-posts/{itemId}/crosspost":{"post":{"operationId":"redditMyPostsCrosspost","summary":"Reddit: Crosspost (My posts)","tags":["Focus · Reddit"],"description":"Crosspost to one subreddit (customise the title; no mass cross-posting). Posts you submitted. Compose new posts, edit text bodies, toggle flags and flair, delete. Requires scopes: history, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"title":{"type":"string","maxLength":300},"nsfw":{"type":"boolean"},"spoiler":{"type":"boolean"},"flairId":{"type":"string"},"flairText":{"type":"string"},"sendReplies":{"type":"boolean","default":true}},"required":["subreddit","title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-posts-crosspost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-comments":{"get":{"operationId":"redditMyCommentsList","summary":"Reddit: List My comments","tags":["Focus · Reddit"],"description":"GET /user/{me}/comments. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-comments`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["new","hot","top","controversial"],"default":"new"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"]},"in":"query","name":"t","required":false,"description":"Time filter for top/controversial"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-comments-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t1_ fullname"},"text":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"like_count":{"type":"integer"},"parent_id":{"type":"string","description":"t3_ (top level) or t1_ parent"},"post_id":{"type":"string"},"post_title":{"type":["null","string"]},"subreddit":{"type":"string"},"permalink":{"type":"string","format":"uri"},"depth":{"type":"integer","minimum":0},"replies_count":{"type":"integer"},"is_submitter":{"type":"boolean"},"is_own":{"type":["null","boolean"]},"distinguished":{"type":["null","string"]},"stickied":{"type":"boolean"},"locked":{"type":"boolean"},"saved":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed":{"type":"boolean"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-comments/{itemId}":{"patch":{"operationId":"redditMyCommentsUpdate","summary":"Reddit: Update a My comments item","tags":["Focus · Reddit"],"description":"POST /api/editusertext. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-comments-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"t1_ fullname"},"text":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"like_count":{"type":"integer"},"parent_id":{"type":"string","description":"t3_ (top level) or t1_ parent"},"post_id":{"type":"string"},"post_title":{"type":["null","string"]},"subreddit":{"type":"string"},"permalink":{"type":"string","format":"uri"},"depth":{"type":"integer","minimum":0},"replies_count":{"type":"integer"},"is_submitter":{"type":"boolean"},"is_own":{"type":["null","boolean"]},"distinguished":{"type":["null","string"]},"stickied":{"type":"boolean"},"locked":{"type":"boolean"},"saved":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed":{"type":"boolean"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditMyCommentsDelete","summary":"Reddit: Delete a My comments item","tags":["Focus · Reddit"],"description":"POST /api/del. Requires scopes: history, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-comments-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-comments/{itemId}/pin":{"post":{"operationId":"redditMyCommentsPin","summary":"Reddit: Pin (sticky as moderator) (My comments)","tags":["Focus · Reddit"],"description":"Pin (sticky as moderator). Requires scopes: history, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pin":{"type":"boolean","default":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-comments-pin","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-comments/{itemId}/vote":{"post":{"operationId":"redditMyCommentsVote","summary":"Reddit: Vote (My comments)","tags":["Focus · Reddit"],"description":"Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Requires scopes: history, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"direction":{"type":"integer","enum":[1,0,-1]}},"required":["direction"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-comments-vote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-comments/{itemId}/save":{"post":{"operationId":"redditMyCommentsSave","summary":"Reddit: Save (My comments)","tags":["Focus · Reddit"],"description":"Save. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"Saved category (Reddit Premium)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-comments-save","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-comments/{itemId}/unsave":{"post":{"operationId":"redditMyCommentsUnsave","summary":"Reddit: Unsave (My comments)","tags":["Focus · Reddit"],"description":"Unsave. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-comments-unsave","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-comments/{itemId}/report":{"post":{"operationId":"redditMyCommentsReport","summary":"Reddit: Report (My comments)","tags":["Focus · Reddit"],"description":"Report. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":100,"description":"Reason text"},"rule_reason":{"type":"string","description":"Subreddit rule short_name"},"site_reason":{"type":"string","description":"Site-wide rule"},"custom_text":{"type":"string","maxLength":2000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-comments-report","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/saved":{"get":{"operationId":"redditSavedList","summary":"Reddit: List Saved","tags":["Focus · Reddit"],"description":"GET /user/{me}/saved. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/saved`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["links","comments"]},"in":"query","name":"type","required":false},{"schema":{"type":"string"},"in":"query","name":"category","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-saved-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t1_ fullname"},"short_id":{"type":"string"},"title":{"type":"string","maxLength":300},"text":{"type":"string"},"url":{"type":["null","string"],"format":"uri"},"permalink":{"type":"string","format":"uri"},"subreddit":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"upvote_ratio":{"type":["null","number"],"minimum":0,"maximum":1},"num_comments":{"type":"integer"},"num_crossposts":{"type":"integer"},"awards":{"type":"integer"},"view_count":{"type":["null","integer"]},"kind":{"type":"string","enum":["post","comment"]},"domain":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"flair_text":{"type":["null","string"]},"flair_template_id":{"type":["null","string"]},"over_18":{"type":"boolean"},"spoiler":{"type":"boolean"},"locked":{"type":"boolean"},"stickied":{"type":"boolean"},"archived":{"type":"boolean"},"distinguished":{"type":["null","string"]},"send_replies":{"type":["null","boolean"]},"saved":{"type":"boolean"},"hidden":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed_by_category":{"type":["null","string"]},"num_reports":{"type":["null","integer"]},"poll":{"type":["null","object"],"properties":{"total_votes":{"type":["null","integer"]},"ends_at":{"type":["null","string"],"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"votes":{"type":["null","integer"]}}}}}},"gallery":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":"string"},"caption":{"type":["null","string"]},"outbound_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"video_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"parent_id":{"type":"string","description":"t3_ (top level) or t1_ parent"},"post_id":{"type":"string"},"post_title":{"type":["null","string"]},"depth":{"type":"integer","minimum":0},"replies_count":{"type":"integer"},"is_submitter":{"type":"boolean"},"is_own":{"type":["null","boolean"]},"removed":{"type":"boolean"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/saved/{itemId}":{"delete":{"operationId":"redditSavedDelete","summary":"Reddit: Delete a Saved item","tags":["Focus · Reddit"],"description":"POST /api/unsave. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/saved`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-saved-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/saved/categories":{"post":{"operationId":"redditSavedCategories","summary":"Reddit: Saved categories (Saved)","tags":["Focus · Reddit"],"description":"Saved categories. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/saved`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-saved-categories","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/saved/save":{"post":{"operationId":"redditSavedSave","summary":"Reddit: Save item (Saved)","tags":["Focus · Reddit"],"description":"Save item. Requires scopes: history, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/saved`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"category":{"type":"string"}},"required":["id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-saved-save","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/hidden":{"get":{"operationId":"redditHiddenList","summary":"Reddit: List Hidden posts","tags":["Focus · Reddit"],"description":"GET /user/{me}/hidden. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/hidden`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-hidden-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t3_ fullname"},"short_id":{"type":"string"},"title":{"type":"string","maxLength":300},"text":{"type":"string","description":"Markdown body (self posts)"},"url":{"type":["null","string"],"format":"uri"},"permalink":{"type":"string","format":"uri"},"subreddit":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"upvote_ratio":{"type":["null","number"],"minimum":0,"maximum":1},"num_comments":{"type":"integer"},"num_crossposts":{"type":"integer"},"awards":{"type":"integer"},"view_count":{"type":["null","integer"]},"kind":{"type":"string","enum":["self","link","image","video","gallery","poll","crosspost"]},"domain":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"flair_text":{"type":["null","string"]},"flair_template_id":{"type":["null","string"]},"over_18":{"type":"boolean"},"spoiler":{"type":"boolean"},"locked":{"type":"boolean"},"stickied":{"type":"boolean"},"archived":{"type":"boolean"},"distinguished":{"type":["null","string"]},"send_replies":{"type":["null","boolean"]},"saved":{"type":"boolean"},"hidden":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed_by_category":{"type":["null","string"]},"num_reports":{"type":["null","integer"]},"poll":{"type":["null","object"],"properties":{"total_votes":{"type":["null","integer"]},"ends_at":{"type":["null","string"],"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"votes":{"type":["null","integer"]}}}}}},"gallery":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":"string"},"caption":{"type":["null","string"]},"outbound_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"video_url":{"type":["null","string"],"format":"uri"}},"required":["id","title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/hidden/{itemId}":{"delete":{"operationId":"redditHiddenDelete","summary":"Reddit: Delete a Hidden posts item","tags":["Focus · Reddit"],"description":"POST /api/unhide. Requires scopes: history, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/hidden`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-hidden-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/voted":{"get":{"operationId":"redditVotedList","summary":"Reddit: List Voted","tags":["Focus · Reddit"],"description":"GET /user/{me}/upvoted | downvoted. Posts you upvoted or downvoted. Removing an item clears your vote (human action). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/voted`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["up","down"],"default":"up"},"in":"query","name":"direction","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-voted-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t3_ fullname"},"short_id":{"type":"string"},"title":{"type":"string","maxLength":300},"text":{"type":"string","description":"Markdown body (self posts)"},"url":{"type":["null","string"],"format":"uri"},"permalink":{"type":"string","format":"uri"},"subreddit":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"upvote_ratio":{"type":["null","number"],"minimum":0,"maximum":1},"num_comments":{"type":"integer"},"num_crossposts":{"type":"integer"},"awards":{"type":"integer"},"view_count":{"type":["null","integer"]},"kind":{"type":"string","enum":["self","link","image","video","gallery","poll","crosspost"]},"domain":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"flair_text":{"type":["null","string"]},"flair_template_id":{"type":["null","string"]},"over_18":{"type":"boolean"},"spoiler":{"type":"boolean"},"locked":{"type":"boolean"},"stickied":{"type":"boolean"},"archived":{"type":"boolean"},"distinguished":{"type":["null","string"]},"send_replies":{"type":["null","boolean"]},"saved":{"type":"boolean"},"hidden":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed_by_category":{"type":["null","string"]},"num_reports":{"type":["null","integer"]},"poll":{"type":["null","object"],"properties":{"total_votes":{"type":["null","integer"]},"ends_at":{"type":["null","string"],"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"votes":{"type":["null","integer"]}}}}}},"gallery":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":"string"},"caption":{"type":["null","string"]},"outbound_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"video_url":{"type":["null","string"],"format":"uri"}},"required":["id","title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/voted/{itemId}":{"delete":{"operationId":"redditVotedDelete","summary":"Reddit: Delete a Voted item","tags":["Focus · Reddit"],"description":"POST /api/vote dir=0. Posts you upvoted or downvoted. Removing an item clears your vote (human action). Requires scopes: history, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/voted`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-voted-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/overview":{"get":{"operationId":"redditOverviewList","summary":"Reddit: List Activity overview","tags":["Focus · Reddit"],"description":"GET /user/{me}/overview. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/overview`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["new","hot","top","controversial"],"default":"new"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"]},"in":"query","name":"t","required":false,"description":"Time filter for top/controversial"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-overview-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t1_ fullname"},"short_id":{"type":"string"},"title":{"type":"string","maxLength":300},"text":{"type":"string"},"url":{"type":["null","string"],"format":"uri"},"permalink":{"type":"string","format":"uri"},"subreddit":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"upvote_ratio":{"type":["null","number"],"minimum":0,"maximum":1},"num_comments":{"type":"integer"},"num_crossposts":{"type":"integer"},"awards":{"type":"integer"},"view_count":{"type":["null","integer"]},"kind":{"type":"string","enum":["post","comment"]},"domain":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"flair_text":{"type":["null","string"]},"flair_template_id":{"type":["null","string"]},"over_18":{"type":"boolean"},"spoiler":{"type":"boolean"},"locked":{"type":"boolean"},"stickied":{"type":"boolean"},"archived":{"type":"boolean"},"distinguished":{"type":["null","string"]},"send_replies":{"type":["null","boolean"]},"saved":{"type":"boolean"},"hidden":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed_by_category":{"type":["null","string"]},"num_reports":{"type":["null","integer"]},"poll":{"type":["null","object"],"properties":{"total_votes":{"type":["null","integer"]},"ends_at":{"type":["null","string"],"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"votes":{"type":["null","integer"]}}}}}},"gallery":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":"string"},"caption":{"type":["null","string"]},"outbound_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"video_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"parent_id":{"type":"string","description":"t3_ (top level) or t1_ parent"},"post_id":{"type":"string"},"post_title":{"type":["null","string"]},"depth":{"type":"integer","minimum":0},"replies_count":{"type":"integer"},"is_submitter":{"type":"boolean"},"is_own":{"type":["null","boolean"]},"removed":{"type":"boolean"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-subreddits":{"get":{"operationId":"redditMySubredditsList","summary":"Reddit: List My subreddits","tags":["Focus · Reddit"],"description":"GET /subreddits/mine/{where}. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-subreddits`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["postable","subscriber","moderator","contributor","streams"],"default":"postable"},"in":"query","name":"where","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-subreddits-list","x-zernio":["GET /v1/accounts/{accountId}/reddit-subreddits"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"],"description":"t5_ fullname"},"name":{"type":"string"},"prefixed_name":{"type":"string"},"title":{"type":["null","string"]},"description":{"type":["null","string"]},"subscribers":{"type":["null","integer"]},"active_users":{"type":["null","integer"]},"type":{"type":["null","string"],"enum":["public","private","restricted","gold_restricted","archived","employees_only","gold_only","user",null]},"over_18":{"type":"boolean"},"submission_type":{"type":"string","enum":["any","link","self"]},"post_types":{"type":"object","properties":{"self":{"type":"boolean"},"link":{"type":"boolean"},"image":{"type":"boolean"},"video":{"type":"boolean"},"gallery":{"type":"boolean"},"videogif":{"type":"boolean"},"poll":{"type":"boolean"},"crosspost":{"type":"boolean"}}},"spoilers_enabled":{"type":"boolean"},"link_flair_enabled":{"type":"boolean"},"restrict_posting":{"type":"boolean"},"user_is_subscriber":{"type":"boolean"},"user_is_moderator":{"type":"boolean"},"user_is_contributor":{"type":"boolean"},"user_is_banned":{"type":"boolean"},"icon_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditMySubredditsCreate","summary":"Reddit: Create a My subreddits item","tags":["Focus · Reddit"],"description":"POST /api/subscribe action=sub. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-subreddits`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1}},"required":["subreddit"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-subreddits-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":["null","string"],"description":"t5_ fullname"},"name":{"type":"string"},"prefixed_name":{"type":"string"},"title":{"type":["null","string"]},"description":{"type":["null","string"]},"subscribers":{"type":["null","integer"]},"active_users":{"type":["null","integer"]},"type":{"type":["null","string"],"enum":["public","private","restricted","gold_restricted","archived","employees_only","gold_only","user",null]},"over_18":{"type":"boolean"},"submission_type":{"type":"string","enum":["any","link","self"]},"post_types":{"type":"object","properties":{"self":{"type":"boolean"},"link":{"type":"boolean"},"image":{"type":"boolean"},"video":{"type":"boolean"},"gallery":{"type":"boolean"},"videogif":{"type":"boolean"},"poll":{"type":"boolean"},"crosspost":{"type":"boolean"}}},"spoilers_enabled":{"type":"boolean"},"link_flair_enabled":{"type":"boolean"},"restrict_posting":{"type":"boolean"},"user_is_subscriber":{"type":"boolean"},"user_is_moderator":{"type":"boolean"},"user_is_contributor":{"type":"boolean"},"user_is_banned":{"type":"boolean"},"icon_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-subreddits/{itemId}":{"get":{"operationId":"redditMySubredditsGet","summary":"Reddit: Get a My subreddits item","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits, read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-subreddits`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-subreddits-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":["null","string"],"description":"t5_ fullname"},"name":{"type":"string"},"prefixed_name":{"type":"string"},"title":{"type":["null","string"]},"description":{"type":["null","string"]},"subscribers":{"type":["null","integer"]},"active_users":{"type":["null","integer"]},"type":{"type":["null","string"],"enum":["public","private","restricted","gold_restricted","archived","employees_only","gold_only","user",null]},"over_18":{"type":"boolean"},"submission_type":{"type":"string","enum":["any","link","self"]},"post_types":{"type":"object","properties":{"self":{"type":"boolean"},"link":{"type":"boolean"},"image":{"type":"boolean"},"video":{"type":"boolean"},"gallery":{"type":"boolean"},"videogif":{"type":"boolean"},"poll":{"type":"boolean"},"crosspost":{"type":"boolean"}}},"spoilers_enabled":{"type":"boolean"},"link_flair_enabled":{"type":"boolean"},"restrict_posting":{"type":"boolean"},"user_is_subscriber":{"type":"boolean"},"user_is_moderator":{"type":"boolean"},"user_is_contributor":{"type":"boolean"},"user_is_banned":{"type":"boolean"},"icon_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditMySubredditsDelete","summary":"Reddit: Delete a My subreddits item","tags":["Focus · Reddit"],"description":"POST /api/subscribe action=unsub. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-subreddits`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-subreddits-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/my-subreddits/{itemId}/set-default":{"post":{"operationId":"redditMySubredditsSetDefault","summary":"Reddit: Set as default subreddit (My subreddits)","tags":["Focus · Reddit"],"description":"Returns { metadata: { defaultSubreddit } } for the API to persist on the account. Subreddits you subscribe to, moderate or are approved in; choose the default posting subreddit. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/my-subreddits`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-my-subreddits-set-default","x-idempotent":true,"x-zernio":["PUT /v1/accounts/{accountId}/reddit-subreddits"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddits":{"get":{"operationId":"redditSubredditsList","summary":"Reddit: List Subreddit browser","tags":["Focus · Reddit"],"description":"GET /subreddits/search | /subreddits/{popular,new,default}. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddits`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false,"description":"Search text (otherwise browse `where`)"},{"schema":{"type":"string","enum":["popular","new","default","gold"],"default":"popular"},"in":"query","name":"where","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"include_nsfw","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddits-list","x-zernio":["GET /v1/tools/validate/subreddit"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"],"description":"t5_ fullname"},"name":{"type":"string"},"prefixed_name":{"type":"string"},"title":{"type":["null","string"]},"description":{"type":["null","string"]},"subscribers":{"type":["null","integer"]},"active_users":{"type":["null","integer"]},"type":{"type":["null","string"],"enum":["public","private","restricted","gold_restricted","archived","employees_only","gold_only","user",null]},"over_18":{"type":"boolean"},"submission_type":{"type":"string","enum":["any","link","self"]},"post_types":{"type":"object","properties":{"self":{"type":"boolean"},"link":{"type":"boolean"},"image":{"type":"boolean"},"video":{"type":"boolean"},"gallery":{"type":"boolean"},"videogif":{"type":"boolean"},"poll":{"type":"boolean"},"crosspost":{"type":"boolean"}}},"spoilers_enabled":{"type":"boolean"},"link_flair_enabled":{"type":"boolean"},"restrict_posting":{"type":"boolean"},"user_is_subscriber":{"type":"boolean"},"user_is_moderator":{"type":"boolean"},"user_is_contributor":{"type":"boolean"},"user_is_banned":{"type":"boolean"},"icon_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddits/{itemId}":{"get":{"operationId":"redditSubredditsGet","summary":"Reddit: Get a Subreddit browser item","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about + /about/rules (validate subreddit). Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddits`.","parameters":[{"schema":{"type":"boolean","default":false},"in":"query","name":"include_requirements","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddits-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":["null","string"],"description":"t5_ fullname"},"name":{"type":"string"},"prefixed_name":{"type":"string"},"title":{"type":["null","string"]},"description":{"type":["null","string"]},"subscribers":{"type":["null","integer"]},"active_users":{"type":["null","integer"]},"type":{"type":["null","string"],"enum":["public","private","restricted","gold_restricted","archived","employees_only","gold_only","user",null]},"over_18":{"type":"boolean"},"submission_type":{"type":"string","enum":["any","link","self"]},"post_types":{"type":"object","properties":{"self":{"type":"boolean"},"link":{"type":"boolean"},"image":{"type":"boolean"},"video":{"type":"boolean"},"gallery":{"type":"boolean"},"videogif":{"type":"boolean"},"poll":{"type":"boolean"},"crosspost":{"type":"boolean"}}},"spoilers_enabled":{"type":"boolean"},"link_flair_enabled":{"type":"boolean"},"restrict_posting":{"type":"boolean"},"user_is_subscriber":{"type":"boolean"},"user_is_moderator":{"type":"boolean"},"user_is_contributor":{"type":"boolean"},"user_is_banned":{"type":"boolean"},"icon_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddits/{itemId}/subscribe":{"post":{"operationId":"redditSubredditsSubscribe","summary":"Reddit: Subscribe (Subreddit browser)","tags":["Focus · Reddit"],"description":"Subscribe. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddits`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddits-subscribe","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddits/{itemId}/unsubscribe":{"post":{"operationId":"redditSubredditsUnsubscribe","summary":"Reddit: Unsubscribe (Subreddit browser)","tags":["Focus · Reddit"],"description":"Unsubscribe. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddits`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddits-unsubscribe","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddits/{itemId}/requirements":{"post":{"operationId":"redditSubredditsRequirements","summary":"Reddit: Posting requirements (Subreddit browser)","tags":["Focus · Reddit"],"description":"Posting requirements. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddits`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddits-requirements","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddits/{itemId}/submit-text":{"post":{"operationId":"redditSubredditsSubmitText","summary":"Reddit: Submission guidelines (Subreddit browser)","tags":["Focus · Reddit"],"description":"Submission guidelines. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddits`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddits-submit-text","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddits/{itemId}/sidebar":{"post":{"operationId":"redditSubredditsSidebar","summary":"Reddit: Sidebar (Subreddit browser)","tags":["Focus · Reddit"],"description":"Sidebar. Search and browse communities; open one to see its posting rules, allowed post types and requirements. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddits`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddits-sidebar","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}":{"get":{"operationId":"redditFeedGet","summary":"Reddit: Get a Subreddit feed item","tags":["Focus · Reddit"],"description":"GET /api/info. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"t3_ fullname"},"short_id":{"type":"string"},"title":{"type":"string","maxLength":300},"text":{"type":"string","description":"Markdown body (self posts)"},"url":{"type":["null","string"],"format":"uri"},"permalink":{"type":"string","format":"uri"},"subreddit":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"upvote_ratio":{"type":["null","number"],"minimum":0,"maximum":1},"num_comments":{"type":"integer"},"num_crossposts":{"type":"integer"},"awards":{"type":"integer"},"view_count":{"type":["null","integer"]},"kind":{"type":"string","enum":["self","link","image","video","gallery","poll","crosspost"]},"domain":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"flair_text":{"type":["null","string"]},"flair_template_id":{"type":["null","string"]},"over_18":{"type":"boolean"},"spoiler":{"type":"boolean"},"locked":{"type":"boolean"},"stickied":{"type":"boolean"},"archived":{"type":"boolean"},"distinguished":{"type":["null","string"]},"send_replies":{"type":["null","boolean"]},"saved":{"type":"boolean"},"hidden":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed_by_category":{"type":["null","string"]},"num_reports":{"type":["null","integer"]},"poll":{"type":["null","object"],"properties":{"total_votes":{"type":["null","integer"]},"ends_at":{"type":["null","string"],"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"votes":{"type":["null","integer"]}}}}}},"gallery":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":"string"},"caption":{"type":["null","string"]},"outbound_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"video_url":{"type":["null","string"],"format":"uri"}},"required":["id","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/vote":{"post":{"operationId":"redditFeedVote","summary":"Reddit: Vote (Subreddit feed)","tags":["Focus · Reddit"],"description":"Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"direction":{"type":"integer","enum":[1,0,-1]}},"required":["direction"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-vote","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/reddit-vote"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/save":{"post":{"operationId":"redditFeedSave","summary":"Reddit: Save (Subreddit feed)","tags":["Focus · Reddit"],"description":"Save. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"Saved category (Reddit Premium)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-save","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/unsave":{"post":{"operationId":"redditFeedUnsave","summary":"Reddit: Unsave (Subreddit feed)","tags":["Focus · Reddit"],"description":"Unsave. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-unsave","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/report":{"post":{"operationId":"redditFeedReport","summary":"Reddit: Report (Subreddit feed)","tags":["Focus · Reddit"],"description":"Report. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":100,"description":"Reason text"},"rule_reason":{"type":"string","description":"Subreddit rule short_name"},"site_reason":{"type":"string","description":"Site-wide rule"},"custom_text":{"type":"string","maxLength":2000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-report","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/hide":{"post":{"operationId":"redditFeedHide","summary":"Reddit: Hide (Subreddit feed)","tags":["Focus · Reddit"],"description":"Hide. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/unhide":{"post":{"operationId":"redditFeedUnhide","summary":"Reddit: Unhide (Subreddit feed)","tags":["Focus · Reddit"],"description":"Unhide. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-unhide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/follow":{"post":{"operationId":"redditFeedFollow","summary":"Reddit: Follow post (Subreddit feed)","tags":["Focus · Reddit"],"description":"Follow post. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"follow":{"type":"boolean","default":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/crosspost":{"post":{"operationId":"redditFeedCrosspost","summary":"Reddit: Crosspost (Subreddit feed)","tags":["Focus · Reddit"],"description":"Crosspost to one subreddit (customise the title; no mass cross-posting). Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"title":{"type":"string","maxLength":300},"nsfw":{"type":"boolean"},"spoiler":{"type":"boolean"},"flairId":{"type":"string"},"flairText":{"type":"string"},"sendReplies":{"type":"boolean","default":true}},"required":["subreddit","title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-crosspost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/approve":{"post":{"operationId":"redditFeedApprove","summary":"Reddit: Approve (Subreddit feed)","tags":["Focus · Reddit"],"description":"Approve. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/remove":{"post":{"operationId":"redditFeedRemove","summary":"Reddit: Remove (Subreddit feed)","tags":["Focus · Reddit"],"description":"Remove. Hot/new/top/rising posts of a subreddit (or your front page). Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"spam":{"type":"boolean","default":false},"reason_id":{"type":"string","description":"Removal reason id"},"mod_note":{"type":"string","maxLength":100,"description":"Private note for the mod log"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-remove","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/send-removal-message":{"post":{"operationId":"redditFeedSendRemovalMessage","summary":"Reddit: Send removal message (Subreddit feed)","tags":["Focus · Reddit"],"description":"Send removal message. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1},"type":{"type":"string","enum":["public","private","private_exposed"],"default":"public"},"title":{"type":"string","maxLength":50,"description":"Subject (private messages)"}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-send-removal-message","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/distinguish":{"post":{"operationId":"redditFeedDistinguish","summary":"Reddit: Distinguish (Subreddit feed)","tags":["Focus · Reddit"],"description":"Distinguish. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"how":{"type":"string","enum":["yes","no","admin","special"],"default":"yes"},"sticky":{"type":"boolean","description":"Sticky (top-level own comments only)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-distinguish","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/ignore-reports":{"post":{"operationId":"redditFeedIgnoreReports","summary":"Reddit: Ignore reports (Subreddit feed)","tags":["Focus · Reddit"],"description":"Ignore reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-ignore-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/unignore-reports":{"post":{"operationId":"redditFeedUnignoreReports","summary":"Reddit: Unignore reports (Subreddit feed)","tags":["Focus · Reddit"],"description":"Unignore reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-unignore-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/snooze-reports":{"post":{"operationId":"redditFeedSnoozeReports","summary":"Reddit: Snooze reports (Subreddit feed)","tags":["Focus · Reddit"],"description":"Snooze reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"Report reason to snooze for 7 days"}},"required":["reason"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-snooze-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/unsnooze-reports":{"post":{"operationId":"redditFeedUnsnoozeReports","summary":"Reddit: Unsnooze reports (Subreddit feed)","tags":["Focus · Reddit"],"description":"Unsnooze reports. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-unsnooze-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/lock":{"post":{"operationId":"redditFeedLock","summary":"Reddit: Lock (Subreddit feed)","tags":["Focus · Reddit"],"description":"Lock. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-lock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/unlock":{"post":{"operationId":"redditFeedUnlock","summary":"Reddit: Unlock (Subreddit feed)","tags":["Focus · Reddit"],"description":"Unlock. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-unlock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/mark-nsfw":{"post":{"operationId":"redditFeedMarkNsfw","summary":"Reddit: Mark NSFW (Subreddit feed)","tags":["Focus · Reddit"],"description":"Mark NSFW. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-mark-nsfw","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/unmark-nsfw":{"post":{"operationId":"redditFeedUnmarkNsfw","summary":"Reddit: Unmark NSFW (Subreddit feed)","tags":["Focus · Reddit"],"description":"Unmark NSFW. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-unmark-nsfw","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/spoiler":{"post":{"operationId":"redditFeedSpoiler","summary":"Reddit: Mark spoiler (Subreddit feed)","tags":["Focus · Reddit"],"description":"Mark spoiler. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-spoiler","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/unspoiler":{"post":{"operationId":"redditFeedUnspoiler","summary":"Reddit: Unmark spoiler (Subreddit feed)","tags":["Focus · Reddit"],"description":"Unmark spoiler. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-unspoiler","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/sticky":{"post":{"operationId":"redditFeedSticky","summary":"Reddit: Pin / unpin (Subreddit feed)","tags":["Focus · Reddit"],"description":"Pin / unpin. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"boolean","default":true},"num":{"type":"integer","minimum":1,"maximum":6,"description":"Highlight slot (1–6)"},"to_profile":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-sticky","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/contest-mode":{"post":{"operationId":"redditFeedContestMode","summary":"Reddit: Contest mode (Subreddit feed)","tags":["Focus · Reddit"],"description":"Contest mode. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"boolean","default":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-contest-mode","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/suggested-sort":{"post":{"operationId":"redditFeedSuggestedSort","summary":"Reddit: Suggested sort (Subreddit feed)","tags":["Focus · Reddit"],"description":"Suggested sort. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sort":{"type":"string","enum":["confidence","top","new","controversial","old","random","qa","live","blank"]}},"required":["sort"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-suggested-sort","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/crowd-control":{"post":{"operationId":"redditFeedCrowdControl","summary":"Reddit: Crowd control level (Subreddit feed)","tags":["Focus · Reddit"],"description":"Crowd control level. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"level":{"type":"integer","minimum":0,"maximum":3}},"required":["level"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-crowd-control","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/feed/{itemId}/duplicates":{"post":{"operationId":"redditFeedDuplicates","summary":"Reddit: Other discussions (Subreddit feed)","tags":["Focus · Reddit"],"description":"Other discussions. Hot/new/top/rising posts of a subreddit (or your front page). Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/feed`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-feed-duplicates","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/vote":{"post":{"operationId":"redditSearchVote","summary":"Reddit: Vote (Search posts)","tags":["Focus · Reddit"],"description":"Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. User-initiated search (no bulk collection / social listening). Requires scopes: read, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"direction":{"type":"integer","enum":[1,0,-1]}},"required":["direction"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-vote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/save":{"post":{"operationId":"redditSearchSave","summary":"Reddit: Save (Search posts)","tags":["Focus · Reddit"],"description":"Save. User-initiated search (no bulk collection / social listening). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"Saved category (Reddit Premium)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-save","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/unsave":{"post":{"operationId":"redditSearchUnsave","summary":"Reddit: Unsave (Search posts)","tags":["Focus · Reddit"],"description":"Unsave. User-initiated search (no bulk collection / social listening). Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-unsave","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/report":{"post":{"operationId":"redditSearchReport","summary":"Reddit: Report (Search posts)","tags":["Focus · Reddit"],"description":"Report. User-initiated search (no bulk collection / social listening). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":100,"description":"Reason text"},"rule_reason":{"type":"string","description":"Subreddit rule short_name"},"site_reason":{"type":"string","description":"Site-wide rule"},"custom_text":{"type":"string","maxLength":2000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-report","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/hide":{"post":{"operationId":"redditSearchHide","summary":"Reddit: Hide (Search posts)","tags":["Focus · Reddit"],"description":"Hide. User-initiated search (no bulk collection / social listening). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/unhide":{"post":{"operationId":"redditSearchUnhide","summary":"Reddit: Unhide (Search posts)","tags":["Focus · Reddit"],"description":"Unhide. User-initiated search (no bulk collection / social listening). Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-unhide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/follow":{"post":{"operationId":"redditSearchFollow","summary":"Reddit: Follow post (Search posts)","tags":["Focus · Reddit"],"description":"Follow post. User-initiated search (no bulk collection / social listening). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"follow":{"type":"boolean","default":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/crosspost":{"post":{"operationId":"redditSearchCrosspost","summary":"Reddit: Crosspost (Search posts)","tags":["Focus · Reddit"],"description":"Crosspost to one subreddit (customise the title; no mass cross-posting). User-initiated search (no bulk collection / social listening). Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"title":{"type":"string","maxLength":300},"nsfw":{"type":"boolean"},"spoiler":{"type":"boolean"},"flairId":{"type":"string"},"flairText":{"type":"string"},"sendReplies":{"type":"boolean","default":true}},"required":["subreddit","title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-crosspost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/approve":{"post":{"operationId":"redditSearchApprove","summary":"Reddit: Approve (Search posts)","tags":["Focus · Reddit"],"description":"Approve. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/remove":{"post":{"operationId":"redditSearchRemove","summary":"Reddit: Remove (Search posts)","tags":["Focus · Reddit"],"description":"Remove. User-initiated search (no bulk collection / social listening). Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"spam":{"type":"boolean","default":false},"reason_id":{"type":"string","description":"Removal reason id"},"mod_note":{"type":"string","maxLength":100,"description":"Private note for the mod log"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-remove","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/send-removal-message":{"post":{"operationId":"redditSearchSendRemovalMessage","summary":"Reddit: Send removal message (Search posts)","tags":["Focus · Reddit"],"description":"Send removal message. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1},"type":{"type":"string","enum":["public","private","private_exposed"],"default":"public"},"title":{"type":"string","maxLength":50,"description":"Subject (private messages)"}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-send-removal-message","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/distinguish":{"post":{"operationId":"redditSearchDistinguish","summary":"Reddit: Distinguish (Search posts)","tags":["Focus · Reddit"],"description":"Distinguish. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"how":{"type":"string","enum":["yes","no","admin","special"],"default":"yes"},"sticky":{"type":"boolean","description":"Sticky (top-level own comments only)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-distinguish","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/ignore-reports":{"post":{"operationId":"redditSearchIgnoreReports","summary":"Reddit: Ignore reports (Search posts)","tags":["Focus · Reddit"],"description":"Ignore reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-ignore-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/unignore-reports":{"post":{"operationId":"redditSearchUnignoreReports","summary":"Reddit: Unignore reports (Search posts)","tags":["Focus · Reddit"],"description":"Unignore reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-unignore-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/snooze-reports":{"post":{"operationId":"redditSearchSnoozeReports","summary":"Reddit: Snooze reports (Search posts)","tags":["Focus · Reddit"],"description":"Snooze reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"Report reason to snooze for 7 days"}},"required":["reason"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-snooze-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/unsnooze-reports":{"post":{"operationId":"redditSearchUnsnoozeReports","summary":"Reddit: Unsnooze reports (Search posts)","tags":["Focus · Reddit"],"description":"Unsnooze reports. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-unsnooze-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/lock":{"post":{"operationId":"redditSearchLock","summary":"Reddit: Lock (Search posts)","tags":["Focus · Reddit"],"description":"Lock. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-lock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/unlock":{"post":{"operationId":"redditSearchUnlock","summary":"Reddit: Unlock (Search posts)","tags":["Focus · Reddit"],"description":"Unlock. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-unlock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/mark-nsfw":{"post":{"operationId":"redditSearchMarkNsfw","summary":"Reddit: Mark NSFW (Search posts)","tags":["Focus · Reddit"],"description":"Mark NSFW. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-mark-nsfw","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/unmark-nsfw":{"post":{"operationId":"redditSearchUnmarkNsfw","summary":"Reddit: Unmark NSFW (Search posts)","tags":["Focus · Reddit"],"description":"Unmark NSFW. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-unmark-nsfw","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/spoiler":{"post":{"operationId":"redditSearchSpoiler","summary":"Reddit: Mark spoiler (Search posts)","tags":["Focus · Reddit"],"description":"Mark spoiler. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-spoiler","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/unspoiler":{"post":{"operationId":"redditSearchUnspoiler","summary":"Reddit: Unmark spoiler (Search posts)","tags":["Focus · Reddit"],"description":"Unmark spoiler. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-unspoiler","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/sticky":{"post":{"operationId":"redditSearchSticky","summary":"Reddit: Pin / unpin (Search posts)","tags":["Focus · Reddit"],"description":"Pin / unpin. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"boolean","default":true},"num":{"type":"integer","minimum":1,"maximum":6,"description":"Highlight slot (1–6)"},"to_profile":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-sticky","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/contest-mode":{"post":{"operationId":"redditSearchContestMode","summary":"Reddit: Contest mode (Search posts)","tags":["Focus · Reddit"],"description":"Contest mode. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"boolean","default":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-contest-mode","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/suggested-sort":{"post":{"operationId":"redditSearchSuggestedSort","summary":"Reddit: Suggested sort (Search posts)","tags":["Focus · Reddit"],"description":"Suggested sort. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sort":{"type":"string","enum":["confidence","top","new","controversial","old","random","qa","live","blank"]}},"required":["sort"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-suggested-sort","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/search/{itemId}/crowd-control":{"post":{"operationId":"redditSearchCrowdControl","summary":"Reddit: Crowd control level (Search posts)","tags":["Focus · Reddit"],"description":"Crowd control level. User-initiated search (no bulk collection / social listening). Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"level":{"type":"integer","minimum":0,"maximum":3}},"required":["level"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-search-crowd-control","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments":{"get":{"operationId":"redditPostCommentsList","summary":"Reddit: List Post comments","tags":["Focus · Reddit"],"description":"GET /comments/{article}. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"post_id","required":false,"description":"t3_ id, base36 id or permalink"},{"schema":{"type":"string","enum":["best","top","new","controversial","old","qa"],"default":"best"},"in":"query","name":"sort","required":false},{"schema":{"type":"string"},"in":"query","name":"comment_id","required":false,"description":"Focus a sub-thread"},{"schema":{"type":"integer","minimum":1,"maximum":10},"in":"query","name":"depth","required":false},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-list","x-zernio":["GET /v1/reddit/comments/{postId}","GET /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t1_ fullname"},"text":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"like_count":{"type":"integer"},"parent_id":{"type":"string","description":"t3_ (top level) or t1_ parent"},"post_id":{"type":"string"},"post_title":{"type":["null","string"]},"subreddit":{"type":"string"},"permalink":{"type":"string","format":"uri"},"depth":{"type":"integer","minimum":0},"replies_count":{"type":"integer"},"is_submitter":{"type":"boolean"},"is_own":{"type":["null","boolean"]},"distinguished":{"type":["null","string"]},"stickied":{"type":"boolean"},"locked":{"type":"boolean"},"saved":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed":{"type":"boolean"}},"required":["id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditPostCommentsCreate","summary":"Reddit: Create a Post comments item","tags":["Focus · Reddit"],"description":"POST /api/comment. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"parent_id":{"type":"string","description":"t3_ (post) or t1_ (comment) to reply to"},"text":{"type":"string","minLength":1}},"required":["parent_id","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}","POST /v1/inbox/comments/{postId}/{commentId}/like","POST /v1/inbox/comments/{postId}/{commentId}/pin"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"t1_ fullname"},"text":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"like_count":{"type":"integer"},"parent_id":{"type":"string","description":"t3_ (top level) or t1_ parent"},"post_id":{"type":"string"},"post_title":{"type":["null","string"]},"subreddit":{"type":"string"},"permalink":{"type":"string","format":"uri"},"depth":{"type":"integer","minimum":0},"replies_count":{"type":"integer"},"is_submitter":{"type":"boolean"},"is_own":{"type":["null","boolean"]},"distinguished":{"type":["null","string"]},"stickied":{"type":"boolean"},"locked":{"type":"boolean"},"saved":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed":{"type":"boolean"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}":{"patch":{"operationId":"redditPostCommentsUpdate","summary":"Reddit: Update a Post comments item","tags":["Focus · Reddit"],"description":"POST /api/editusertext (own comments). The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-update","x-zernio":["PATCH /v1/inbox/comments/{postId}/{commentId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"t1_ fullname"},"text":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"like_count":{"type":"integer"},"parent_id":{"type":"string","description":"t3_ (top level) or t1_ parent"},"post_id":{"type":"string"},"post_title":{"type":["null","string"]},"subreddit":{"type":"string"},"permalink":{"type":"string","format":"uri"},"depth":{"type":"integer","minimum":0},"replies_count":{"type":"integer"},"is_submitter":{"type":"boolean"},"is_own":{"type":["null","boolean"]},"distinguished":{"type":["null","string"]},"stickied":{"type":"boolean"},"locked":{"type":"boolean"},"saved":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed":{"type":"boolean"}},"required":["id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditPostCommentsDelete","summary":"Reddit: Delete a Post comments item","tags":["Focus · Reddit"],"description":"POST /api/del (own comments). The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, edit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-delete","x-zernio":["DELETE /v1/inbox/comments/{postId}","DELETE /v1/inbox/comments/{postId}/{commentId}/like","DELETE /v1/inbox/comments/{postId}/{commentId}/pin"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/reply":{"post":{"operationId":"redditPostCommentsReply","summary":"Reddit: Reply (Post comments)","tags":["Focus · Reddit"],"description":"Reply. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/load-more":{"post":{"operationId":"redditPostCommentsLoadMore","summary":"Reddit: Load more comments (Post comments)","tags":["Focus · Reddit"],"description":"Load more comments. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"},"children":{"type":"array","items":{"type":"string"}},"sort":{"type":"string"}},"required":["post_id","children"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-load-more","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/vote":{"post":{"operationId":"redditPostCommentsVote","summary":"Reddit: Vote (Post comments)","tags":["Focus · Reddit"],"description":"Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"direction":{"type":"integer","enum":[1,0,-1]}},"required":["direction"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-vote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/save":{"post":{"operationId":"redditPostCommentsSave","summary":"Reddit: Save (Post comments)","tags":["Focus · Reddit"],"description":"Save. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"Saved category (Reddit Premium)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-save","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/unsave":{"post":{"operationId":"redditPostCommentsUnsave","summary":"Reddit: Unsave (Post comments)","tags":["Focus · Reddit"],"description":"Unsave. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-unsave","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/report":{"post":{"operationId":"redditPostCommentsReport","summary":"Reddit: Report (Post comments)","tags":["Focus · Reddit"],"description":"Report. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":100,"description":"Reason text"},"rule_reason":{"type":"string","description":"Subreddit rule short_name"},"site_reason":{"type":"string","description":"Site-wide rule"},"custom_text":{"type":"string","maxLength":2000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-report","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/approve":{"post":{"operationId":"redditPostCommentsApprove","summary":"Reddit: Approve (Post comments)","tags":["Focus · Reddit"],"description":"Approve. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/remove":{"post":{"operationId":"redditPostCommentsRemove","summary":"Reddit: Remove (Post comments)","tags":["Focus · Reddit"],"description":"Remove. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"spam":{"type":"boolean","default":false},"reason_id":{"type":"string","description":"Removal reason id"},"mod_note":{"type":"string","maxLength":100,"description":"Private note for the mod log"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-remove","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/send-removal-message":{"post":{"operationId":"redditPostCommentsSendRemovalMessage","summary":"Reddit: Send removal message (Post comments)","tags":["Focus · Reddit"],"description":"Send removal message. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1},"type":{"type":"string","enum":["public","private","private_exposed"],"default":"public"},"title":{"type":"string","maxLength":50,"description":"Subject (private messages)"}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-send-removal-message","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/distinguish":{"post":{"operationId":"redditPostCommentsDistinguish","summary":"Reddit: Distinguish (Post comments)","tags":["Focus · Reddit"],"description":"Distinguish. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"how":{"type":"string","enum":["yes","no","admin","special"],"default":"yes"},"sticky":{"type":"boolean","description":"Sticky (top-level own comments only)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-distinguish","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/ignore-reports":{"post":{"operationId":"redditPostCommentsIgnoreReports","summary":"Reddit: Ignore reports (Post comments)","tags":["Focus · Reddit"],"description":"Ignore reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-ignore-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/unignore-reports":{"post":{"operationId":"redditPostCommentsUnignoreReports","summary":"Reddit: Unignore reports (Post comments)","tags":["Focus · Reddit"],"description":"Unignore reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-unignore-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/snooze-reports":{"post":{"operationId":"redditPostCommentsSnoozeReports","summary":"Reddit: Snooze reports (Post comments)","tags":["Focus · Reddit"],"description":"Snooze reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"Report reason to snooze for 7 days"}},"required":["reason"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-snooze-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/unsnooze-reports":{"post":{"operationId":"redditPostCommentsUnsnoozeReports","summary":"Reddit: Unsnooze reports (Post comments)","tags":["Focus · Reddit"],"description":"Unsnooze reports. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-unsnooze-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/lock":{"post":{"operationId":"redditPostCommentsLock","summary":"Reddit: Lock (Post comments)","tags":["Focus · Reddit"],"description":"Lock. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-lock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/unlock":{"post":{"operationId":"redditPostCommentsUnlock","summary":"Reddit: Unlock (Post comments)","tags":["Focus · Reddit"],"description":"Unlock. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-unlock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-comments/{itemId}/show-comment":{"post":{"operationId":"redditPostCommentsShowComment","summary":"Reddit: Show collapsed comment (Post comments)","tags":["Focus · Reddit"],"description":"Show collapsed comment. The comment thread of any post: reply, edit/delete your comments, vote, moderate. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-comments-show-comment","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddit-rules":{"get":{"operationId":"redditSubredditRulesList","summary":"Reddit: List Subreddit rules","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/rules. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddit-rules`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddit-rules-list","x-zernio":["GET /v1/accounts/{accountId}/reddit-subreddits/{subreddit}/rules"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:short_name"},"priority":{"type":"integer"},"short_name":{"type":"string","maxLength":100},"description":{"type":["null","string"],"maxLength":500},"violation_reason":{"type":["null","string"],"maxLength":100},"kind":{"type":"string","enum":["all","link","comment"]},"created_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditSubredditRulesCreate","summary":"Reddit: Create a Subreddit rules item","tags":["Focus · Reddit"],"description":"POST /api/add_subreddit_rule (undocumented; scope unverified). Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddit-rules`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"short_name":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":500},"kind":{"type":"string","enum":["all","link","comment"],"default":"all"},"violation_reason":{"type":"string","maxLength":100}},"required":["subreddit","short_name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddit-rules-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:short_name"},"priority":{"type":"integer"},"short_name":{"type":"string","maxLength":100},"description":{"type":["null","string"],"maxLength":500},"violation_reason":{"type":["null","string"],"maxLength":100},"kind":{"type":"string","enum":["all","link","comment"]},"created_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddit-rules/{itemId}":{"patch":{"operationId":"redditSubredditRulesUpdate","summary":"Reddit: Update a Subreddit rules item","tags":["Focus · Reddit"],"description":"POST /api/update_subreddit_rule. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddit-rules`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"short_name":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":500},"kind":{"type":"string","enum":["all","link","comment"]},"violation_reason":{"type":"string","maxLength":100}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddit-rules-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:short_name"},"priority":{"type":"integer"},"short_name":{"type":"string","maxLength":100},"description":{"type":["null","string"],"maxLength":500},"violation_reason":{"type":["null","string"],"maxLength":100},"kind":{"type":"string","enum":["all","link","comment"]},"created_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditSubredditRulesDelete","summary":"Reddit: Delete a Subreddit rules item","tags":["Focus · Reddit"],"description":"POST /api/remove_subreddit_rule. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddit-rules`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddit-rules-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddit-rules/reorder":{"post":{"operationId":"redditSubredditRulesReorder","summary":"Reddit: Reorder rules (Subreddit rules)","tags":["Focus · Reddit"],"description":"Reorder rules. Rules of a subreddit (shown in the composer). Moderators can add, edit, reorder and delete rules. Requires scopes: read, modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddit-rules`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"order":{"type":"array","items":{"type":"string"},"description":"short_names in the new order"}},"required":["subreddit","order"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddit-rules-reorder","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-flairs":{"get":{"operationId":"redditPostFlairsList","summary":"Reddit: List Post flair","tags":["Focus · Reddit"],"description":"GET /r/{sr}/api/link_flair_v2. Link flair templates you can apply to your posts in a subreddit. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-flairs`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-flairs-list","x-zernio":["GET /v1/accounts/{accountId}/reddit-flairs"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string","maxLength":64},"textColor":{"type":["null","string"],"enum":["light","dark",null]},"backgroundColor":{"type":["null","string"],"description":"#rrggbb"},"textEditable":{"type":"boolean"},"type":{"type":"string","enum":["text","richtext"]},"modOnly":{"type":"boolean"},"allowableContent":{"type":"string","enum":["all","emoji","text"]},"maxEmojis":{"type":["null","integer"],"minimum":1,"maximum":10},"cssClass":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-flairs/{itemId}/apply":{"post":{"operationId":"redditPostFlairsApply","summary":"Reddit: Apply to post (Post flair)","tags":["Focus · Reddit"],"description":"Apply to post. Link flair templates you can apply to your posts in a subreddit. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-flairs`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"post_id":{"type":"string"},"text":{"type":"string","maxLength":64}},"required":["post_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-flairs-apply","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/reddit-flairs"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/user-flair":{"get":{"operationId":"redditUserFlairList","summary":"Reddit: List My user flair","tags":["Focus · Reddit"],"description":"GET /r/{sr}/api/user_flair_v2. User flair templates in a subreddit; select one as your flair or clear it. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/user-flair`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-user-flair-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string","maxLength":64},"textColor":{"type":["null","string"],"enum":["light","dark",null]},"backgroundColor":{"type":["null","string"],"description":"#rrggbb"},"textEditable":{"type":"boolean"},"type":{"type":"string","enum":["text","richtext"]},"modOnly":{"type":"boolean"},"allowableContent":{"type":"string","enum":["all","emoji","text"]},"maxEmojis":{"type":["null","integer"],"minimum":1,"maximum":10},"cssClass":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/user-flair/{itemId}/select":{"post":{"operationId":"redditUserFlairSelect","summary":"Reddit: Use as my flair (My user flair)","tags":["Focus · Reddit"],"description":"Use as my flair. User flair templates in a subreddit; select one as your flair or clear it. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/user-flair`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"text":{"type":"string","maxLength":64}},"required":["subreddit"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-user-flair-select","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/user-flair/clear":{"post":{"operationId":"redditUserFlairClear","summary":"Reddit: Clear my flair (My user flair)","tags":["Focus · Reddit"],"description":"Clear my flair. User flair templates in a subreddit; select one as your flair or clear it. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/user-flair`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1}},"required":["subreddit"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-user-flair-clear","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/user-flair/toggle-display":{"post":{"operationId":"redditUserFlairToggleDisplay","summary":"Reddit: Show flair in this subreddit (My user flair)","tags":["Focus · Reddit"],"description":"Show flair in this subreddit. User flair templates in a subreddit; select one as your flair or clear it. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/user-flair`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"enabled":{"type":"boolean"}},"required":["subreddit","enabled"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-user-flair-toggle-display","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki":{"get":{"operationId":"redditWikiList","summary":"Reddit: List Wiki","tags":["Focus · Reddit"],"description":"GET /r/{sr}/wiki/pages. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: wikiread. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:page"},"subreddit":{"type":"string"},"page":{"type":"string"},"content_md":{"type":"string"},"revision_id":{"type":["null","string"]},"revision_by":{"type":["null","string"]},"revision_date":{"type":["null","string"],"format":"date-time"},"reason":{"type":["null","string"]},"may_revise":{"type":["null","boolean"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditWikiCreate","summary":"Reddit: Create a Wiki item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/wiki/edit (new page). Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, wikiedit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"page":{"type":"string","minLength":1},"content":{"type":"string"},"reason":{"type":"string","maxLength":256}},"required":["subreddit","page","content"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:page"},"subreddit":{"type":"string"},"page":{"type":"string"},"content_md":{"type":"string"},"revision_id":{"type":["null","string"]},"revision_by":{"type":["null","string"]},"revision_date":{"type":["null","string"],"format":"date-time"},"reason":{"type":["null","string"]},"may_revise":{"type":["null","boolean"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki/{itemId}":{"get":{"operationId":"redditWikiGet","summary":"Reddit: Get a Wiki item","tags":["Focus · Reddit"],"description":"GET /r/{sr}/wiki/{page}. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"revision","required":false,"description":"Revision id (v)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:page"},"subreddit":{"type":"string"},"page":{"type":"string"},"content_md":{"type":"string"},"revision_id":{"type":["null","string"]},"revision_by":{"type":["null","string"]},"revision_date":{"type":["null","string"],"format":"date-time"},"reason":{"type":["null","string"]},"may_revise":{"type":["null","boolean"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"redditWikiUpdate","summary":"Reddit: Update a Wiki item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/wiki/edit. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, wikiedit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string"},"reason":{"type":"string","maxLength":256},"previous":{"type":"string","description":"Revision id the edit is based on (conflict detection)"}},"required":["content"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:page"},"subreddit":{"type":"string"},"page":{"type":"string"},"content_md":{"type":"string"},"revision_id":{"type":["null","string"]},"revision_by":{"type":["null","string"]},"revision_date":{"type":["null","string"],"format":"date-time"},"reason":{"type":["null","string"]},"may_revise":{"type":["null","boolean"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki/{itemId}/revisions":{"post":{"operationId":"redditWikiRevisions","summary":"Reddit: Revisions (Wiki)","tags":["Focus · Reddit"],"description":"Revisions. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-revisions","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki/{itemId}/revert":{"post":{"operationId":"redditWikiRevert","summary":"Reddit: Revert to revision (Wiki)","tags":["Focus · Reddit"],"description":"Revert to revision. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Destructive. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"string"}},"required":["revision"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-revert","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki/{itemId}/hide-revision":{"post":{"operationId":"redditWikiHideRevision","summary":"Reddit: Hide/unhide revision (Wiki)","tags":["Focus · Reddit"],"description":"Hide/unhide revision. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"string"}},"required":["revision"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-hide-revision","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki/{itemId}/settings":{"post":{"operationId":"redditWikiSettings","summary":"Reddit: Page settings (Wiki)","tags":["Focus · Reddit"],"description":"Page settings. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-settings","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki/{itemId}/update-settings":{"post":{"operationId":"redditWikiUpdateSettings","summary":"Reddit: Update page settings (Wiki)","tags":["Focus · Reddit"],"description":"Update page settings. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"permlevel":{"type":"integer","enum":[0,1,2],"description":"0 = subreddit settings, 1 = approved editors, 2 = mods only"},"listed":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-update-settings","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki/{itemId}/add-editor":{"post":{"operationId":"redditWikiAddEditor","summary":"Reddit: Allow editor (Wiki)","tags":["Focus · Reddit"],"description":"Allow editor. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-add-editor","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki/{itemId}/remove-editor":{"post":{"operationId":"redditWikiRemoveEditor","summary":"Reddit: Remove editor (Wiki)","tags":["Focus · Reddit"],"description":"Remove editor. Read and edit subreddit wiki pages (including config/automoderator for mods); revisions, revert, page settings and editors. Requires scopes: wikiread, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-remove-editor","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/custom-feeds":{"get":{"operationId":"redditCustomFeedsList","summary":"Reddit: List Custom feeds","tags":["Focus · Reddit"],"description":"GET /api/multi/mine. Your multireddits (custom feeds). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/custom-feeds`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-custom-feeds-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"display_name":{"type":"string"},"path":{"type":["null","string"]},"description":{"type":["null","string"]},"visibility":{"type":"string","enum":["private","public","hidden"]},"subreddits":{"type":"array","items":{"type":"string"}},"over_18":{"type":"boolean"},"icon_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditCustomFeedsCreate","summary":"Reddit: Create a Custom feeds item","tags":["Focus · Reddit"],"description":"POST /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/custom-feeds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","pattern":"^[A-Za-z0-9_]{2,50}$","description":"URL name"},"display_name":{"type":"string","maxLength":50},"description":{"type":"string"},"visibility":{"type":"string","enum":["private","public","hidden"],"default":"private"},"subreddits":{"type":"array","items":{"type":"string"}}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-custom-feeds-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"display_name":{"type":"string"},"path":{"type":["null","string"]},"description":{"type":["null","string"]},"visibility":{"type":"string","enum":["private","public","hidden"]},"subreddits":{"type":"array","items":{"type":"string"}},"over_18":{"type":"boolean"},"icon_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/custom-feeds/{itemId}":{"get":{"operationId":"redditCustomFeedsGet","summary":"Reddit: Get a Custom feeds item","tags":["Focus · Reddit"],"description":"GET /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/custom-feeds`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-custom-feeds-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"display_name":{"type":"string"},"path":{"type":["null","string"]},"description":{"type":["null","string"]},"visibility":{"type":"string","enum":["private","public","hidden"]},"subreddits":{"type":"array","items":{"type":"string"}},"over_18":{"type":"boolean"},"icon_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"redditCustomFeedsUpdate","summary":"Reddit: Update a Custom feeds item","tags":["Focus · Reddit"],"description":"PUT /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/custom-feeds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","pattern":"^[A-Za-z0-9_]{2,50}$","description":"URL name"},"display_name":{"type":"string","maxLength":50},"description":{"type":"string"},"visibility":{"type":"string","enum":["private","public","hidden"],"default":"private"},"subreddits":{"type":"array","items":{"type":"string"}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-custom-feeds-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"display_name":{"type":"string"},"path":{"type":["null","string"]},"description":{"type":["null","string"]},"visibility":{"type":"string","enum":["private","public","hidden"]},"subreddits":{"type":"array","items":{"type":"string"}},"over_18":{"type":"boolean"},"icon_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditCustomFeedsDelete","summary":"Reddit: Delete a Custom feeds item","tags":["Focus · Reddit"],"description":"DELETE /api/multi/{multipath}. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/custom-feeds`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-custom-feeds-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/custom-feeds/{itemId}/add-subreddit":{"post":{"operationId":"redditCustomFeedsAddSubreddit","summary":"Reddit: Add subreddit (Custom feeds)","tags":["Focus · Reddit"],"description":"Add subreddit. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/custom-feeds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1}},"required":["subreddit"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-custom-feeds-add-subreddit","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/custom-feeds/{itemId}/remove-subreddit":{"post":{"operationId":"redditCustomFeedsRemoveSubreddit","summary":"Reddit: Remove subreddit (Custom feeds)","tags":["Focus · Reddit"],"description":"Remove subreddit. Your multireddits (custom feeds). Requires scopes: read, subscribe. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/custom-feeds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1}},"required":["subreddit"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-custom-feeds-remove-subreddit","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/inbox":{"get":{"operationId":"redditInboxList","summary":"Reddit: List Inbox","tags":["Focus · Reddit"],"description":"GET /message/inbox. Everything: messages, replies to your posts and comments, and username mentions. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/inbox`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["inbox","unread","messages","comments","selfreply","mentions"],"default":"inbox"},"in":"query","name":"filter","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"mark_read","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-inbox-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t1_ (comment/mention) or t4_ (message) fullname"},"type":{"type":"string","enum":["message","comment_reply","post_reply","mention"]},"subject":{"type":["null","string"]},"text":{"type":"string"},"author":{"type":["null","string"]},"to":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"unread":{"type":"boolean"},"direction":{"type":"string","enum":["in","out"]},"conversation_id":{"type":["null","string"]},"parent_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"post_title":{"type":["null","string"]},"subreddit":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"distinguished":{"type":["null","string"]}},"required":["id","type"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/inbox/{itemId}/reply":{"post":{"operationId":"redditInboxReply","summary":"Reddit: Reply (Inbox)","tags":["Focus · Reddit"],"description":"Reply. Everything: messages, replies to your posts and comments, and username mentions. Requires scopes: privatemessages, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/inbox`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-inbox-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/inbox/{itemId}/mark-read":{"post":{"operationId":"redditInboxMarkRead","summary":"Reddit: Mark read (Inbox)","tags":["Focus · Reddit"],"description":"Mark read. Everything: messages, replies to your posts and comments, and username mentions. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/inbox`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-inbox-mark-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/inbox/mark-all-read":{"post":{"operationId":"redditInboxMarkAllRead","summary":"Reddit: Mark all read (Inbox)","tags":["Focus · Reddit"],"description":"Mark all read. Everything: messages, replies to your posts and comments, and username mentions. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/inbox`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-inbox-mark-all-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/inbox/{itemId}/delete":{"post":{"operationId":"redditInboxDelete","summary":"Reddit: Delete message (Inbox)","tags":["Focus · Reddit"],"description":"POST /api/del_msg (private messages only; removes it from your view). Everything: messages, replies to your posts and comments, and username mentions. Destructive. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/inbox`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_reddit","x-mcp-tool":"reddit-inbox-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/messages":{"get":{"operationId":"redditMessagesList","summary":"Reddit: List Messages","tags":["Focus · Reddit"],"description":"GET /message/messages (+ /message/sent). Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/messages`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"include_sent","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-messages-list","x-zernio":["GET /v1/inbox/conversations","GET /v1/inbox/conversations/{conversationId}/messages"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Thread root t4_ fullname"},"subject":{"type":["null","string"]},"updated_at":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"last_message":{"type":["null","string"]},"message_count":{"type":"integer"},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":["null","string"]},"subreddit":{"type":["null","string"]}}}},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":"string","format":"date-time"},"from_id":{"type":["null","string"]},"to_id":{"type":["null","string"]},"subject":{"type":["null","string"]},"unread":{"type":"boolean"}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditMessagesCreate","summary":"Reddit: Create a Messages item","tags":["Focus · Reddit"],"description":"POST /api/compose (new conversation; recipient may need to accept a chat request). Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"string","description":"username, u/username, or r/subreddit (messages its moderators)"},"subject":{"type":"string","maxLength":100},"text":{"type":"string","minLength":1},"from_subreddit":{"type":"string","description":"Send as a subreddit you moderate"}},"required":["to","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-messages-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations","POST /v1/inbox/conversations/{conversationId}/messages","POST /v1/inbox/conversations/{conversationId}/read"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Thread root t4_ fullname"},"subject":{"type":["null","string"]},"updated_at":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"last_message":{"type":["null","string"]},"message_count":{"type":"integer"},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":["null","string"]},"subreddit":{"type":["null","string"]}}}},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":"string","format":"date-time"},"from_id":{"type":["null","string"]},"to_id":{"type":["null","string"]},"subject":{"type":["null","string"]},"unread":{"type":"boolean"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/messages/{itemId}":{"get":{"operationId":"redditMessagesGet","summary":"Reddit: Get a Messages item","tags":["Focus · Reddit"],"description":"GET /message/messages/{id}. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/messages`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-messages-get","x-zernio":["GET /v1/inbox/conversations/{conversationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Thread root t4_ fullname"},"subject":{"type":["null","string"]},"updated_at":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"last_message":{"type":["null","string"]},"message_count":{"type":"integer"},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":["null","string"]},"subreddit":{"type":["null","string"]}}}},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":"string","format":"date-time"},"from_id":{"type":["null","string"]},"to_id":{"type":["null","string"]},"subject":{"type":["null","string"]},"unread":{"type":"boolean"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditMessagesDelete","summary":"Reddit: Delete a Messages item","tags":["Focus · Reddit"],"description":"POST /api/del_msg. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/messages`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-messages-delete","x-zernio":["DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/messages/{itemId}/reply":{"post":{"operationId":"redditMessagesReply","summary":"Reddit: Reply (Messages)","tags":["Focus · Reddit"],"description":"Reply. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-messages-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/messages/{itemId}/mark-read":{"post":{"operationId":"redditMessagesMarkRead","summary":"Reddit: Mark read (Messages)","tags":["Focus · Reddit"],"description":"Mark read. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-messages-mark-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/messages/mark-all-read":{"post":{"operationId":"redditMessagesMarkAllRead","summary":"Reddit: Mark all read (Messages)","tags":["Focus · Reddit"],"description":"Mark all read. Private message threads (delivered as Reddit Chat since 2025). Text only; never send unsolicited messages. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-messages-mark-all-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mentions":{"get":{"operationId":"redditMentionsList","summary":"Reddit: List Mentions","tags":["Focus · Reddit"],"description":"GET /message/mentions. Comments that mention u/you. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mentions`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"mark_read","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mentions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t1_ (comment/mention) or t4_ (message) fullname"},"type":{"type":"string","enum":["message","comment_reply","post_reply","mention"]},"subject":{"type":["null","string"]},"text":{"type":"string"},"author":{"type":["null","string"]},"to":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"unread":{"type":"boolean"},"direction":{"type":"string","enum":["in","out"]},"conversation_id":{"type":["null","string"]},"parent_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"post_title":{"type":["null","string"]},"subreddit":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"distinguished":{"type":["null","string"]}},"required":["id","type"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mentions/{itemId}/reply":{"post":{"operationId":"redditMentionsReply","summary":"Reddit: Reply (Mentions)","tags":["Focus · Reddit"],"description":"Reply. Comments that mention u/you. Requires scopes: privatemessages, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mentions-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mentions/{itemId}/mark-read":{"post":{"operationId":"redditMentionsMarkRead","summary":"Reddit: Mark read (Mentions)","tags":["Focus · Reddit"],"description":"Mark read. Comments that mention u/you. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mentions-mark-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mentions/mark-all-read":{"post":{"operationId":"redditMentionsMarkAllRead","summary":"Reddit: Mark all read (Mentions)","tags":["Focus · Reddit"],"description":"Mark all read. Comments that mention u/you. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mentions-mark-all-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mentions/{itemId}/vote":{"post":{"operationId":"redditMentionsVote","summary":"Reddit: Vote (Mentions)","tags":["Focus · Reddit"],"description":"Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Comments that mention u/you. Requires scopes: privatemessages, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"direction":{"type":"integer","enum":[1,0,-1]}},"required":["direction"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mentions-vote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mentions/{itemId}/save":{"post":{"operationId":"redditMentionsSave","summary":"Reddit: Save (Mentions)","tags":["Focus · Reddit"],"description":"Save. Comments that mention u/you. Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"Saved category (Reddit Premium)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mentions-save","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mentions/{itemId}/unsave":{"post":{"operationId":"redditMentionsUnsave","summary":"Reddit: Unsave (Mentions)","tags":["Focus · Reddit"],"description":"Unsave. Comments that mention u/you. Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mentions-unsave","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mentions/{itemId}/report":{"post":{"operationId":"redditMentionsReport","summary":"Reddit: Report (Mentions)","tags":["Focus · Reddit"],"description":"Report. Comments that mention u/you. Requires scopes: privatemessages, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":100,"description":"Reason text"},"rule_reason":{"type":"string","description":"Subreddit rule short_name"},"site_reason":{"type":"string","description":"Site-wide rule"},"custom_text":{"type":"string","maxLength":2000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mentions-report","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/replies":{"get":{"operationId":"redditRepliesList","summary":"Reddit: List Replies","tags":["Focus · Reddit"],"description":"GET /message/comments. Replies to your comments (comments) and to your posts (selfreply). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/replies`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["comments","selfreply"],"default":"comments"},"in":"query","name":"filter","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"mark_read","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-replies-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t1_ (comment/mention) or t4_ (message) fullname"},"type":{"type":"string","enum":["message","comment_reply","post_reply","mention"]},"subject":{"type":["null","string"]},"text":{"type":"string"},"author":{"type":["null","string"]},"to":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"unread":{"type":"boolean"},"direction":{"type":"string","enum":["in","out"]},"conversation_id":{"type":["null","string"]},"parent_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"post_title":{"type":["null","string"]},"subreddit":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"distinguished":{"type":["null","string"]}},"required":["id","type"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/replies/{itemId}/reply":{"post":{"operationId":"redditRepliesReply","summary":"Reddit: Reply (Replies)","tags":["Focus · Reddit"],"description":"Reply. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, submit. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-replies-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/replies/{itemId}/mark-read":{"post":{"operationId":"redditRepliesMarkRead","summary":"Reddit: Mark read (Replies)","tags":["Focus · Reddit"],"description":"Mark read. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-replies-mark-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/replies/mark-all-read":{"post":{"operationId":"redditRepliesMarkAllRead","summary":"Reddit: Mark all read (Replies)","tags":["Focus · Reddit"],"description":"Mark all read. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-replies-mark-all-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/replies/{itemId}/vote":{"post":{"operationId":"redditRepliesVote","summary":"Reddit: Vote (Replies)","tags":["Focus · Reddit"],"description":"Upvote (1), downvote (-1) or clear (0). Human click only; never automate or batch. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, vote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"direction":{"type":"integer","enum":[1,0,-1]}},"required":["direction"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-replies-vote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/replies/{itemId}/save":{"post":{"operationId":"redditRepliesSave","summary":"Reddit: Save (Replies)","tags":["Focus · Reddit"],"description":"Save. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"Saved category (Reddit Premium)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-replies-save","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/replies/{itemId}/unsave":{"post":{"operationId":"redditRepliesUnsave","summary":"Reddit: Unsave (Replies)","tags":["Focus · Reddit"],"description":"Unsave. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, save. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-replies-unsave","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/replies/{itemId}/report":{"post":{"operationId":"redditRepliesReport","summary":"Reddit: Report (Replies)","tags":["Focus · Reddit"],"description":"Report. Replies to your comments (comments) and to your posts (selfreply). Requires scopes: privatemessages, report. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":100,"description":"Reason text"},"rule_reason":{"type":"string","description":"Subreddit rule short_name"},"site_reason":{"type":"string","description":"Site-wide rule"},"custom_text":{"type":"string","maxLength":2000}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-replies-report","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/sent":{"get":{"operationId":"redditSentList","summary":"Reddit: List Sent","tags":["Focus · Reddit"],"description":"GET /message/sent. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: privatemessages. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/sent`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-sent-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t1_ (comment/mention) or t4_ (message) fullname"},"type":{"type":"string","enum":["message","comment_reply","post_reply","mention"]},"subject":{"type":["null","string"]},"text":{"type":"string"},"author":{"type":["null","string"]},"to":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"unread":{"type":"boolean"},"direction":{"type":"string","enum":["in","out"]},"conversation_id":{"type":["null","string"]},"parent_id":{"type":["null","string"]},"post_id":{"type":["null","string"]},"post_title":{"type":["null","string"]},"subreddit":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"distinguished":{"type":["null","string"]}},"required":["id","type"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/announcements":{"get":{"operationId":"redditAnnouncementsList","summary":"Reddit: List Reddit announcements","tags":["Focus · Reddit"],"description":"GET /api/announcements/v1[/unread]. Admin notices delivered to the inbox (response shape unverified). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/announcements`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"unread","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-announcements-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["null","string"]},"body":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"},"sent_at":{"type":["null","string"],"format":"date-time"},"read":{"type":"boolean"},"hidden":{"type":"boolean"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/announcements/{itemId}/read":{"post":{"operationId":"redditAnnouncementsRead","summary":"Reddit: Mark read (Reddit announcements)","tags":["Focus · Reddit"],"description":"Mark read. Admin notices delivered to the inbox (response shape unverified). Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/announcements`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-announcements-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/announcements/{itemId}/hide":{"post":{"operationId":"redditAnnouncementsHide","summary":"Reddit: Hide (Reddit announcements)","tags":["Focus · Reddit"],"description":"Hide. Admin notices delivered to the inbox (response shape unverified). Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/announcements`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-announcements-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/announcements/read-all":{"post":{"operationId":"redditAnnouncementsReadAll","summary":"Reddit: Mark all read (Reddit announcements)","tags":["Focus · Reddit"],"description":"Mark all read. Admin notices delivered to the inbox (response shape unverified). Requires scopes: announcements. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/announcements`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-announcements-read-all","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/moderated-subreddits":{"get":{"operationId":"redditModeratedSubredditsList","summary":"Reddit: List Moderated subreddits","tags":["Focus · Reddit"],"description":"GET /subreddits/mine/moderator. Communities you moderate. Moderation resources act on one of these. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/moderated-subreddits`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-moderated-subreddits-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":["null","string"],"description":"t5_ fullname"},"name":{"type":"string"},"prefixed_name":{"type":"string"},"title":{"type":["null","string"]},"description":{"type":["null","string"]},"subscribers":{"type":["null","integer"]},"active_users":{"type":["null","integer"]},"type":{"type":["null","string"],"enum":["public","private","restricted","gold_restricted","archived","employees_only","gold_only","user",null]},"over_18":{"type":"boolean"},"submission_type":{"type":"string","enum":["any","link","self"]},"post_types":{"type":"object","properties":{"self":{"type":"boolean"},"link":{"type":"boolean"},"image":{"type":"boolean"},"video":{"type":"boolean"},"gallery":{"type":"boolean"},"videogif":{"type":"boolean"},"poll":{"type":"boolean"},"crosspost":{"type":"boolean"}}},"spoilers_enabled":{"type":"boolean"},"link_flair_enabled":{"type":"boolean"},"restrict_posting":{"type":"boolean"},"user_is_subscriber":{"type":"boolean"},"user_is_moderator":{"type":"boolean"},"user_is_contributor":{"type":"boolean"},"user_is_banned":{"type":"boolean"},"icon_url":{"type":["null","string"],"format":"uri"},"banner_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/moderated-subreddits/{itemId}/leave":{"post":{"operationId":"redditModeratedSubredditsLeave","summary":"Reddit: Leave as moderator (Moderated subreddits)","tags":["Focus · Reddit"],"description":"Leave as moderator. Communities you moderate. Moderation resources act on one of these. Destructive. Requires scopes: mysubreddits, modself. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/moderated-subreddits`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_reddit","x-mcp-tool":"reddit-moderated-subreddits-leave","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/moderated-subreddits/{itemId}/leave-contributor":{"post":{"operationId":"redditModeratedSubredditsLeaveContributor","summary":"Reddit: Leave as approved user (Moderated subreddits)","tags":["Focus · Reddit"],"description":"Leave as approved user. Communities you moderate. Moderation resources act on one of these. Destructive. Requires scopes: mysubreddits, modself. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/moderated-subreddits`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_reddit","x-mcp-tool":"reddit-moderated-subreddits-leave-contributor","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/moderated-subreddits/accept-invite":{"post":{"operationId":"redditModeratedSubredditsAcceptInvite","summary":"Reddit: Accept moderator invite (Moderated subreddits)","tags":["Focus · Reddit"],"description":"Accept moderator invite. Communities you moderate. Moderation resources act on one of these. Requires scopes: mysubreddits, modself. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/moderated-subreddits`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1}},"required":["subreddit"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-moderated-subreddits-accept-invite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue":{"get":{"operationId":"redditModQueueList","summary":"Reddit: List Mod queue","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/{modqueue|reports|spam|edited|unmoderated}. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","default":"mod"},"in":"query","name":"subreddit","required":false,"description":"Subreddit, or \"mod\" for all moderated"},{"schema":{"type":"string","enum":["modqueue","reports","spam","edited","unmoderated"],"default":"modqueue"},"in":"query","name":"location","required":false},{"schema":{"type":"string","enum":["links","comments"]},"in":"query","name":"only","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"t1_ fullname"},"short_id":{"type":"string"},"title":{"type":"string","maxLength":300},"text":{"type":"string"},"url":{"type":["null","string"],"format":"uri"},"permalink":{"type":"string","format":"uri"},"subreddit":{"type":"string"},"author":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"edited_at":{"type":["null","string"],"format":"date-time"},"score":{"type":"integer"},"upvote_ratio":{"type":["null","number"],"minimum":0,"maximum":1},"num_comments":{"type":"integer"},"num_crossposts":{"type":"integer"},"awards":{"type":"integer"},"view_count":{"type":["null","integer"]},"kind":{"type":"string","enum":["post","comment"]},"domain":{"type":["null","string"]},"thumbnail":{"type":["null","string"],"format":"uri"},"flair_text":{"type":["null","string"]},"flair_template_id":{"type":["null","string"]},"over_18":{"type":"boolean"},"spoiler":{"type":"boolean"},"locked":{"type":"boolean"},"stickied":{"type":"boolean"},"archived":{"type":"boolean"},"distinguished":{"type":["null","string"]},"send_replies":{"type":["null","boolean"]},"saved":{"type":"boolean"},"hidden":{"type":"boolean"},"my_vote":{"type":"integer","enum":[-1,0,1]},"removed_by_category":{"type":["null","string"]},"num_reports":{"type":"integer"},"poll":{"type":["null","object"],"properties":{"total_votes":{"type":["null","integer"]},"ends_at":{"type":["null","string"],"format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"votes":{"type":["null","integer"]}}}}}},"gallery":{"type":["null","array"],"items":{"type":"object","properties":{"media_id":{"type":"string"},"caption":{"type":["null","string"]},"outbound_url":{"type":["null","string"],"format":"uri"},"url":{"type":["null","string"],"format":"uri"}}}},"video_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"parent_id":{"type":"string","description":"t3_ (top level) or t1_ parent"},"post_id":{"type":"string"},"post_title":{"type":["null","string"]},"depth":{"type":"integer","minimum":0},"replies_count":{"type":"integer"},"is_submitter":{"type":"boolean"},"is_own":{"type":["null","boolean"]},"removed":{"type":"boolean"},"mod_reports":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"[[reason, count|moderator]]"},"user_reports":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"[[reason, count|moderator]]"},"approved_by":{"type":["null","string"]},"banned_by":{"type":["null","string"]},"removal_reason":{"type":["null","string"]},"ignore_reports":{"type":"boolean"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/approve":{"post":{"operationId":"redditModQueueApprove","summary":"Reddit: Approve (Mod queue)","tags":["Focus · Reddit"],"description":"Approve. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/remove":{"post":{"operationId":"redditModQueueRemove","summary":"Reddit: Remove (Mod queue)","tags":["Focus · Reddit"],"description":"Remove. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Destructive. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"spam":{"type":"boolean","default":false},"reason_id":{"type":"string","description":"Removal reason id"},"mod_note":{"type":"string","maxLength":100,"description":"Private note for the mod log"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-remove","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/send-removal-message":{"post":{"operationId":"redditModQueueSendRemovalMessage","summary":"Reddit: Send removal message (Mod queue)","tags":["Focus · Reddit"],"description":"Send removal message. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1},"type":{"type":"string","enum":["public","private","private_exposed"],"default":"public"},"title":{"type":"string","maxLength":50,"description":"Subject (private messages)"}},"required":["message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-send-removal-message","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/distinguish":{"post":{"operationId":"redditModQueueDistinguish","summary":"Reddit: Distinguish (Mod queue)","tags":["Focus · Reddit"],"description":"Distinguish. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"how":{"type":"string","enum":["yes","no","admin","special"],"default":"yes"},"sticky":{"type":"boolean","description":"Sticky (top-level own comments only)"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-distinguish","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/ignore-reports":{"post":{"operationId":"redditModQueueIgnoreReports","summary":"Reddit: Ignore reports (Mod queue)","tags":["Focus · Reddit"],"description":"Ignore reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-ignore-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/unignore-reports":{"post":{"operationId":"redditModQueueUnignoreReports","summary":"Reddit: Unignore reports (Mod queue)","tags":["Focus · Reddit"],"description":"Unignore reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-unignore-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/snooze-reports":{"post":{"operationId":"redditModQueueSnoozeReports","summary":"Reddit: Snooze reports (Mod queue)","tags":["Focus · Reddit"],"description":"Snooze reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"Report reason to snooze for 7 days"}},"required":["reason"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-snooze-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/unsnooze-reports":{"post":{"operationId":"redditModQueueUnsnoozeReports","summary":"Reddit: Unsnooze reports (Mod queue)","tags":["Focus · Reddit"],"description":"Unsnooze reports. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-unsnooze-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/lock":{"post":{"operationId":"redditModQueueLock","summary":"Reddit: Lock (Mod queue)","tags":["Focus · Reddit"],"description":"Lock. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-lock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/unlock":{"post":{"operationId":"redditModQueueUnlock","summary":"Reddit: Unlock (Mod queue)","tags":["Focus · Reddit"],"description":"Unlock. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-unlock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/mark-nsfw":{"post":{"operationId":"redditModQueueMarkNsfw","summary":"Reddit: Mark NSFW (Mod queue)","tags":["Focus · Reddit"],"description":"Mark NSFW. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-mark-nsfw","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/unmark-nsfw":{"post":{"operationId":"redditModQueueUnmarkNsfw","summary":"Reddit: Unmark NSFW (Mod queue)","tags":["Focus · Reddit"],"description":"Unmark NSFW. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-unmark-nsfw","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/spoiler":{"post":{"operationId":"redditModQueueSpoiler","summary":"Reddit: Mark spoiler (Mod queue)","tags":["Focus · Reddit"],"description":"Mark spoiler. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-spoiler","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/unspoiler":{"post":{"operationId":"redditModQueueUnspoiler","summary":"Reddit: Unmark spoiler (Mod queue)","tags":["Focus · Reddit"],"description":"Unmark spoiler. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-unspoiler","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/sticky":{"post":{"operationId":"redditModQueueSticky","summary":"Reddit: Pin / unpin (Mod queue)","tags":["Focus · Reddit"],"description":"Pin / unpin. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"boolean","default":true},"num":{"type":"integer","minimum":1,"maximum":6,"description":"Highlight slot (1–6)"},"to_profile":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-sticky","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/contest-mode":{"post":{"operationId":"redditModQueueContestMode","summary":"Reddit: Contest mode (Mod queue)","tags":["Focus · Reddit"],"description":"Contest mode. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"boolean","default":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-contest-mode","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/suggested-sort":{"post":{"operationId":"redditModQueueSuggestedSort","summary":"Reddit: Suggested sort (Mod queue)","tags":["Focus · Reddit"],"description":"Suggested sort. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sort":{"type":"string","enum":["confidence","top","new","controversial","old","random","qa","live","blank"]}},"required":["sort"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-suggested-sort","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-queue/{itemId}/crowd-control":{"post":{"operationId":"redditModQueueCrowdControl","summary":"Reddit: Crowd control level (Mod queue)","tags":["Focus · Reddit"],"description":"Crowd control level. Mod queue, reports, spam, edited and unmoderated items. Use subreddit \"mod\" for all your communities. Requires scopes: read, modposts. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-queue`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"level":{"type":"integer","minimum":0,"maximum":3}},"required":["level"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-queue-crowd-control","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-log":{"get":{"operationId":"redditModLogList","summary":"Reddit: List Mod log","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/log. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: modlog. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-log`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","default":"mod"},"in":"query","name":"subreddit","required":false},{"schema":{"type":"string"},"in":"query","name":"type","required":false,"description":"Action type, e.g. removelink, banuser, approvecomment"},{"schema":{"type":"string"},"in":"query","name":"mod","required":false,"description":"Moderator username (comma-separated)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-log-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"action":{"type":"string"},"mod":{"type":"string"},"subreddit":{"type":"string"},"target_fullname":{"type":["null","string"]},"target_author":{"type":["null","string"]},"target_title":{"type":["null","string"]},"target_body":{"type":["null","string"]},"target_permalink":{"type":["null","string"],"format":"uri"},"details":{"type":["null","string"]},"description":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail":{"get":{"operationId":"redditModmailList","summary":"Reddit: List Modmail","tags":["Focus · Reddit"],"description":"GET /api/mod/conversations. New modmail conversations for your communities (replies reach users via Reddit Chat). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["all","appeals","notifications","inbox","filtered","inprogress","mod","archived","default","highlighted","join_requests","new"],"default":"all"},"in":"query","name":"state","required":false},{"schema":{"type":"string"},"in":"query","name":"subreddits","required":false,"description":"Comma-separated subreddits (default: all)"},{"schema":{"type":"string","enum":["recent","mod","user","unread"],"default":"recent"},"in":"query","name":"sort","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"subject":{"type":"string","maxLength":100},"subreddit":{"type":"string"},"state":{"type":["null","integer"],"description":"0 new, 1 in progress, 2 archived, …"},"is_highlighted":{"type":"boolean"},"is_internal":{"type":"boolean"},"is_appeal":{"type":"boolean"},"num_messages":{"type":"integer"},"participant":{"type":["null","string"]},"authors":{"type":"array","items":{"type":"string"}},"last_updated":{"type":["null","string"],"format":"date-time"},"unread":{"type":"boolean"},"last_message":{"type":["null","string"]},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"author":{"type":"string"},"author_is_mod":{"type":"boolean"},"author_hidden":{"type":"boolean"},"is_internal":{"type":"boolean"},"sent_at":{"type":"string","format":"date-time"},"direction":{"type":"string","enum":["in","out"]}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditModmailCreate","summary":"Reddit: Create a Modmail item","tags":["Focus · Reddit"],"description":"POST /api/mod/conversations. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"to":{"type":"string","description":"username (omit for a mod discussion)"},"subject":{"type":"string","maxLength":100},"body":{"type":"string","minLength":1},"is_author_hidden":{"type":"boolean","default":false}},"required":["subreddit","subject","body"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"subject":{"type":"string","maxLength":100},"subreddit":{"type":"string"},"state":{"type":["null","integer"],"description":"0 new, 1 in progress, 2 archived, …"},"is_highlighted":{"type":"boolean"},"is_internal":{"type":"boolean"},"is_appeal":{"type":"boolean"},"num_messages":{"type":"integer"},"participant":{"type":["null","string"]},"authors":{"type":"array","items":{"type":"string"}},"last_updated":{"type":["null","string"],"format":"date-time"},"unread":{"type":"boolean"},"last_message":{"type":["null","string"]},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"author":{"type":"string"},"author_is_mod":{"type":"boolean"},"author_hidden":{"type":"boolean"},"is_internal":{"type":"boolean"},"sent_at":{"type":"string","format":"date-time"},"direction":{"type":"string","enum":["in","out"]}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}":{"get":{"operationId":"redditModmailGet","summary":"Reddit: Get a Modmail item","tags":["Focus · Reddit"],"description":"GET /api/mod/conversations/{id}. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","parameters":[{"schema":{"type":"boolean","default":false},"in":"query","name":"mark_read","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"subject":{"type":"string","maxLength":100},"subreddit":{"type":"string"},"state":{"type":["null","integer"],"description":"0 new, 1 in progress, 2 archived, …"},"is_highlighted":{"type":"boolean"},"is_internal":{"type":"boolean"},"is_appeal":{"type":"boolean"},"num_messages":{"type":"integer"},"participant":{"type":["null","string"]},"authors":{"type":"array","items":{"type":"string"}},"last_updated":{"type":["null","string"],"format":"date-time"},"unread":{"type":"boolean"},"last_message":{"type":["null","string"]},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"author":{"type":"string"},"author_is_mod":{"type":"boolean"},"author_hidden":{"type":"boolean"},"is_internal":{"type":"boolean"},"sent_at":{"type":"string","format":"date-time"},"direction":{"type":"string","enum":["in","out"]}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/reply":{"post":{"operationId":"redditModmailReply","summary":"Reddit: Reply (Modmail)","tags":["Focus · Reddit"],"description":"Reply. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"body":{"type":"string","minLength":1},"is_internal":{"type":"boolean","default":false,"description":"Private moderator note"},"is_author_hidden":{"type":"boolean","default":false,"description":"Reply as the subreddit"}},"required":["body"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/archive":{"post":{"operationId":"redditModmailArchive","summary":"Reddit: Archive (Modmail)","tags":["Focus · Reddit"],"description":"Archive. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-archive","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/unarchive":{"post":{"operationId":"redditModmailUnarchive","summary":"Reddit: Unarchive (Modmail)","tags":["Focus · Reddit"],"description":"Unarchive. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-unarchive","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/highlight":{"post":{"operationId":"redditModmailHighlight","summary":"Reddit: Highlight (Modmail)","tags":["Focus · Reddit"],"description":"Highlight. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-highlight","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/unhighlight":{"post":{"operationId":"redditModmailUnhighlight","summary":"Reddit: Remove highlight (Modmail)","tags":["Focus · Reddit"],"description":"Remove highlight. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-unhighlight","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/read":{"post":{"operationId":"redditModmailRead","summary":"Reddit: Mark read (Modmail)","tags":["Focus · Reddit"],"description":"Mark read. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/unread":{"post":{"operationId":"redditModmailUnread","summary":"Reddit: Mark unread (Modmail)","tags":["Focus · Reddit"],"description":"Mark unread. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-unread","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/mute":{"post":{"operationId":"redditModmailMute","summary":"Reddit: Mute user (Modmail)","tags":["Focus · Reddit"],"description":"Mute user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"num_hours":{"type":"integer","enum":[72,168,672],"default":72}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/unmute":{"post":{"operationId":"redditModmailUnmute","summary":"Reddit: Unmute user (Modmail)","tags":["Focus · Reddit"],"description":"Unmute user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-unmute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/temp-ban":{"post":{"operationId":"redditModmailTempBan","summary":"Reddit: Temporarily ban user (Modmail)","tags":["Focus · Reddit"],"description":"Temporarily ban user. New modmail conversations for your communities (replies reach users via Reddit Chat). Destructive. Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"duration":{"type":"integer","minimum":1,"maximum":999,"default":7,"description":"Days"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-temp-ban","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/unban":{"post":{"operationId":"redditModmailUnban","summary":"Reddit: Unban user (Modmail)","tags":["Focus · Reddit"],"description":"Unban user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-unban","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/approve":{"post":{"operationId":"redditModmailApprove","summary":"Reddit: Approve user (Modmail)","tags":["Focus · Reddit"],"description":"Approve user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/{itemId}/disapprove":{"post":{"operationId":"redditModmailDisapprove","summary":"Reddit: Remove approved user (Modmail)","tags":["Focus · Reddit"],"description":"Remove approved user. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-disapprove","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/modmail/unread-count":{"post":{"operationId":"redditModmailUnreadCount","summary":"Reddit: Unread counts (Modmail)","tags":["Focus · Reddit"],"description":"Unread counts. New modmail conversations for your communities (replies reach users via Reddit Chat). Requires scopes: modmail. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/modmail`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-modmail-unread-count","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/banned-users":{"get":{"operationId":"redditBannedUsersList","summary":"Reddit: List Banned users","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/banned. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/banned-users`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string"},"in":"query","name":"user","required":false,"description":"Find one user"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-banned-users-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditBannedUsersCreate","summary":"Reddit: Create a Banned users item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/friend type=banned. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/banned-users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"username":{"type":"string","minLength":1},"duration":{"type":"integer","minimum":1,"maximum":999,"description":"Days; omit for permanent"},"ban_reason":{"type":"string","maxLength":100,"description":"Reason (rule)"},"note":{"type":"string","maxLength":300,"description":"Private mod note"},"ban_message":{"type":"string","description":"Message sent to the user"},"ban_context":{"type":"string","description":"Fullname of the offending post/comment"}},"required":["subreddit","username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-banned-users-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/banned-users/{itemId}":{"delete":{"operationId":"redditBannedUsersDelete","summary":"Reddit: Delete a Banned users item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/unfriend type=banned. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/banned-users`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-banned-users-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/muted-users":{"get":{"operationId":"redditMutedUsersList","summary":"Reddit: List Muted users","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/muted. Users muted from modmail. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/muted-users`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string"},"in":"query","name":"user","required":false,"description":"Find one user"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-muted-users-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditMutedUsersCreate","summary":"Reddit: Create a Muted users item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/friend type=muted. Users muted from modmail. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/muted-users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"username":{"type":"string","minLength":1},"note":{"type":"string","maxLength":300}},"required":["subreddit","username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-muted-users-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/muted-users/{itemId}":{"delete":{"operationId":"redditMutedUsersDelete","summary":"Reddit: Delete a Muted users item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/unfriend type=muted. Users muted from modmail. Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/muted-users`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-muted-users-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/approved-users":{"get":{"operationId":"redditApprovedUsersList","summary":"Reddit: List Approved users","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/contributors. Approved contributors (can post in restricted/private communities). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/approved-users`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string"},"in":"query","name":"user","required":false,"description":"Find one user"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-approved-users-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditApprovedUsersCreate","summary":"Reddit: Create a Approved users item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/friend type=contributor. Approved contributors (can post in restricted/private communities). Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/approved-users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"username":{"type":"string","minLength":1}},"required":["subreddit","username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-approved-users-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/approved-users/{itemId}":{"delete":{"operationId":"redditApprovedUsersDelete","summary":"Reddit: Delete a Approved users item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/unfriend type=contributor. Approved contributors (can post in restricted/private communities). Requires scopes: read, modcontributors. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/approved-users`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-approved-users-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki-banned":{"get":{"operationId":"redditWikiBannedList","summary":"Reddit: List Wiki-banned users","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/wikibanned. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki-banned`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string"},"in":"query","name":"user","required":false,"description":"Find one user"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-banned-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditWikiBannedCreate","summary":"Reddit: Create a Wiki-banned users item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/friend type=wikibanned. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki-banned`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"username":{"type":"string","minLength":1},"duration":{"type":"integer","minimum":1,"maximum":999},"note":{"type":"string","maxLength":300}},"required":["subreddit","username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-banned-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki-banned/{itemId}":{"delete":{"operationId":"redditWikiBannedDelete","summary":"Reddit: Delete a Wiki-banned users item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/unfriend type=wikibanned. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki-banned`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-banned-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki-contributors":{"get":{"operationId":"redditWikiContributorsList","summary":"Reddit: List Wiki contributors","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/wikicontributors. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki-contributors`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string"},"in":"query","name":"user","required":false,"description":"Find one user"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-contributors-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditWikiContributorsCreate","summary":"Reddit: Create a Wiki contributors item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/friend type=wikicontributor. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki-contributors`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"username":{"type":"string","minLength":1}},"required":["subreddit","username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-contributors-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/wiki-contributors/{itemId}":{"delete":{"operationId":"redditWikiContributorsDelete","summary":"Reddit: Delete a Wiki contributors item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/unfriend type=wikicontributor. Requires scopes: read, modcontributors, modwiki. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/wiki-contributors`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-wiki-contributors-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/moderators":{"get":{"operationId":"redditModeratorsList","summary":"Reddit: List Moderators","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/moderators. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/moderators`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-moderators-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditModeratorsCreate","summary":"Reddit: Create a Moderators item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/friend type=moderator_invite. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/moderators`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"username":{"type":"string","minLength":1},"permissions":{"type":"array","items":{"type":"string","enum":["all","access","chat_config","chat_operator","config","flair","mail","posts","wiki","channels","community_chat"]},"default":["all"]}},"required":["subreddit","username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-moderators-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/moderators/{itemId}":{"patch":{"operationId":"redditModeratorsUpdate","summary":"Reddit: Update a Moderators item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/setpermissions. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/moderators`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"permissions":{"type":"array","items":{"type":"string","enum":["all","access","chat_config","chat_operator","config","flair","mail","posts","wiki","channels","community_chat"]}},"invite":{"type":"boolean","default":false,"description":"Change a pending invite instead"}},"required":["permissions"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-moderators-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"user_id":{"type":["null","string"]},"since":{"type":["null","string"],"format":"date-time"},"note":{"type":["null","string"]},"days_left":{"type":["null","integer"]},"permissions":{"type":["null","array"],"items":{"type":"string"}},"flair_text":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditModeratorsDelete","summary":"Reddit: Delete a Moderators item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/unfriend type=moderator. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/moderators`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-moderators-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/moderators/invited":{"post":{"operationId":"redditModeratorsInvited","summary":"Reddit: Pending invites (Moderators)","tags":["Focus · Reddit"],"description":"Pending invites. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/moderators`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1}},"required":["subreddit"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-moderators-invited","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/moderators/{itemId}/cancel-invite":{"post":{"operationId":"redditModeratorsCancelInvite","summary":"Reddit: Cancel invite (Moderators)","tags":["Focus · Reddit"],"description":"Cancel invite. Requires scopes: read, modothers. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/moderators`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-moderators-cancel-invite","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-notes":{"get":{"operationId":"redditModNotesList","summary":"Reddit: List Mod notes","tags":["Focus · Reddit"],"description":"GET /api/mod/notes. Private moderator notes about users (note ≤250 chars). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-notes`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1},"in":"query","name":"user","required":false},{"schema":{"type":"string","enum":["NOTE","APPROVAL","REMOVAL","BAN","MUTE","INVITE","SPAM","CONTENT_CHANGE","MOD_ACTION","ALL"],"default":"ALL"},"in":"query","name":"filter","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-notes-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:user:note_id"},"note_id":{"type":"string"},"type":{"type":["null","string"]},"subreddit":{"type":"string"},"user":{"type":"string"},"operator":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"note":{"type":["null","string"],"maxLength":250},"label":{"type":["null","string"],"enum":["BOT_BAN","PERMA_BAN","BAN","ABUSE_WARNING","SPAM_WARNING","SPAM_WATCH","SOLID_CONTRIBUTOR","HELPFUL_USER",null]},"reddit_id":{"type":["null","string"]},"action":{"type":["null","string"]},"details":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditModNotesCreate","summary":"Reddit: Create a Mod notes item","tags":["Focus · Reddit"],"description":"POST /api/mod/notes. Private moderator notes about users (note ≤250 chars). Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-notes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"user":{"type":"string"},"note":{"type":"string","minLength":1,"maxLength":250},"label":{"type":"string","enum":["BOT_BAN","PERMA_BAN","BAN","ABUSE_WARNING","SPAM_WARNING","SPAM_WATCH","SOLID_CONTRIBUTOR","HELPFUL_USER"]},"reddit_id":{"type":"string","description":"Related t3_/t1_ fullname"}},"required":["subreddit","user","note"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-notes-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:user:note_id"},"note_id":{"type":"string"},"type":{"type":["null","string"]},"subreddit":{"type":"string"},"user":{"type":"string"},"operator":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"note":{"type":["null","string"],"maxLength":250},"label":{"type":["null","string"],"enum":["BOT_BAN","PERMA_BAN","BAN","ABUSE_WARNING","SPAM_WARNING","SPAM_WATCH","SOLID_CONTRIBUTOR","HELPFUL_USER",null]},"reddit_id":{"type":["null","string"]},"action":{"type":["null","string"]},"details":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-notes/{itemId}":{"delete":{"operationId":"redditModNotesDelete","summary":"Reddit: Delete a Mod notes item","tags":["Focus · Reddit"],"description":"DELETE /api/mod/notes. Private moderator notes about users (note ≤250 chars). Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-notes`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-notes-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/mod-notes/recent":{"post":{"operationId":"redditModNotesRecent","summary":"Reddit: Latest note per user (Mod notes)","tags":["Focus · Reddit"],"description":"Latest note per user. Private moderator notes about users (note ≤250 chars). Requires scopes: modnote. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/mod-notes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddits":{"type":"array","items":{"type":"string"}},"users":{"type":"array","items":{"type":"string"}}},"required":["subreddits","users"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-mod-notes-recent","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/removal-reasons":{"get":{"operationId":"redditRemovalReasonsList","summary":"Reddit: List Removal reasons","tags":["Focus · Reddit"],"description":"GET /api/v1/{sr}/removal_reasons. Reusable removal reasons (undocumented endpoints; scope unverified). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/removal-reasons`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-removal-reasons-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:reason_id"},"reason_id":{"type":"string"},"subreddit":{"type":"string"},"title":{"type":"string","maxLength":50},"message":{"type":"string"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditRemovalReasonsCreate","summary":"Reddit: Create a Removal reasons item","tags":["Focus · Reddit"],"description":"POST /api/v1/{sr}/removal_reasons. Reusable removal reasons (undocumented endpoints; scope unverified). Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/removal-reasons`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"title":{"type":"string","minLength":1,"maxLength":50},"message":{"type":"string","minLength":1}},"required":["subreddit","title","message"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-removal-reasons-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:reason_id"},"reason_id":{"type":"string"},"subreddit":{"type":"string"},"title":{"type":"string","maxLength":50},"message":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/removal-reasons/{itemId}":{"patch":{"operationId":"redditRemovalReasonsUpdate","summary":"Reddit: Update a Removal reasons item","tags":["Focus · Reddit"],"description":"PUT /api/v1/{sr}/removal_reasons/{id}. Reusable removal reasons (undocumented endpoints; scope unverified). Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/removal-reasons`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":50},"message":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-removal-reasons-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:reason_id"},"reason_id":{"type":"string"},"subreddit":{"type":"string"},"title":{"type":"string","maxLength":50},"message":{"type":"string"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditRemovalReasonsDelete","summary":"Reddit: Delete a Removal reasons item","tags":["Focus · Reddit"],"description":"DELETE /api/v1/{sr}/removal_reasons/{id}. Reusable removal reasons (undocumented endpoints; scope unverified). Requires one of: modposts | modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/removal-reasons`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-removal-reasons-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/flair-templates":{"get":{"operationId":"redditFlairTemplatesList","summary":"Reddit: List Flair templates","tags":["Focus · Reddit"],"description":"GET /r/{sr}/api/link_flair_v2 | user_flair_v2. Create, edit, reorder and delete link (post) and user flair templates. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: flair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/flair-templates`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","enum":["LINK_FLAIR","USER_FLAIR"],"default":"LINK_FLAIR"},"in":"query","name":"flair_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-flair-templates-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:template_id"},"template_id":{"type":"string"},"subreddit":{"type":"string"},"flair_type":{"type":"string","enum":["LINK_FLAIR","USER_FLAIR"]},"text":{"type":"string","maxLength":64},"textColor":{"type":["null","string"],"enum":["light","dark",null]},"backgroundColor":{"type":["null","string"]},"textEditable":{"type":"boolean"},"modOnly":{"type":"boolean"},"allowableContent":{"type":"string","enum":["all","emoji","text"]},"maxEmojis":{"type":["null","integer"]},"cssClass":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditFlairTemplatesCreate","summary":"Reddit: Create a Flair templates item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/flairtemplate_v2. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/flair-templates`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"flair_type":{"type":"string","enum":["LINK_FLAIR","USER_FLAIR"],"default":"LINK_FLAIR"},"text":{"type":"string","maxLength":64},"text_color":{"type":"string","enum":["light","dark"]},"background_color":{"type":"string","pattern":"^#?[0-9a-fA-F]{6}$|^transparent$"},"css_class":{"type":"string"},"text_editable":{"type":"boolean","default":false},"mod_only":{"type":"boolean","default":false},"allowable_content":{"type":"string","enum":["all","emoji","text"],"default":"all"},"max_emojis":{"type":"integer","minimum":1,"maximum":10}},"required":["subreddit","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-flair-templates-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:template_id"},"template_id":{"type":"string"},"subreddit":{"type":"string"},"flair_type":{"type":"string","enum":["LINK_FLAIR","USER_FLAIR"]},"text":{"type":"string","maxLength":64},"textColor":{"type":["null","string"],"enum":["light","dark",null]},"backgroundColor":{"type":["null","string"]},"textEditable":{"type":"boolean"},"modOnly":{"type":"boolean"},"allowableContent":{"type":"string","enum":["all","emoji","text"]},"maxEmojis":{"type":["null","integer"]},"cssClass":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/flair-templates/{itemId}":{"patch":{"operationId":"redditFlairTemplatesUpdate","summary":"Reddit: Update a Flair templates item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/flairtemplate_v2 (flair_template_id). Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/flair-templates`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"flair_type":{"type":"string","enum":["LINK_FLAIR","USER_FLAIR"],"default":"LINK_FLAIR"},"text":{"type":"string","maxLength":64},"text_color":{"type":"string","enum":["light","dark"]},"background_color":{"type":"string","pattern":"^#?[0-9a-fA-F]{6}$|^transparent$"},"css_class":{"type":"string"},"text_editable":{"type":"boolean","default":false},"mod_only":{"type":"boolean","default":false},"allowable_content":{"type":"string","enum":["all","emoji","text"],"default":"all"},"max_emojis":{"type":"integer","minimum":1,"maximum":10}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-flair-templates-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:template_id"},"template_id":{"type":"string"},"subreddit":{"type":"string"},"flair_type":{"type":"string","enum":["LINK_FLAIR","USER_FLAIR"]},"text":{"type":"string","maxLength":64},"textColor":{"type":["null","string"],"enum":["light","dark",null]},"backgroundColor":{"type":["null","string"]},"textEditable":{"type":"boolean"},"modOnly":{"type":"boolean"},"allowableContent":{"type":"string","enum":["all","emoji","text"]},"maxEmojis":{"type":["null","integer"]},"cssClass":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditFlairTemplatesDelete","summary":"Reddit: Delete a Flair templates item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/deleteflairtemplate. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/flair-templates`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-flair-templates-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/flair-templates/reorder":{"post":{"operationId":"redditFlairTemplatesReorder","summary":"Reddit: Reorder templates (Flair templates)","tags":["Focus · Reddit"],"description":"Reorder templates. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/flair-templates`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"flair_type":{"type":"string","enum":["LINK_FLAIR","USER_FLAIR"]},"order":{"type":"array","items":{"type":"string"},"description":"template ids"}},"required":["subreddit","flair_type","order"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-flair-templates-reorder","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/flair-templates/clear-all":{"post":{"operationId":"redditFlairTemplatesClearAll","summary":"Reddit: Delete all templates (Flair templates)","tags":["Focus · Reddit"],"description":"Delete all templates. Create, edit, reorder and delete link (post) and user flair templates. Destructive. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/flair-templates`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"flair_type":{"type":"string","enum":["LINK_FLAIR","USER_FLAIR"]}},"required":["subreddit","flair_type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_reddit","x-mcp-tool":"reddit-flair-templates-clear-all","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/flair-templates/configure":{"post":{"operationId":"redditFlairTemplatesConfigure","summary":"Reddit: Flair settings (Flair templates)","tags":["Focus · Reddit"],"description":"Flair settings. Create, edit, reorder and delete link (post) and user flair templates. Requires scopes: flair, modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/flair-templates`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"flair_enabled":{"type":"boolean"},"flair_position":{"type":"string","enum":["left","right"]},"flair_self_assign_enabled":{"type":"boolean"},"link_flair_position":{"type":"string","enum":["","left","right"]},"link_flair_self_assign_enabled":{"type":"boolean"}},"required":["subreddit"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-flair-templates-configure","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/user-flairs":{"get":{"operationId":"redditUserFlairsList","summary":"Reddit: List User flair assignments","tags":["Focus · Reddit"],"description":"GET /r/{sr}/api/flairlist. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/user-flairs`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (Reddit `after` fullname)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string"},"in":"query","name":"user","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-user-flairs-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"flair_text":{"type":["null","string"],"maxLength":64},"flair_css_class":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditUserFlairsCreate","summary":"Reddit: Create a User flair assignments item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/flair | selectflair. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/user-flairs`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"username":{"type":"string","minLength":1},"text":{"type":"string","maxLength":64},"css_class":{"type":"string"},"flair_template_id":{"type":"string"}},"required":["subreddit","username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-user-flairs-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"flair_text":{"type":["null","string"],"maxLength":64},"flair_css_class":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/user-flairs/{itemId}":{"patch":{"operationId":"redditUserFlairsUpdate","summary":"Reddit: Update a User flair assignments item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/flair | selectflair. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/user-flairs`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":64},"css_class":{"type":"string"},"flair_template_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-user-flairs-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:username"},"subreddit":{"type":"string"},"username":{"type":"string"},"flair_text":{"type":["null","string"],"maxLength":64},"flair_css_class":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditUserFlairsDelete","summary":"Reddit: Delete a User flair assignments item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/deleteflair. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/user-flairs`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-user-flairs-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/user-flairs/bulk-set":{"post":{"operationId":"redditUserFlairsBulkSet","summary":"Reddit: Bulk set (CSV) (User flair assignments)","tags":["Focus · Reddit"],"description":"Up to 100 lines of \"user,text,css_class\" per call. Requires scopes: modflair. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/user-flairs`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"csv":{"type":"string"}},"required":["subreddit","csv"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-user-flairs-bulk-set","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddit-settings":{"get":{"operationId":"redditSubredditSettingsGet","summary":"Reddit: Get Community settings","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/edit. Subreddit settings. Updates are merged onto the current settings (site_admin needs the full set). Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddit-settings`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddit-settings-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"title":{"type":"string","maxLength":100},"public_description":{"type":"string","maxLength":500},"description":{"type":"string","description":"Old-reddit sidebar (markdown)"},"submit_text":{"type":"string"},"submit_link_label":{"type":"string","maxLength":60},"submit_text_label":{"type":"string","maxLength":60},"subreddit_type":{"type":"string","enum":["public","private","restricted","gold_restricted","archived","employees_only","gold_only"]},"content_options":{"type":"string","enum":["any","link","self"]},"over_18":{"type":"boolean"},"allow_images":{"type":"boolean"},"allow_videos":{"type":"boolean"},"allow_polls":{"type":"boolean"},"allow_galleries":{"type":"boolean"},"allow_post_crossposts":{"type":"boolean"},"spoilers_enabled":{"type":"boolean"},"original_content_tag_enabled":{"type":"boolean"},"allow_discovery":{"type":"boolean"},"default_set":{"type":"boolean","description":"Allow in r/all & popular"},"language":{"type":"string"},"welcome_message_enabled":{"type":"boolean"},"welcome_message_text":{"type":"string"},"wikimode":{"type":"string","enum":["disabled","modonly","anyone"]},"wiki_edit_age":{"type":"integer","minimum":0},"wiki_edit_karma":{"type":"integer","minimum":0},"spam_links":{"type":"string","enum":["low","high","all"]},"spam_selfposts":{"type":"string","enum":["low","high","all"]},"spam_comments":{"type":"string","enum":["low","high","all"]},"exclude_banned_modqueue":{"type":"boolean"},"collapse_deleted_comments":{"type":"boolean"},"comment_score_hide_mins":{"type":"integer","minimum":0,"maximum":1440},"suggested_comment_sort":{"type":["null","string"],"enum":["confidence","top","new","controversial","old","random","qa","live",null]},"show_media":{"type":"boolean"},"show_media_preview":{"type":"boolean"},"crowd_control_mode":{"type":"boolean"},"free_form_reports":{"type":"boolean"},"key_color":{"type":"string"},"header_hover_text":{"type":"string","maxLength":500}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"redditSubredditSettingsUpdate","summary":"Reddit: Update Community settings","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/edit → merge → POST /api/site_admin. Subreddit settings. Updates are merged onto the current settings (site_admin needs the full set). Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddit-settings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"title":{"type":"string","maxLength":100},"public_description":{"type":"string","maxLength":500},"description":{"type":"string","description":"Old-reddit sidebar (markdown)"},"submit_text":{"type":"string"},"submit_link_label":{"type":"string","maxLength":60},"submit_text_label":{"type":"string","maxLength":60},"subreddit_type":{"type":"string","enum":["public","private","restricted","gold_restricted","archived","employees_only","gold_only"]},"content_options":{"type":"string","enum":["any","link","self"]},"over_18":{"type":"boolean"},"allow_images":{"type":"boolean"},"allow_videos":{"type":"boolean"},"allow_polls":{"type":"boolean"},"allow_galleries":{"type":"boolean"},"allow_post_crossposts":{"type":"boolean"},"spoilers_enabled":{"type":"boolean"},"original_content_tag_enabled":{"type":"boolean"},"allow_discovery":{"type":"boolean"},"default_set":{"type":"boolean","description":"Allow in r/all & popular"},"language":{"type":"string"},"welcome_message_enabled":{"type":"boolean"},"welcome_message_text":{"type":"string"},"wikimode":{"type":"string","enum":["disabled","modonly","anyone"]},"wiki_edit_age":{"type":"integer","minimum":0},"wiki_edit_karma":{"type":"integer","minimum":0},"spam_links":{"type":"string","enum":["low","high","all"]},"spam_selfposts":{"type":"string","enum":["low","high","all"]},"spam_comments":{"type":"string","enum":["low","high","all"]},"exclude_banned_modqueue":{"type":"boolean"},"collapse_deleted_comments":{"type":"boolean"},"comment_score_hide_mins":{"type":"integer","minimum":0,"maximum":1440},"suggested_comment_sort":{"type":["string","null"],"enum":["confidence","top","new","controversial","old","random","qa","live",null]},"show_media":{"type":"boolean"},"show_media_preview":{"type":"boolean"},"crowd_control_mode":{"type":"boolean"},"free_form_reports":{"type":"boolean"},"key_color":{"type":"string"},"header_hover_text":{"type":"string","maxLength":500}},"required":["subreddit"],"additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddit-settings-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"title":{"type":"string","maxLength":100},"public_description":{"type":"string","maxLength":500},"description":{"type":"string","description":"Old-reddit sidebar (markdown)"},"submit_text":{"type":"string"},"submit_link_label":{"type":"string","maxLength":60},"submit_text_label":{"type":"string","maxLength":60},"subreddit_type":{"type":"string","enum":["public","private","restricted","gold_restricted","archived","employees_only","gold_only"]},"content_options":{"type":"string","enum":["any","link","self"]},"over_18":{"type":"boolean"},"allow_images":{"type":"boolean"},"allow_videos":{"type":"boolean"},"allow_polls":{"type":"boolean"},"allow_galleries":{"type":"boolean"},"allow_post_crossposts":{"type":"boolean"},"spoilers_enabled":{"type":"boolean"},"original_content_tag_enabled":{"type":"boolean"},"allow_discovery":{"type":"boolean"},"default_set":{"type":"boolean","description":"Allow in r/all & popular"},"language":{"type":"string"},"welcome_message_enabled":{"type":"boolean"},"welcome_message_text":{"type":"string"},"wikimode":{"type":"string","enum":["disabled","modonly","anyone"]},"wiki_edit_age":{"type":"integer","minimum":0},"wiki_edit_karma":{"type":"integer","minimum":0},"spam_links":{"type":"string","enum":["low","high","all"]},"spam_selfposts":{"type":"string","enum":["low","high","all"]},"spam_comments":{"type":"string","enum":["low","high","all"]},"exclude_banned_modqueue":{"type":"boolean"},"collapse_deleted_comments":{"type":"boolean"},"comment_score_hide_mins":{"type":"integer","minimum":0,"maximum":1440},"suggested_comment_sort":{"type":["null","string"],"enum":["confidence","top","new","controversial","old","random","qa","live",null]},"show_media":{"type":"boolean"},"show_media_preview":{"type":"boolean"},"crowd_control_mode":{"type":"boolean"},"free_form_reports":{"type":"boolean"},"key_color":{"type":"string"},"header_hover_text":{"type":"string","maxLength":500}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/stylesheet":{"get":{"operationId":"redditStylesheetGet","summary":"Reddit: Get Old-reddit stylesheet","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/stylesheet. Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/stylesheet`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-stylesheet-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string"},"stylesheet":{"type":"string"},"images":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"link":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"redditStylesheetUpdate","summary":"Reddit: Update Old-reddit stylesheet","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/subreddit_stylesheet. Requires scopes: modconfig. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/stylesheet`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"stylesheet":{"type":"string"},"reason":{"type":"string","maxLength":256}},"required":["subreddit","stylesheet"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-stylesheet-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string"},"stylesheet":{"type":"string"},"images":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"link":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/widgets":{"get":{"operationId":"redditWidgetsList","summary":"Reddit: List Sidebar widgets","tags":["Focus · Reddit"],"description":"GET /r/{sr}/api/widgets. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/widgets`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-widgets-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:widget_id"},"widget_id":{"type":"string"},"subreddit":{"type":"string"},"section":{"type":"string","enum":["sidebar","topbar","idcard","moderators"]},"kind":{"type":"string"},"short_name":{"type":["null","string"]},"data":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditWidgetsCreate","summary":"Reddit: Create a Sidebar widgets item","tags":["Focus · Reddit"],"description":"POST /r/{sr}/api/widget. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/widgets`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"widget":{"type":"object","properties":{"kind":{"type":"string"},"shortName":{"type":"string"}},"additionalProperties":true,"required":["kind"]}},"required":["subreddit","widget"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-widgets-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:widget_id"},"widget_id":{"type":"string"},"subreddit":{"type":"string"},"section":{"type":"string","enum":["sidebar","topbar","idcard","moderators"]},"kind":{"type":"string"},"short_name":{"type":["null","string"]},"data":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/widgets/{itemId}":{"patch":{"operationId":"redditWidgetsUpdate","summary":"Reddit: Update a Sidebar widgets item","tags":["Focus · Reddit"],"description":"PUT /r/{sr}/api/widget/{id}. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/widgets`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"widget":{"type":"object","properties":{},"additionalProperties":true}},"required":["widget"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_reddit","x-mcp-tool":"reddit-widgets-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:widget_id"},"widget_id":{"type":"string"},"subreddit":{"type":"string"},"section":{"type":"string","enum":["sidebar","topbar","idcard","moderators"]},"kind":{"type":"string"},"short_name":{"type":["null","string"]},"data":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"redditWidgetsDelete","summary":"Reddit: Delete a Sidebar widgets item","tags":["Focus · Reddit"],"description":"DELETE /r/{sr}/api/widget/{id}. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/widgets`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-widgets-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/widgets/reorder":{"post":{"operationId":"redditWidgetsReorder","summary":"Reddit: Reorder sidebar (Sidebar widgets)","tags":["Focus · Reddit"],"description":"Reorder sidebar. New-reddit widgets (text, button, community list, calendar, rules, images…). Bodies follow Reddit widget JSON. Requires scopes: structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/widgets`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"section":{"type":"string","enum":["sidebar"]},"order":{"type":"array","items":{"type":"string"}}},"required":["subreddit","order"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_reddit","x-mcp-tool":"reddit-widgets-reorder","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/emojis":{"get":{"operationId":"redditEmojisList","summary":"Reddit: List Emojis","tags":["Focus · Reddit"],"description":"GET /api/v1/{sr}/emojis/all. Custom subreddit emojis for flair and comments. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: read. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/emojis`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-emojis-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:name"},"subreddit":{"type":"string"},"name":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,24}$"},"url":{"type":"string","format":"uri"},"mod_flair_only":{"type":"boolean"},"post_flair_allowed":{"type":"boolean"},"user_flair_allowed":{"type":"boolean"},"created_by":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"redditEmojisCreate","summary":"Reddit: Create a Emojis item","tags":["Focus · Reddit"],"description":"POST /api/v1/{sr}/emoji_asset_upload_s3.json → S3 → POST /api/v1/{sr}/emoji.json. Custom subreddit emojis for flair and comments. Requires scopes: read, structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/emojis`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name without r/","minLength":1},"name":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,24}$"},"image":{"type":"string"},"mod_flair_only":{"type":"boolean","default":false},"post_flair_allowed":{"type":"boolean","default":true},"user_flair_allowed":{"type":"boolean","default":true}},"required":["subreddit","name","image"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_reddit","x-mcp-tool":"reddit-emojis-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"subreddit:name"},"subreddit":{"type":"string"},"name":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,24}$"},"url":{"type":"string","format":"uri"},"mod_flair_only":{"type":"boolean"},"post_flair_allowed":{"type":"boolean"},"user_flair_allowed":{"type":"boolean"},"created_by":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/emojis/{itemId}":{"delete":{"operationId":"redditEmojisDelete","summary":"Reddit: Delete a Emojis item","tags":["Focus · Reddit"],"description":"DELETE /api/v1/{sr}/emoji/{name}. Custom subreddit emojis for flair and comments. Requires scopes: read, structuredstyles. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/emojis`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_reddit","x-mcp-tool":"reddit-emojis-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/traffic":{"get":{"operationId":"redditTrafficList","summary":"Reddit: List Community traffic","tags":["Focus · Reddit"],"description":"GET /r/{sr}/about/traffic. Uniques, pageviews and new subscribers of a subreddit you moderate. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: modconfig | modtraffic. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/traffic`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"subreddit","required":false,"description":"Subreddit name without r/"},{"schema":{"type":"string","enum":["day","hour","month"],"default":"day"},"in":"query","name":"period","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-traffic-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"uniques":{"type":"integer"},"pageviews":{"type":"integer"},"subscriptions":{"type":"integer"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/karma":{"get":{"operationId":"redditKarmaList","summary":"Reddit: List Karma by subreddit","tags":["Focus · Reddit"],"description":"GET /api/v1/me/karma. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: mysubreddits. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/karma`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-karma-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"subreddit":{"type":"string"},"link_karma":{"type":"integer"},"comment_karma":{"type":"integer"},"total":{"type":"integer"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/post-performance":{"get":{"operationId":"redditPostPerformanceList","summary":"Reddit: List Post performance","tags":["Focus · Reddit"],"description":"GET /user/{me}/submitted (aggregated). Daily upvotes, comments and crossposts of posts you created in the period (by post creation day). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/post-performance`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-post-performance-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"likes":{"type":"integer"},"comments":{"type":"integer"},"shares":{"type":"integer"},"engagements":{"type":"integer"},"posts":{"type":"integer"},"followers":{"type":["null","integer"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/subreddit-performance":{"get":{"operationId":"redditSubredditPerformanceList","summary":"Reddit: List Performance by subreddit","tags":["Focus · Reddit"],"description":"GET /user/{me}/submitted (aggregated per subreddit). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/subreddit-performance`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-subreddit-performance-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"subreddit":{"type":"string"},"posts":{"type":"integer"},"total_score":{"type":"integer"},"avg_score":{"type":"number"},"avg_upvote_ratio":{"type":["null","number"]},"total_comments":{"type":"integer"},"avg_comments":{"type":"number"},"removed":{"type":"integer"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/reddit/best-times":{"get":{"operationId":"redditBestTimesList","summary":"Reddit: List Best times to post","tags":["Focus · Reddit"],"description":"GET /user/{me}/submitted (aggregated by weekday × hour). Average score and comments of your posts by UTC weekday (0 = Sunday) and hour. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: history. Network docs: https://www.reddit.com/dev/api/ Generic route: `/v1/accounts/{accountId}/focus/best-times`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_reddit","x-mcp-tool":"reddit-best-times-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"weekday":{"type":"integer","minimum":0,"maximum":6},"hour":{"type":"integer","minimum":0,"maximum":23},"posts":{"type":"integer"},"avg_score":{"type":"number"},"avg_comments":{"type":"number"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/profile":{"get":{"operationId":"snapchatProfileGet","summary":"Snapchat: Get Profile","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id} + lifetime profile stats. Public Profile details and headline numbers. Snap profile APIs are read only: edit name, bio and avatar in the Snapchat app. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Profiles Generic route: `/v1/accounts/{accountId}/focus/profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"display_name":{"type":"string"},"username":{"type":"string"},"description":{"type":["null","string"]},"profile_image_url":{"type":["null","string"],"format":"uri"},"subscriber_count":{"type":["null","integer"]},"organization_id":{"type":["null","string"]},"organization_name":{"type":["null","string"]},"category":{"type":["null","string"]},"subcategory":{"type":["null","string"]},"internal_profile_category":{"type":["null","string"],"enum":["UNKNOWN","BUSINESS","PERSON","PUBLISHER",null]},"profile_type":{"type":["null","string"],"enum":["STORY_STUDIO_PUBLISHER","PUBLISHER_WITH_HOST_USER","PUBLIC_PROFILE","PUBLIC_PROFILE_WITH_PUBLISHER_CONTENT",null]},"profile_tier":{"type":["null","string"],"enum":["TIER_UNKNOWN","TIER_STANDARD","TIER_PUBLIC","TIER_PUBLIC_OFFICIAL",null]},"email":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"website":{"type":["null","string"],"format":"uri"},"address":{"type":["null","object"],"properties":{"line_1":{"type":["null","string"]},"line_2":{"type":["null","string"]},"line_3":{"type":["null","string"]},"locality":{"type":["null","string"]},"region":{"type":["null","string"]},"district":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"country_code_90d":{"type":["null","string"]},"primary_color":{"type":["null","string"]},"share_insights":{"type":["null","boolean"]},"share_expired_stories":{"type":["null","boolean"]},"url":{"type":["null","string"],"format":"uri"},"views_total":{"type":["null","number"],"readOnly":true},"viewers_total":{"type":["null","number"],"readOnly":true},"profile_views_total":{"type":["null","number"],"readOnly":true},"story_views_total":{"type":["null","number"],"readOnly":true},"saved_story_views_total":{"type":["null","number"],"readOnly":true},"spotlight_views_total":{"type":["null","number"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/profiles":{"get":{"operationId":"snapchatProfilesList","summary":"Snapchat: List Managed profiles","tags":["Focus · Snapchat"],"description":"GET my_profile + GET /v1/organizations/{id}/public_profiles. Every Public Profile this login can manage (my_profile + organization profiles). Connect another one to switch. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Profiles Generic route: `/v1/accounts/{accountId}/focus/profiles`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-profiles-list","x-zernio":["GET /v1/connect/snapchat/select-profile","POST /v1/connect/snapchat/select-profile"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"display_name":{"type":"string"},"username":{"type":"string"},"description":{"type":["null","string"]},"profile_image_url":{"type":["null","string"],"format":"uri"},"subscriber_count":{"type":["null","integer"]},"organization_id":{"type":["null","string"]},"organization_name":{"type":["null","string"]},"category":{"type":["null","string"]},"subcategory":{"type":["null","string"]},"internal_profile_category":{"type":["null","string"],"enum":["UNKNOWN","BUSINESS","PERSON","PUBLISHER",null]},"profile_type":{"type":["null","string"],"enum":["STORY_STUDIO_PUBLISHER","PUBLISHER_WITH_HOST_USER","PUBLIC_PROFILE","PUBLIC_PROFILE_WITH_PUBLISHER_CONTENT",null]},"profile_tier":{"type":["null","string"],"enum":["TIER_UNKNOWN","TIER_STANDARD","TIER_PUBLIC","TIER_PUBLIC_OFFICIAL",null]},"email":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"website":{"type":["null","string"],"format":"uri"},"address":{"type":["null","object"],"properties":{"line_1":{"type":["null","string"]},"line_2":{"type":["null","string"]},"line_3":{"type":["null","string"]},"locality":{"type":["null","string"]},"region":{"type":["null","string"]},"district":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"country_code_90d":{"type":["null","string"]},"primary_color":{"type":["null","string"]},"share_insights":{"type":["null","boolean"]},"share_expired_stories":{"type":["null","boolean"]},"url":{"type":["null","string"],"format":"uri"},"connected":{"type":"boolean","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/organizations":{"get":{"operationId":"snapchatOrganizationsList","summary":"Snapchat: List Organizations","tags":["Focus · Snapchat"],"description":"GET adsapi /v1/me/organizations?with_ad_accounts=true. Snap Business Manager organizations and their ad accounts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/organizations Generic route: `/v1/accounts/{accountId}/focus/organizations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-organizations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"type":{"type":["null","string"]},"country":{"type":["null","string"]},"state":{"type":["null","string"]},"ad_account_count":{"type":"integer","readOnly":true},"ad_accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":["null","string"]},"status":{"type":["null","string"]},"currency":{"type":["null","string"]},"timezone":{"type":["null","string"]}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/stories":{"get":{"operationId":"snapchatStoriesList","summary":"Snapchat: List Stories","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/stories. Public Stories (active and expired). Posting adds one snap; there is no caption field and Story snaps cannot be deleted via the API. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/stories`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-stories-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"profile_id":{"type":["null","string"]},"type":{"type":"string","default":"PUBLIC_STORY"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"active":{"type":"boolean","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"snapchatStoriesCreate","summary":"Snapchat: Create a Stories item","tags":["Focus · Snapchat"],"description":"Encrypt + upload media, then POST /v1/public_profiles/{profile_id}/stories. Public Stories (active and expired). Posting adds one snap; there is no caption field and Story snaps cannot be deleted via the API. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/stories`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string","description":"One image (JPEG/PNG) or MP4 video (5-60 s), 9:16, ≥540x960"},"ttl":{"type":"string","enum":["ONE_DAY","TWO_DAYS","THREE_DAYS","ONE_WEEK"],"default":"ONE_DAY"}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-stories-create","x-idempotent":true,"x-zernio":["POST /v1/posts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"profile_id":{"type":["null","string"]},"type":{"type":"string","default":"PUBLIC_STORY"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"active":{"type":"boolean","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/stories/reconcile":{"post":{"operationId":"snapchatStoriesReconcile","summary":"Snapchat: Find posted snap (Stories)","tags":["Focus · Snapchat"],"description":"Look up the newest snap (Story POST returns no id). Public Stories (active and expired). Posting adds one snap; there is no caption field and Story snaps cannot be deleted via the API. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/stories`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date-time"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-stories-reconcile","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/story-snaps":{"get":{"operationId":"snapchatStorySnapsList","summary":"Snapchat: List Story snaps","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/stories/{story_id}/snaps. Snaps inside a Story. Time bounds are filled from the story to avoid timeouts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/story-snaps`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string"},"in":"query","name":"story_id","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"created_at","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"ended_at","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-story-snaps-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"story_id":{"type":["null","string"]},"media_type":{"type":["null","string"],"enum":["IMAGE","VIDEO",null]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"title":{"type":["null","string"]},"caption":{"type":["null","string"]},"link":{"type":["null","string"],"format":"uri"},"ml_tags":{"type":["null","array"],"items":{"type":"string"},"description":"Image tags (extra allowlist)"},"external_id":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/story-snaps/{itemId}/promote":{"post":{"operationId":"snapchatStorySnapsPromote","summary":"Snapchat: Promote (Story snaps)","tags":["Focus · Snapchat"],"description":"Claim into an ad account and create a paused creative / ad (Ads API). Snaps inside a Story. Time bounds are filled from the story to avoid timeouts. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/story-snaps`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad_account_id":{"type":"string","description":"Ad account to claim the media into"},"ad_squad_id":{"type":["string","null"],"description":"Existing ad squad for the new (paused) ad"},"new_campaign":{"type":["object","null"],"properties":{"name":{"type":"string"},"objective":{"type":"string","default":"AWARENESS_AND_ENGAGEMENT"},"daily_budget_micro":{"type":"integer","description":"Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)"},"country_codes":{"type":"array","items":{"type":"string"},"default":["us"]}}},"headline":{"type":["string","null"],"maxLength":34},"call_to_action":{"type":["string","null"]},"wait_for_ready":{"type":"boolean","default":true}},"required":["ad_account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-story-snaps-promote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/saved-stories":{"get":{"operationId":"snapchatSavedStoriesList","summary":"Snapchat: List Saved Stories","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/saved_stories. Permanent Stories on the profile. No edit endpoint exists: delete and recreate to rename or reorder. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/saved-stories`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","enum":["ALL","VISIBLE_ON_PROFILE"],"default":"ALL"},"in":"query","name":"visibility","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-saved-stories-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":45},"type":{"type":"string","default":"SAVED_STORY"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"external_id":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"snapchatSavedStoriesCreate","summary":"Snapchat: Create a Saved Stories item","tags":["Focus · Snapchat"],"description":"POST /v1/public_profiles/{profile_id}/saved_stories (one per request, ≤ 5 min total). Permanent Stories on the profile. No edit endpoint exists: delete and recreate to rename or reorder. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/saved-stories`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":45},"media":{"type":"array","items":{"type":"string"},"description":"New media, uploaded in order after `sources`"},"sources":{"type":"array","items":{"type":"object","properties":{"snap_id":{"type":"string"},"spotlight_id":{"type":"string"},"media_id":{"type":"string","description":"Snap media id (uploaded < 24h ago)"}}},"description":"Existing snaps / spotlights / uploaded media, in playback order"}},"required":["title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-saved-stories-create","x-idempotent":true,"x-zernio":["POST /v1/posts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":45},"type":{"type":"string","default":"SAVED_STORY"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"external_id":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/saved-stories/{itemId}":{"delete":{"operationId":"snapchatSavedStoriesDelete","summary":"Snapchat: Delete a Saved Stories item","tags":["Focus · Snapchat"],"description":"DELETE /v1/public_profiles/{profile_id}/saved_stories/{id} (permanent). Permanent Stories on the profile. No edit endpoint exists: delete and recreate to rename or reorder. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/saved-stories`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-saved-stories-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/saved-stories/{itemId}/promote":{"post":{"operationId":"snapchatSavedStoriesPromote","summary":"Snapchat: Promote (Saved Stories)","tags":["Focus · Snapchat"],"description":"Claim into an ad account and create a paused creative / ad (Ads API). Permanent Stories on the profile. No edit endpoint exists: delete and recreate to rename or reorder. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/saved-stories`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad_account_id":{"type":"string","description":"Ad account to claim the media into"},"ad_squad_id":{"type":["string","null"],"description":"Existing ad squad for the new (paused) ad"},"new_campaign":{"type":["object","null"],"properties":{"name":{"type":"string"},"objective":{"type":"string","default":"AWARENESS_AND_ENGAGEMENT"},"daily_budget_micro":{"type":"integer","description":"Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)"},"country_codes":{"type":"array","items":{"type":"string"},"default":["us"]}}},"headline":{"type":["string","null"],"maxLength":34},"call_to_action":{"type":["string","null"]},"wait_for_ready":{"type":"boolean","default":true}},"required":["ad_account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-saved-stories-promote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/saved-story-snaps":{"get":{"operationId":"snapchatSavedStorySnapsList","summary":"Snapchat: List Saved Story snaps","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/saved_stories/{id}/snaps. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/saved-story-snaps`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string"},"in":"query","name":"saved_story_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-saved-story-snaps-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"story_id":{"type":["null","string"]},"media_type":{"type":["null","string"],"enum":["IMAGE","VIDEO",null]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"title":{"type":["null","string"]},"caption":{"type":["null","string"]},"link":{"type":["null","string"],"format":"uri"},"ml_tags":{"type":["null","array"],"items":{"type":"string"},"description":"Image tags (extra allowlist)"},"external_id":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/spotlights":{"get":{"operationId":"snapchatSpotlightsList","summary":"Snapchat: List Spotlight","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/spotlights. Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/spotlights`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-spotlights-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status":{"type":"string","enum":["SUBMITTED","LIVE","REJECTED"],"readOnly":true},"title":{"type":["null","string"]},"description":{"type":["null","string"],"maxLength":160},"hashtags":{"type":"array","items":{"type":"string"}},"duration":{"type":["null","number"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"link":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time","readOnly":true},"sponsor":{"type":["null","object"],"properties":{"profile_id":{"type":"string"},"display_name":{"type":"string"},"sponsor_status":{"type":"string"}}},"url":{"type":["null","string"],"format":"uri"},"external_id":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"snapchatSpotlightsCreate","summary":"Snapchat: Create a Spotlight item","tags":["Focus · Snapchat"],"description":"Encrypt + upload video, then POST /v1/public_profiles/{profile_id}/spotlights. Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/spotlights`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string","description":"MP4 video, 6-60 s, 9:16, ≥540x960"},"description":{"type":"string","maxLength":160,"description":"Inline #hashtags allowed"},"hashtags":{"type":"array","items":{"type":"string"}},"locale":{"type":"string","default":"en_US"}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-spotlights-create","x-idempotent":true,"x-zernio":["POST /v1/posts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status":{"type":"string","enum":["SUBMITTED","LIVE","REJECTED"],"readOnly":true},"title":{"type":["null","string"]},"description":{"type":["null","string"],"maxLength":160},"hashtags":{"type":"array","items":{"type":"string"}},"duration":{"type":["null","number"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"link":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time","readOnly":true},"sponsor":{"type":["null","object"],"properties":{"profile_id":{"type":"string"},"display_name":{"type":"string"},"sponsor_status":{"type":"string"}}},"url":{"type":["null","string"],"format":"uri"},"external_id":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/spotlights/{itemId}":{"get":{"operationId":"snapchatSpotlightsGet","summary":"Snapchat: Get a Spotlight item","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/spotlights/{id}. Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/spotlights`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-spotlights-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"status":{"type":"string","enum":["SUBMITTED","LIVE","REJECTED"],"readOnly":true},"title":{"type":["null","string"]},"description":{"type":["null","string"],"maxLength":160},"hashtags":{"type":"array","items":{"type":"string"}},"duration":{"type":["null","number"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"link":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time","readOnly":true},"sponsor":{"type":["null","object"],"properties":{"profile_id":{"type":"string"},"display_name":{"type":"string"},"sponsor_status":{"type":"string"}}},"url":{"type":["null","string"],"format":"uri"},"external_id":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"snapchatSpotlightsDelete","summary":"Snapchat: Delete a Spotlight item","tags":["Focus · Snapchat"],"description":"DELETE /v1/public_profiles/{profile_id}/spotlights/{id}. Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/spotlights`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-spotlights-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/spotlights/{itemId}/check-status":{"post":{"operationId":"snapchatSpotlightsCheckStatus","summary":"Snapchat: Check moderation status (Spotlight)","tags":["Focus · Snapchat"],"description":"Poll SUBMITTED → LIVE / REJECTED. Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/spotlights`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-spotlights-check-status","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/spotlights/{itemId}/promote":{"post":{"operationId":"snapchatSpotlightsPromote","summary":"Snapchat: Promote (Spotlight)","tags":["Focus · Snapchat"],"description":"Claim into an ad account and create a paused creative / ad (Ads API). Spotlight videos. New posts are moderated asynchronously (SUBMITTED → LIVE or REJECTED). Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/spotlights`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad_account_id":{"type":"string","description":"Ad account to claim the media into"},"ad_squad_id":{"type":["string","null"],"description":"Existing ad squad for the new (paused) ad"},"new_campaign":{"type":["object","null"],"properties":{"name":{"type":"string"},"objective":{"type":"string","default":"AWARENESS_AND_ENGAGEMENT"},"daily_budget_micro":{"type":"integer","description":"Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)"},"country_codes":{"type":"array","items":{"type":"string"},"default":["us"]}}},"headline":{"type":["string","null"],"maxLength":34},"call_to_action":{"type":["string","null"]},"wait_for_ready":{"type":"boolean","default":true}},"required":["ad_account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-spotlights-promote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/lenses":{"get":{"operationId":"snapchatLensesList","summary":"Snapchat: List Lenses","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/lenses. Lenses on the profile (read only; Lenses are built in Lens Studio). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/lenses`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-lenses-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"status":{"type":["null","string"]},"icon_url":{"type":["null","string"],"format":"uri"},"snapcode":{"type":["null","object"],"properties":{},"additionalProperties":true},"preview_media":{"type":["null","object"],"properties":{},"additionalProperties":true},"rejection_errors":{"type":["null","array"],"items":{"type":"object","properties":{},"additionalProperties":true}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"updated_by":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/lenses/{itemId}":{"get":{"operationId":"snapchatLensesGet","summary":"Snapchat: Get a Lenses item","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/lenses/{id}. Lenses on the profile (read only; Lenses are built in Lens Studio). Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/lenses`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-lenses-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"status":{"type":["null","string"]},"icon_url":{"type":["null","string"],"format":"uri"},"snapcode":{"type":["null","object"],"properties":{},"additionalProperties":true},"preview_media":{"type":["null","object"],"properties":{},"additionalProperties":true},"rejection_errors":{"type":["null","array"],"items":{"type":"object","properties":{},"additionalProperties":true}},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"updated_by":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/shared-snaps":{"get":{"operationId":"snapchatSharedSnapsList","summary":"Snapchat: List Collaboration snaps","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/shared_snaps. Paid-partnership snaps from creators that tag this brand profile. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: `/v1/accounts/{accountId}/focus/shared-snaps`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"boolean","default":true},"in":"query","name":"aggregate","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-shared-snaps-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"story_id":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"media_type":{"type":["null","string"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"sponsor_status":{"type":["null","string"],"enum":["PENDING","REJECTED","NOT_SPECIFIED","AUTO_APPROVED",null]},"display_name":{"type":["null","string"]},"username":{"type":["null","string"]},"story_type":{"type":["null","string"]},"multi_snaps_bundle_id":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/shared-snaps/{itemId}/promote":{"post":{"operationId":"snapchatSharedSnapsPromote","summary":"Snapchat: Promote (Collaboration snaps)","tags":["Focus · Snapchat"],"description":"Claim into an ad account and create a paused creative / ad (Ads API). Paid-partnership snaps from creators that tag this brand profile. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: `/v1/accounts/{accountId}/focus/shared-snaps`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad_account_id":{"type":"string","description":"Ad account to claim the media into"},"ad_squad_id":{"type":["string","null"],"description":"Existing ad squad for the new (paused) ad"},"new_campaign":{"type":["object","null"],"properties":{"name":{"type":"string"},"objective":{"type":"string","default":"AWARENESS_AND_ENGAGEMENT"},"daily_budget_micro":{"type":"integer","description":"Ad squad daily budget in micro-currency (e.g. 20000000 = 20.00)"},"country_codes":{"type":"array","items":{"type":"string"},"default":["us"]}}},"headline":{"type":["string","null"],"maxLength":34},"call_to_action":{"type":["string","null"]},"wait_for_ready":{"type":"boolean","default":true}},"required":["ad_account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-shared-snaps-promote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/media":{"post":{"operationId":"snapchatMediaCreate","summary":"Snapchat: Create a Media uploads item","tags":["Focus · Snapchat"],"description":"POST /v1/public_profiles/{profile_id}/media → ADD parts → FINALIZE. Encrypted (AES-256-CBC) upload to Snap, e.g. to compose a Saved Story. Snap media expires 24h after upload, so upload right before posting. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string"}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-media-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["IMAGE","VIDEO"]},"name":{"type":"string"},"parts":{"type":"integer","readOnly":true},"size":{"type":"integer","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"expires_at":{"type":"string","format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/profile-insights":{"get":{"operationId":"snapchatProfileInsightsList","summary":"Snapchat: List Profile insights","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/stats?granularity=DAY (+ TOTAL for period totals). Daily views, unique viewers, profile views, subscribers, shares and watch time (last 90 days max). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Metrics Generic route: `/v1/accounts/{accountId}/focus/profile-insights`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (≤ 90 days back)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD, inclusive"},{"schema":{"type":"array","items":{"type":"string"}},"in":"query","name":"fields","required":false,"description":"Snap field names (default: all PROFILE fields)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-profile-insights-list","x-zernio":["GET /v1/analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"views":{"type":["null","number"]},"reach":{"type":["null","number"],"description":"Unique viewers"},"profile_views":{"type":["null","number"]},"followers":{"type":["null","number"],"description":"Subscribers"},"follower_change":{"type":["null","number"],"description":"Subscribes − unsubscribes"},"shares":{"type":["null","number"]},"likes":{"type":["null","number"],"description":"Favorites"},"comments":{"type":["null","number"],"description":"Replies"},"clicks":{"type":["null","number"],"description":"Swipe ups"},"engagements":{"type":["null","number"],"description":"Interactions"},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"native":{"type":["null","object"],"properties":{},"additionalProperties":{"type":"number"},"description":"Raw Snap fields (SCREENSHOTS, COMPLETES, …)"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/audience":{"get":{"operationId":"snapchatAudienceList","summary":"Snapchat: List Audience","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/stats?breakdownDimensions=…. Viewer or subscriber demographics: age × gender, country, region, OS, subscription. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Metrics Generic route: `/v1/accounts/{accountId}/focus/audience`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (≤ 90 days back)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD, inclusive"},{"schema":{"type":"string","enum":["AGE","GENDER","COUNTRY","REGION","OS","SUBSCRIPTION","AGE_GENDER","COUNTRY_GENDER","COUNTRY_AGE","COUNTRY_SUBSCRIPTION"],"default":"AGE_GENDER"},"in":"query","name":"dimension","required":false},{"schema":{"type":"string","enum":["VIEWERS","VIEWS","SUBSCRIBERS"],"default":"VIEWERS"},"in":"query","name":"metric","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-audience-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string","enum":["AGE","GENDER","COUNTRY","REGION","OS","SUBSCRIPTION","AGE_GENDER","COUNTRY_GENDER","COUNTRY_AGE","COUNTRY_SUBSCRIPTION"]},"key":{"type":"string"},"age":{"type":["null","string"]},"gender":{"type":["null","string"]},"value":{"type":"number"},"percentage":{"type":["null","number"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/content-insights":{"get":{"operationId":"snapchatContentInsightsList","summary":"Snapchat: List Content performance","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/stats?assetType=STORY|SAVED_STORY|SPOTLIGHT|LENS. Per-asset performance for Stories, Saved Stories, Spotlights or Lenses, sorted by a metric. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Metrics Generic route: `/v1/accounts/{accountId}/focus/content-insights`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (≤ 90 days back)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD, inclusive"},{"schema":{"type":"string","enum":["stories","saved_stories","spotlights","lenses"],"default":"spotlights"},"in":"query","name":"asset_type","required":false},{"schema":{"type":"string","default":"VIEWS"},"in":"query","name":"sort","required":false},{"schema":{"type":"integer","minimum":10,"maximum":1000,"default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-content-insights-list","x-zernio":["GET /v1/analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string"},"asset_type":{"type":"string","enum":["STORY","SAVED_STORY","SPOTLIGHT","LENS"]},"VIEWS":{"type":["null","number"]},"VIEWERS":{"type":["null","number"]},"SHARES":{"type":["null","number"]},"INTERACTIONS":{"type":["null","number"]},"SWIPE_UPS":{"type":["null","number"]},"VIEW_TIME_MILLIS":{"type":["null","number"]},"AVG_VIEW_TIME_MILLIS":{"type":["null","number"]},"FAVORITES":{"type":["null","number"]},"SCREENSHOTS":{"type":["null","number"]},"REPLIES":{"type":["null","number"]},"COMPLETES":{"type":["null","number"]},"LENS_PLAYS":{"type":["null","number"]},"SCANS":{"type":["null","number"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/asset-insights":{"get":{"operationId":"snapchatAssetInsightsList","summary":"Snapchat: List Post insights","tags":["Focus · Snapchat"],"description":"GET …/{stories|saved_stories|spotlights}/{id}/stats or /v1/snaps/{id}/stats. Timeseries or breakdown for one Story, Story snap, Saved Story, Spotlight or Lens. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Metrics Generic route: `/v1/accounts/{accountId}/focus/asset-insights`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (≤ 90 days back)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD, inclusive"},{"schema":{"type":"string"},"in":"query","name":"id","required":false,"description":"Socialit external id (spotlight:…, saved_story:…, story:…, snap:…, lens:…)"},{"schema":{"type":"string","enum":["story","snap","saved_story","spotlight","lens"]},"in":"query","name":"kind","required":false,"description":"Kind for bare ids"},{"schema":{"type":"string","enum":["DAY","TOTAL","LIFETIME"],"default":"DAY"},"in":"query","name":"granularity","required":false},{"schema":{"type":"string","enum":["AGE_GENDER","COUNTRY","INTEREST_CATEGORY_ID","OS","PLACEMENT","PLATFORM","PRODUCT","PRODUCT_CATEGORY","REGION","SDK_VERSION","SPONSOR_TYPE"]},"in":"query","name":"breakdown","required":false},{"schema":{"type":"string","default":"VIEWS"},"in":"query","name":"field","required":false,"description":"Field for breakdowns"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-asset-insights-list","x-zernio":["GET /v1/analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"views":{"type":["null","number"]},"reach":{"type":["null","number"],"description":"Unique viewers"},"profile_views":{"type":["null","number"]},"followers":{"type":["null","number"],"description":"Subscribers"},"follower_change":{"type":["null","number"],"description":"Subscribes − unsubscribes"},"shares":{"type":["null","number"]},"likes":{"type":["null","number"],"description":"Favorites"},"comments":{"type":["null","number"],"description":"Replies"},"clicks":{"type":["null","number"],"description":"Swipe ups"},"engagements":{"type":["null","number"],"description":"Interactions"},"watch_time_seconds":{"type":["null","number"]},"avg_view_duration_seconds":{"type":["null","number"]},"native":{"type":["null","object"],"properties":{},"additionalProperties":{"type":"number"},"description":"Raw Snap fields (SCREENSHOTS, COMPLETES, …)"},"key":{"type":["null","string"]},"value":{"type":["null","number"]},"percentage":{"type":["null","number"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/creator-search":{"get":{"operationId":"snapchatCreatorSearchList","summary":"Snapchat: List Search profiles","tags":["Focus · Snapchat"],"description":"GET /public/v1/public_profiles/search. Find Public Profiles by username or display name. If nothing comes back, retry with include_standard. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: `/v1/accounts/{accountId}/focus/creator-search`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"query","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["CATEGORY_PERSON","CATEGORY_BUSINESS"]},"in":"query","name":"category","required":false},{"schema":{"type":"string","enum":["TIER_PUBLIC","TIER_PUBLIC_OFFICIAL"]},"in":"query","name":"tier","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"include_standard","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-creator-search-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"display_name":{"type":"string"},"username":{"type":"string"},"description":{"type":["null","string"]},"profile_image_url":{"type":["null","string"],"format":"uri"},"subscriber_count":{"type":["null","integer"]},"organization_id":{"type":["null","string"]},"organization_name":{"type":["null","string"]},"category":{"type":["null","string"]},"subcategory":{"type":["null","string"]},"internal_profile_category":{"type":["null","string"],"enum":["UNKNOWN","BUSINESS","PERSON","PUBLISHER",null]},"profile_type":{"type":["null","string"],"enum":["STORY_STUDIO_PUBLISHER","PUBLISHER_WITH_HOST_USER","PUBLIC_PROFILE","PUBLIC_PROFILE_WITH_PUBLISHER_CONTENT",null]},"profile_tier":{"type":["null","string"],"enum":["TIER_UNKNOWN","TIER_STANDARD","TIER_PUBLIC","TIER_PUBLIC_OFFICIAL",null]},"email":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"website":{"type":["null","string"],"format":"uri"},"address":{"type":["null","object"],"properties":{"line_1":{"type":["null","string"]},"line_2":{"type":["null","string"]},"line_3":{"type":["null","string"]},"locality":{"type":["null","string"]},"region":{"type":["null","string"]},"district":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"country_code_90d":{"type":["null","string"]},"primary_color":{"type":["null","string"]},"share_insights":{"type":["null","boolean"]},"share_expired_stories":{"type":["null","boolean"]},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/creator-discovery":{"get":{"operationId":"snapchatCreatorDiscoveryList","summary":"Snapchat: List Discover creators","tags":["Focus · Snapchat"],"description":"GET /public/v1/public_profiles/discover. Filter Snap creators by country, category, followers, audience and partnership readiness (≤ 5,000 results per query). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: `/v1/accounts/{accountId}/focus/creator-discovery`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string"},"in":"query","name":"query","required":false},{"schema":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"in":"query","name":"countries","required":false},{"schema":{"type":"array","items":{"type":"string"}},"in":"query","name":"categories","required":false},{"schema":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"in":"query","name":"audience_countries","required":false},{"schema":{"type":"string","enum":["GENDER_MALE","GENDER_FEMALE"]},"in":"query","name":"audience_gender","required":false},{"schema":{"type":"integer","minimum":0},"in":"query","name":"min_followers","required":false},{"schema":{"type":"integer","minimum":0},"in":"query","name":"max_followers","required":false},{"schema":{"type":"integer","minimum":0},"in":"query","name":"min_spotlight_views","required":false},{"schema":{"type":"integer","minimum":0},"in":"query","name":"max_spotlight_views","required":false},{"schema":{"type":"boolean"},"in":"query","name":"share_insights","required":false},{"schema":{"type":"boolean"},"in":"query","name":"share_expired_stories","required":false},{"schema":{"type":"boolean"},"in":"query","name":"snap_stars_only","required":false},{"schema":{"type":"boolean"},"in":"query","name":"has_paid_partnership_experience","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-creator-discovery-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"display_name":{"type":"string"},"username":{"type":"string"},"description":{"type":["null","string"]},"profile_image_url":{"type":["null","string"],"format":"uri"},"subscriber_count":{"type":["null","integer"]},"organization_id":{"type":["null","string"]},"organization_name":{"type":["null","string"]},"category":{"type":["null","string"]},"subcategory":{"type":["null","string"]},"internal_profile_category":{"type":["null","string"],"enum":["UNKNOWN","BUSINESS","PERSON","PUBLISHER",null]},"profile_type":{"type":["null","string"],"enum":["STORY_STUDIO_PUBLISHER","PUBLISHER_WITH_HOST_USER","PUBLIC_PROFILE","PUBLIC_PROFILE_WITH_PUBLISHER_CONTENT",null]},"profile_tier":{"type":["null","string"],"enum":["TIER_UNKNOWN","TIER_STANDARD","TIER_PUBLIC","TIER_PUBLIC_OFFICIAL",null]},"email":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"website":{"type":["null","string"],"format":"uri"},"address":{"type":["null","object"],"properties":{"line_1":{"type":["null","string"]},"line_2":{"type":["null","string"]},"line_3":{"type":["null","string"]},"locality":{"type":["null","string"]},"region":{"type":["null","string"]},"district":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"country_code_90d":{"type":["null","string"]},"primary_color":{"type":["null","string"]},"share_insights":{"type":["null","boolean"]},"share_expired_stories":{"type":["null","boolean"]},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/creator-profiles/{itemId}":{"get":{"operationId":"snapchatCreatorProfilesGet","summary":"Snapchat: Get a Creator profile item","tags":["Focus · Snapchat"],"description":"GET /public/v1/public_profiles/{profile_id}. Public view of any Public Profile: metadata, Saved Stories, Spotlights and Lenses. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: `/v1/accounts/{accountId}/focus/creator-profiles`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-creator-profiles-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"display_name":{"type":"string"},"username":{"type":"string"},"description":{"type":["null","string"]},"profile_image_url":{"type":["null","string"],"format":"uri"},"subscriber_count":{"type":["null","integer"]},"organization_id":{"type":["null","string"]},"organization_name":{"type":["null","string"]},"category":{"type":["null","string"]},"subcategory":{"type":["null","string"]},"internal_profile_category":{"type":["null","string"],"enum":["UNKNOWN","BUSINESS","PERSON","PUBLISHER",null]},"profile_type":{"type":["null","string"],"enum":["STORY_STUDIO_PUBLISHER","PUBLISHER_WITH_HOST_USER","PUBLIC_PROFILE","PUBLIC_PROFILE_WITH_PUBLISHER_CONTENT",null]},"profile_tier":{"type":["null","string"],"enum":["TIER_UNKNOWN","TIER_STANDARD","TIER_PUBLIC","TIER_PUBLIC_OFFICIAL",null]},"email":{"type":["null","string"]},"phone_number":{"type":["null","string"]},"website":{"type":["null","string"],"format":"uri"},"address":{"type":["null","object"],"properties":{"line_1":{"type":["null","string"]},"line_2":{"type":["null","string"]},"line_3":{"type":["null","string"]},"locality":{"type":["null","string"]},"region":{"type":["null","string"]},"district":{"type":["null","string"]},"postal_code":{"type":["null","string"]},"country":{"type":["null","string"]}}},"country_code_90d":{"type":["null","string"]},"primary_color":{"type":["null","string"]},"share_insights":{"type":["null","boolean"]},"share_expired_stories":{"type":["null","boolean"]},"url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/creator-profiles/{itemId}/saved-stories":{"post":{"operationId":"snapchatCreatorProfilesSavedStories","summary":"Snapchat: Saved Stories (Creator profile)","tags":["Focus · Snapchat"],"description":"Saved Stories. Public view of any Public Profile: metadata, Saved Stories, Spotlights and Lenses. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: `/v1/accounts/{accountId}/focus/creator-profiles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":20},"cursor":{"type":"string","description":"next_cursor from the previous page"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-creator-profiles-saved-stories","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/creator-profiles/{itemId}/spotlights":{"post":{"operationId":"snapchatCreatorProfilesSpotlights","summary":"Snapchat: Spotlights (Creator profile)","tags":["Focus · Snapchat"],"description":"Spotlights. Public view of any Public Profile: metadata, Saved Stories, Spotlights and Lenses. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: `/v1/accounts/{accountId}/focus/creator-profiles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":20},"cursor":{"type":"string","description":"next_cursor from the previous page"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-creator-profiles-spotlights","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/creator-profiles/{itemId}/lenses":{"post":{"operationId":"snapchatCreatorProfilesLenses","summary":"Snapchat: Lenses (Creator profile)","tags":["Focus · Snapchat"],"description":"Lenses. Public view of any Public Profile: metadata, Saved Stories, Spotlights and Lenses. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: `/v1/accounts/{accountId}/focus/creator-profiles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":20},"cursor":{"type":"string","description":"next_cursor from the previous page"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-creator-profiles-lenses","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/creator-profiles/by-snap":{"post":{"operationId":"snapchatCreatorProfilesBySnap","summary":"Snapchat: Find profile by Snap id (Creator profile)","tags":["Focus · Snapchat"],"description":"Find profile by Snap id. Public view of any Public Profile: metadata, Saved Stories, Spotlights and Lenses. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: `/v1/accounts/{accountId}/focus/creator-profiles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"snap_id":{"type":"string"}},"required":["snap_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-creator-profiles-by-snap","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/partnerships":{"get":{"operationId":"snapchatPartnershipsList","summary":"Snapchat: List Creator partnerships","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{brand_profile_id}/creator_partnerships. Ad-level brand-creator partnerships. Creators accept in the Snapchat app; there are no webhooks, so refresh to see status changes. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/PartnershipRoles Generic route: `/v1/accounts/{accountId}/focus/partnerships`.","parameters":[{"schema":{"type":"boolean","default":true},"in":"query","name":"include_pending","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"include_expired","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-partnerships-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"invitee_user_id (used to cancel)"},"creator_profile_id":{"type":["null","string"]},"invitee_user_id":{"type":["null","string"]},"creator_display_name":{"type":["null","string"]},"creator_username":{"type":["null","string"]},"creator_thumbnail_url":{"type":["null","string"],"format":"uri"},"creator_tier":{"type":["null","string"]},"role_status":{"type":["null","string"],"enum":["PENDING","APPROVED","EXPIRED","REJECTED",null]},"role_type":{"type":["null","string"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"share_insights":{"type":["null","boolean"]},"share_expired_stories":{"type":["null","boolean"]},"share_content_for_ads":{"type":["null","boolean"]},"shared_public_profile_level":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"snapchatPartnershipsCreate","summary":"Snapchat: Create a Creator partnerships item","tags":["Focus · Snapchat"],"description":"POST /v1/public_profiles/{brand_profile_id}/roles (invite creator). Ad-level brand-creator partnerships. Creators accept in the Snapchat app; there are no webhooks, so refresh to see status changes. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/PartnershipRoles Generic route: `/v1/accounts/{accountId}/focus/partnerships`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","description":"Creator Snapchat username"},"user_id":{"type":"string","description":"Creator user id (pre-approved creator)"},"display_name":{"type":"string"},"approval_time_in_days":{"type":"integer","enum":[7,30,90],"description":"Omit for no expiry"}},"required":["username"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-partnerships-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"invitee_user_id (used to cancel)"},"creator_profile_id":{"type":["null","string"]},"invitee_user_id":{"type":["null","string"]},"creator_display_name":{"type":["null","string"]},"creator_username":{"type":["null","string"]},"creator_thumbnail_url":{"type":["null","string"],"format":"uri"},"creator_tier":{"type":["null","string"]},"role_status":{"type":["null","string"],"enum":["PENDING","APPROVED","EXPIRED","REJECTED",null]},"role_type":{"type":["null","string"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"share_insights":{"type":["null","boolean"]},"share_expired_stories":{"type":["null","boolean"]},"share_content_for_ads":{"type":["null","boolean"]},"shared_public_profile_level":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/partnerships/{itemId}":{"delete":{"operationId":"snapchatPartnershipsDelete","summary":"Snapchat: Delete a Creator partnerships item","tags":["Focus · Snapchat"],"description":"DELETE /v1/public_profiles/{brand_profile_id}/roles/{invitee_user_id}. Ad-level brand-creator partnerships. Creators accept in the Snapchat app; there are no webhooks, so refresh to see status changes. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/PartnershipRoles Generic route: `/v1/accounts/{accountId}/focus/partnerships`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-partnerships-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/partnerships/{itemId}/permissions":{"post":{"operationId":"snapchatPartnershipsPermissions","summary":"Snapchat: Permissions (Creator partnerships)","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{brand_profile_id}/brand_partnership_permissions. Ad-level brand-creator partnerships. Creators accept in the Snapchat app; there are no webhooks, so refresh to see status changes. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/PartnershipRoles Generic route: `/v1/accounts/{accountId}/focus/partnerships`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"creator_profile_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-partnerships-permissions","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/partner-roles":{"get":{"operationId":"snapchatPartnerRolesList","summary":"Snapchat: List Partner invitations","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{brand_profile_id}/roles?role_type=business_account_story_contributor. Invitation roles and their status (PENDING → APPROVED / REJECTED / EXPIRED). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/PartnershipRoles Generic route: `/v1/accounts/{accountId}/focus/partner-roles`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-partner-roles-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"invitee_username":{"type":"string"},"invitee_display_name":{"type":["null","string"]},"invitee_user_id":{"type":["null","string"]},"invitee_profile_id":{"type":["null","string"]},"profile_logo_url":{"type":["null","string"],"format":"uri"},"role_type":{"type":"string"},"role_status":{"type":["null","string"],"enum":["PENDING","APPROVED","EXPIRED","REJECTED",null]},"profile_tier":{"type":["null","string"]},"partnership_level":{"type":["null","string"]},"approval_time_in_days":{"type":["null","integer"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/collaboration-messages":{"get":{"operationId":"snapchatCollaborationMessagesList","summary":"Snapchat: List Creator messages","tags":["Focus · Snapchat"],"description":"GET /v1/public_profiles/{profile_id}/group_conversation(_messages). Text messages between the brand and a partnered creator. Requires Snap’s separate messaging allowlist; not a customer inbox. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Messaging Generic route: `/v1/accounts/{accountId}/focus/collaboration-messages`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string"},"in":"query","name":"creator_profile_id","required":false},{"schema":{"type":"string"},"in":"query","name":"conversation_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-collaboration-messages-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"type":{"type":"string","enum":["TEXT"]},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":["null","string"],"format":"date-time"},"from_id":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"snapchatCollaborationMessagesCreate","summary":"Snapchat: Create a Creator messages item","tags":["Focus · Snapchat"],"description":"POST /v1/public_profiles/{profile_id}/group_conversation_messages. Text messages between the brand and a partnered creator. Requires Snap’s separate messaging allowlist; not a customer inbox. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Messaging Generic route: `/v1/accounts/{accountId}/focus/collaboration-messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"creator_profile_id":{"type":"string"},"conversation_id":{"type":"string"},"text":{"type":"string","minLength":1}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-collaboration-messages-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"type":{"type":"string","enum":["TEXT"]},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":["null","string"],"format":"date-time"},"from_id":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/collaboration-messages/unread-count":{"post":{"operationId":"snapchatCollaborationMessagesUnreadCount","summary":"Snapchat: Unread count (Creator messages)","tags":["Focus · Snapchat"],"description":"Unread count. Text messages between the brand and a partnered creator. Requires Snap’s separate messaging allowlist; not a customer inbox. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/Messaging Generic route: `/v1/accounts/{accountId}/focus/collaboration-messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-collaboration-messages-unread-count","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/roster-change-logs":{"get":{"operationId":"snapchatRosterChangeLogsList","summary":"Snapchat: List Creator roster exports","tags":["Focus · Snapchat"],"description":"GET /public/v1/public_profiles/change_logs. Signed CSV exports of creator roster changes (URLs expire after 1 h). FULL_SNAPSHOT needs Creator Discovery approval. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-profile-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/CreatorDiscovery Generic route: `/v1/accounts/{accountId}/focus/roster-change-logs`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string","enum":["INCREMENTAL","FULL_SNAPSHOT"],"default":"INCREMENTAL"},"in":"query","name":"feed_type","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start_at","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-roster-change-logs-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri"},"filename":{"type":"string"},"exported_at":{"type":"string","format":"date-time"},"shard_index":{"type":["null","integer"]},"shard_count":{"type":["null","integer"]},"size_bytes":{"type":["null","integer"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/ad-accounts":{"get":{"operationId":"snapchatAdAccountsList","summary":"Snapchat: List Ad accounts","tags":["Focus · Snapchat"],"description":"GET adsapi /v1/me/organizations?with_ad_accounts=true. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/organizations Generic route: `/v1/accounts/{accountId}/focus/ad-accounts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-ad-accounts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"type":{"type":["null","string"]},"status":{"type":["null","string"]},"currency":{"type":["null","string"]},"timezone":{"type":["null","string"]},"organization_id":{"type":"string"},"organization_name":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/campaigns":{"get":{"operationId":"snapchatCampaignsList","summary":"Snapchat: List Campaigns","tags":["Focus · Snapchat"],"description":"GET adsapi /v1/adaccounts/{ad_account_id}/campaigns. Campaigns of an ad account (read only here; manage them in the Snapchat Ads area). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/campaigns Generic route: `/v1/accounts/{accountId}/focus/campaigns`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string"},"in":"query","name":"ad_account_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-campaigns-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","PAUSED"]},"ad_account_id":{"type":"string"},"objective":{"type":["null","string"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"daily_budget_micro":{"type":["null","integer"]},"lifetime_spend_cap_micro":{"type":["null","integer"]},"delivery_status":{"type":["null","array"],"items":{"type":"string"}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/ad-squads":{"get":{"operationId":"snapchatAdSquadsList","summary":"Snapchat: List Ad squads","tags":["Focus · Snapchat"],"description":"GET adsapi /v1/campaigns/{campaign_id}/adsquads or /v1/adaccounts/{id}/adsquads. Ad squads to attach a promoted post to. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/ad-squads Generic route: `/v1/accounts/{accountId}/focus/ad-squads`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"next_cursor from the previous page"},{"schema":{"type":"string"},"in":"query","name":"ad_account_id","required":false},{"schema":{"type":"string"},"in":"query","name":"campaign_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-ad-squads-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","PAUSED"]},"campaign_id":{"type":"string"},"type":{"type":["null","string"]},"optimization_goal":{"type":["null","string"]},"bid_strategy":{"type":["null","string"]},"daily_budget_micro":{"type":["null","integer"]},"start_time":{"type":["null","string"],"format":"date-time"},"end_time":{"type":["null","string"],"format":"date-time"},"delivery_status":{"type":["null","array"],"items":{"type":"string"}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/promotions/{itemId}":{"get":{"operationId":"snapchatPromotionsGet","summary":"Snapchat: Get a Promote a post item","tags":["Focus · Snapchat"],"description":"GET adsapi /v1/media/{media_id} (claimed media status). Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: `/v1/accounts/{accountId}/focus/promotions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-promotions-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string","readOnly":true,"description":"Claimed ad media id"},"status":{"type":"string","enum":["claimed","pending_media","creative_created","ad_created"]},"creative":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"review_status":{"type":["null","string"]}}},"campaign":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}}},"ad_squad":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}}},"ad":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"review_status":{"type":["null","string"]}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/promotions":{"post":{"operationId":"snapchatPromotionsCreate","summary":"Snapchat: Create a Promote a post item","tags":["Focus · Snapchat"],"description":"claim_media_by_snap_reference | combine_snaps | claim_media_by_ad_code → creatives → ads. Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: `/v1/accounts/{accountId}/focus/promotions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"external_id":{"type":"string","description":"snap:…, spotlight:… or saved_story:…"},"snap_id":{"type":"string"},"ad_code":{"type":"string","description":"Creator-generated ad code"},"ad_account_id":{"type":"string"},"ad_squad_id":{"type":"string"},"new_campaign":{"type":"object","properties":{"name":{"type":"string"},"objective":{"type":"string","default":"AWARENESS_AND_ENGAGEMENT"},"daily_budget_micro":{"type":"integer"},"country_codes":{"type":"array","items":{"type":"string"}}}},"headline":{"type":"string","maxLength":34},"call_to_action":{"type":"string"},"wait_for_ready":{"type":"boolean","default":true}},"required":["ad_account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-promotions-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"media_id":{"type":"string","readOnly":true,"description":"Claimed ad media id"},"status":{"type":"string","enum":["claimed","pending_media","creative_created","ad_created"]},"creative":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"review_status":{"type":["null","string"]}}},"campaign":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}}},"ad_squad":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}}},"ad":{"type":["null","object"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"review_status":{"type":["null","string"]}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/promotions/{itemId}/complete":{"post":{"operationId":"snapchatPromotionsComplete","summary":"Snapchat: Create creative / ad (Promote a post)","tags":["Focus · Snapchat"],"description":"Finish a promotion once the claimed media is READY. Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: `/v1/accounts/{accountId}/focus/promotions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad_account_id":{"type":"string"},"ad_squad_id":{"type":"string"},"headline":{"type":"string"},"call_to_action":{"type":"string"}},"required":["ad_account_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-promotions-complete","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/promotions/extract-snap-id":{"post":{"operationId":"snapchatPromotionsExtractSnapId","summary":"Snapchat: Snap id from link (Promote a post)","tags":["Focus · Snapchat"],"description":"Snap id from link. Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: `/v1/accounts/{accountId}/focus/promotions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"short_url_code":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-promotions-extract-snap-id","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/promotions/claim-ad-code":{"post":{"operationId":"snapchatPromotionsClaimAdCode","summary":"Snapchat: Claim by ad code (Promote a post)","tags":["Focus · Snapchat"],"description":"Claim by ad code. Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: `/v1/accounts/{accountId}/focus/promotions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad_account_id":{"type":"string"},"ad_code":{"type":"string"},"profile_id":{"type":"string"}},"required":["ad_account_id","ad_code"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-promotions-claim-ad-code","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/promotions/combine-snaps":{"post":{"operationId":"snapchatPromotionsCombineSnaps","summary":"Snapchat: Combine snaps (Promote a post)","tags":["Focus · Snapchat"],"description":"Combine snaps. Claim an organic Snap, Spotlight or Saved Story (or a creator ad code) into an ad account, then create a PAUSED creative and ad. Nothing spends until you activate it in Ads Manager. Requires scopes: snapchat-profile-api, snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Ads-API/claim-media Generic route: `/v1/accounts/{accountId}/focus/promotions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad_account_id":{"type":"string"},"snap_ids":{"type":"array","items":{"type":"string"},"minItems":1},"tagged_profile_id":{"type":"string"}},"required":["ad_account_id","snap_ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-promotions-combine-snaps","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/sharing-policies":{"get":{"operationId":"snapchatSharingPoliciesList","summary":"Snapchat: List Profile sharing","tags":["Focus · Snapchat"],"description":"GET /v1/adaccounts/{ad_account_id}/sharing_policies. Share this Public Profile with another ad account or organization (agency / cross-org setups). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: snapchat-profile-api | snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/sharing-policies`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"ad_account_id","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["pixels","public_profiles","catalogs","mobile_apps"]},"default":["public_profiles"]},"in":"query","name":"types","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-sharing-policies-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"source_type":{"type":"string"},"source_id":{"type":"string"},"target_type":{"type":"string","enum":["adaccounts","organizations"]},"target_id":{"type":"string"},"parent_policy_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"snapchatSharingPoliciesCreate","summary":"Snapchat: Create a Profile sharing item","tags":["Focus · Snapchat"],"description":"POST /v1/{resource_type}/{resource_id}/sharing_policies. Share this Public Profile with another ad account or organization (agency / cross-org setups). Requires one of: snapchat-profile-api | snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/sharing-policies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resource_type":{"type":"string","default":"public_profiles"},"resource_id":{"type":"string","description":"Defaults to this profile"},"target_type":{"type":"string","enum":["adaccounts","organizations"]},"target_id":{"type":"string"},"parent_policy_id":{"type":"string","description":"Required when sharing to an external ad account"}},"required":["target_type","target_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-sharing-policies-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"source_type":{"type":"string"},"source_id":{"type":"string"},"target_type":{"type":"string","enum":["adaccounts","organizations"]},"target_id":{"type":"string"},"parent_policy_id":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/snapchat/sharing-policies/{itemId}":{"delete":{"operationId":"snapchatSharingPoliciesDelete","summary":"Snapchat: Delete a Profile sharing item","tags":["Focus · Snapchat"],"description":"DELETE /v1/sharing_policies/{id}. Share this Public Profile with another ad account or organization (agency / cross-org setups). Requires one of: snapchat-profile-api | snapchat-marketing-api. Network docs: https://developers.snap.com/api/marketing-api/Public-Profile-API/ProfileAssetManagement Generic route: `/v1/accounts/{accountId}/focus/sharing-policies`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_snapchat","x-mcp-tool":"snapchat-sharing-policies-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/posts":{"get":{"operationId":"threadsPostsList","summary":"Threads: List Posts","tags":["Focus · Threads"],"description":"Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-list","x-zernio":["GET /v1/accounts/{accountId}/posts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"],"maxLength":500},"media_type":{"type":"string","enum":["TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"],"readOnly":true},"media_product_type":{"type":["null","string"],"readOnly":true},"media_url":{"type":["null","string"],"format":"uri","readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"permalink":{"type":["null","string"],"format":"uri","readOnly":true},"shortcode":{"type":["null","string"],"readOnly":true},"username":{"type":["null","string"],"readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"timestamp":{"type":"string","format":"date-time","readOnly":true},"is_quote_post":{"type":"boolean","readOnly":true},"quoted_post_id":{"type":["null","string"],"readOnly":true},"is_repost":{"type":"boolean","readOnly":true},"reposted_post_id":{"type":["null","string"],"readOnly":true},"alt_text":{"type":["null","string"],"maxLength":1000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri","readOnly":true},"has_replies":{"type":"boolean","readOnly":true},"reply_audience":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null],"readOnly":true},"is_spoiler_media":{"type":"boolean"},"text_spoilers":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"}}}},"text_attachment":{"type":["null","object"],"properties":{"plaintext":{"type":"string","maxLength":10000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"text_with_styling_info":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"},"styling_info":{"type":"array","items":{"type":"string"}}}}}}},"topic_tag":{"type":["null","string"],"maxLength":50},"location_id":{"type":["null","string"]},"poll":{"type":["null","object"],"properties":{"options":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"votes_percentage":{"type":["null","number"]}}}},"total_votes":{"type":["null","integer"]},"expires_at":{"type":["null","string"],"format":"date-time"}}},"children":{"type":"array","items":{"type":"string"},"readOnly":true},"allowlisted_country_codes":{"type":["null","array"],"items":{"type":"string"}},"ghost_post_status":{"type":["null","string"],"enum":["ACTIVE","ARCHIVED",null],"readOnly":true},"ghost_post_expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"threadsPostsCreate","summary":"Threads: Create a Posts item","tags":["Focus · Threads"],"description":"Publish now (Threads has no native scheduling; schedule through Socialit posts). Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":500,"description":"Post text (≤500; emoji count by UTF-8 bytes)"},"media":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"media_id":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"type":{"type":"string","enum":["image","video","gif"]},"altText":{"type":"string","maxLength":1000}},"description":"JPEG/PNG ≤ 8 MB or MP4/MOV ≤ 5 min / 1 GB, aspect within 10:1"},"maxItems":20},"replyControl":{"type":"string","enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"],"description":"Who can reply. Alias: reply_control."},"enableReplyApprovals":{"type":"boolean","description":"Hold replies for approval (pending replies). Not with ghost posts."},"linkAttachment":{"type":"string","format":"uri","description":"Link preview card (TEXT posts only). Alias: link_attachment."},"poll":{"description":"Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, `{ options: [...] }` or `{ option_a … option_d }`.","oneOf":[{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},{"type":"object","properties":{"options":{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},"option_a":{"type":"string"},"option_b":{"type":"string"},"option_c":{"type":"string"},"option_d":{"type":"string"}}}]},"gif":{"type":"object","description":"GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).","required":["gifId"],"properties":{"gifId":{"type":"string"},"provider":{"type":"string","enum":["GIPHY"],"default":"GIPHY"}}},"textSpoilers":{"type":"array","maxItems":10,"description":"Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].","items":{"type":"object","required":["offset","length"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1}}}},"spoilerMedia":{"type":"boolean","description":"Blur the image/video/carousel as a spoiler (is_spoiler_media)."},"textAttachment":{"type":"object","description":"Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.","required":["plaintext"],"properties":{"plaintext":{"type":"string","maxLength":10000},"linkAttachmentUrl":{"type":"string","format":"uri","description":"Not allowed when linkAttachment is set."},"styling":{"type":"array","description":"Non-overlapping style ranges.","items":{"type":"object","required":["offset","length","styles"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1},"styles":{"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}}}}}},"topicTag":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[^.&]+$","description":"One topic tag per post (no \".\" or \"&\"; a leading \"#\" is stripped). Alias: topic_tag."},"ghostPost":{"type":"boolean","description":"Ghost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only."},"quotePostId":{"type":"string","description":"Quote this Threads post id (also post.quoteExternalId)."},"replyToId":{"type":"string","description":"Publish as a reply to this post id (also post.replyToExternalId)."},"allowlistedCountryCodes":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z]{2}$"},"description":"Geo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only)."},"locationId":{"type":"string","description":"Location tag id from location search (threads_location_tagging)."},"crossShareToInstagram":{"type":"boolean","description":"Also share to the linked Instagram account as a Story (threads_share_to_instagram)."},"crossShareToInstagramDarkMode":{"type":"boolean","description":"Dark-mode Instagram Story."},"autoPublishText":{"type":"boolean","description":"Publish TEXT posts in one call (auto_publish_text)."},"thread":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","maxLength":500},"media":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}}},"mediaItems":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}},"description":"Zernio alias of media."},"linkAttachment":{"type":"string","format":"uri","description":"Link preview card (TEXT posts only). Alias: link_attachment."},"poll":{"description":"Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, `{ options: [...] }` or `{ option_a … option_d }`.","oneOf":[{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},{"type":"object","properties":{"options":{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},"option_a":{"type":"string"},"option_b":{"type":"string"},"option_c":{"type":"string"},"option_d":{"type":"string"}}}]},"gif":{"type":"object","description":"GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).","required":["gifId"],"properties":{"gifId":{"type":"string"},"provider":{"type":"string","enum":["GIPHY"],"default":"GIPHY"}}},"textSpoilers":{"type":"array","maxItems":10,"description":"Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].","items":{"type":"object","required":["offset","length"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1}}}},"spoilerMedia":{"type":"boolean","description":"Blur the image/video/carousel as a spoiler (is_spoiler_media)."},"textAttachment":{"type":"object","description":"Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.","required":["plaintext"],"properties":{"plaintext":{"type":"string","maxLength":10000},"linkAttachmentUrl":{"type":"string","format":"uri","description":"Not allowed when linkAttachment is set."},"styling":{"type":"array","description":"Non-overlapping style ranges.","items":{"type":"object","required":["offset","length","styles"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1},"styles":{"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}}}}}},"topicTag":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[^.&]+$","description":"One topic tag per post (no \".\" or \"&\"; a leading \"#\" is stripped). Alias: topic_tag."}}},"description":"Follow-up posts chained after the root (each replies to the previous one)."},"threadItems":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","maxLength":500},"media":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}}},"mediaItems":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}},"description":"Zernio alias of media."},"linkAttachment":{"type":"string","format":"uri","description":"Link preview card (TEXT posts only). Alias: link_attachment."},"poll":{"description":"Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, `{ options: [...] }` or `{ option_a … option_d }`.","oneOf":[{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},{"type":"object","properties":{"options":{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},"option_a":{"type":"string"},"option_b":{"type":"string"},"option_c":{"type":"string"},"option_d":{"type":"string"}}}]},"gif":{"type":"object","description":"GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).","required":["gifId"],"properties":{"gifId":{"type":"string"},"provider":{"type":"string","enum":["GIPHY"],"default":"GIPHY"}}},"textSpoilers":{"type":"array","maxItems":10,"description":"Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].","items":{"type":"object","required":["offset","length"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1}}}},"spoilerMedia":{"type":"boolean","description":"Blur the image/video/carousel as a spoiler (is_spoiler_media)."},"textAttachment":{"type":"object","description":"Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.","required":["plaintext"],"properties":{"plaintext":{"type":"string","maxLength":10000},"linkAttachmentUrl":{"type":"string","format":"uri","description":"Not allowed when linkAttachment is set."},"styling":{"type":"array","description":"Non-overlapping style ranges.","items":{"type":"object","required":["offset","length","styles"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1},"styles":{"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}}}}}},"topicTag":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[^.&]+$","description":"One topic tag per post (no \".\" or \"&\"; a leading \"#\" is stripped). Alias: topic_tag."}}},"description":"Zernio semantics: the full thread, [0] is the root; when set, the post content/media are not published."},"firstComment":{"type":"string","maxLength":500,"description":"Self-reply posted under the root post (counts toward 250/24 h)."},"altText":{"type":"string","maxLength":1000,"description":"Fallback alt text for single-media posts."},"checkQuota":{"type":"boolean","description":"Check threads_publishing_limit before publishing (fails fast at 250/24 h)."}},"description":"Text, image, video or carousel (2–20) post with any Threads option."}}},"description":"Text, image, video or carousel (2–20) post with any Threads option."},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-create","x-idempotent":true,"x-zernio":["POST /v1/posts","POST /v1/posts/{postId}/unpublish","POST /v1/posts/sync-external"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"],"maxLength":500},"media_type":{"type":"string","enum":["TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"],"readOnly":true},"media_product_type":{"type":["null","string"],"readOnly":true},"media_url":{"type":["null","string"],"format":"uri","readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"permalink":{"type":["null","string"],"format":"uri","readOnly":true},"shortcode":{"type":["null","string"],"readOnly":true},"username":{"type":["null","string"],"readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"timestamp":{"type":"string","format":"date-time","readOnly":true},"is_quote_post":{"type":"boolean","readOnly":true},"quoted_post_id":{"type":["null","string"],"readOnly":true},"is_repost":{"type":"boolean","readOnly":true},"reposted_post_id":{"type":["null","string"],"readOnly":true},"alt_text":{"type":["null","string"],"maxLength":1000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri","readOnly":true},"has_replies":{"type":"boolean","readOnly":true},"reply_audience":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null],"readOnly":true},"is_spoiler_media":{"type":"boolean"},"text_spoilers":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"}}}},"text_attachment":{"type":["null","object"],"properties":{"plaintext":{"type":"string","maxLength":10000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"text_with_styling_info":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"},"styling_info":{"type":"array","items":{"type":"string"}}}}}}},"topic_tag":{"type":["null","string"],"maxLength":50},"location_id":{"type":["null","string"]},"poll":{"type":["null","object"],"properties":{"options":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"votes_percentage":{"type":["null","number"]}}}},"total_votes":{"type":["null","integer"]},"expires_at":{"type":["null","string"],"format":"date-time"}}},"children":{"type":"array","items":{"type":"string"},"readOnly":true},"allowlisted_country_codes":{"type":["null","array"],"items":{"type":"string"}},"ghost_post_status":{"type":["null","string"],"enum":["ACTIVE","ARCHIVED",null],"readOnly":true},"ghost_post_expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/posts/{itemId}":{"get":{"operationId":"threadsPostsGet","summary":"Threads: Get a Posts item","tags":["Focus · Threads"],"description":"Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"],"maxLength":500},"media_type":{"type":"string","enum":["TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"],"readOnly":true},"media_product_type":{"type":["null","string"],"readOnly":true},"media_url":{"type":["null","string"],"format":"uri","readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"permalink":{"type":["null","string"],"format":"uri","readOnly":true},"shortcode":{"type":["null","string"],"readOnly":true},"username":{"type":["null","string"],"readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"timestamp":{"type":"string","format":"date-time","readOnly":true},"is_quote_post":{"type":"boolean","readOnly":true},"quoted_post_id":{"type":["null","string"],"readOnly":true},"is_repost":{"type":"boolean","readOnly":true},"reposted_post_id":{"type":["null","string"],"readOnly":true},"alt_text":{"type":["null","string"],"maxLength":1000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri","readOnly":true},"has_replies":{"type":"boolean","readOnly":true},"reply_audience":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null],"readOnly":true},"is_spoiler_media":{"type":"boolean"},"text_spoilers":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"}}}},"text_attachment":{"type":["null","object"],"properties":{"plaintext":{"type":"string","maxLength":10000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"text_with_styling_info":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"},"styling_info":{"type":"array","items":{"type":"string"}}}}}}},"topic_tag":{"type":["null","string"],"maxLength":50},"location_id":{"type":["null","string"]},"poll":{"type":["null","object"],"properties":{"options":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"votes_percentage":{"type":["null","number"]}}}},"total_votes":{"type":["null","integer"]},"expires_at":{"type":["null","string"],"format":"date-time"}}},"children":{"type":"array","items":{"type":"string"},"readOnly":true},"allowlisted_country_codes":{"type":["null","array"],"items":{"type":"string"}},"ghost_post_status":{"type":["null","string"],"enum":["ACTIVE","ARCHIVED",null],"readOnly":true},"ghost_post_expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"threadsPostsDelete","summary":"Threads: Delete a Posts item","tags":["Focus · Threads"],"description":"Delete the post (100 deletes / 24 h). Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/posts/{itemId}/quote":{"post":{"operationId":"threadsPostsQuote","summary":"Threads: Quote (Posts)","tags":["Focus · Threads"],"description":"Quote. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":500,"description":"Post text (≤500; emoji count by UTF-8 bytes)"},"media":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"media_id":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"type":{"type":"string","enum":["image","video","gif"]},"altText":{"type":"string","maxLength":1000}},"description":"JPEG/PNG ≤ 8 MB or MP4/MOV ≤ 5 min / 1 GB, aspect within 10:1"},"maxItems":20},"replyControl":{"type":"string","enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"],"description":"Who can reply. Alias: reply_control."},"enableReplyApprovals":{"type":"boolean","description":"Hold replies for approval (pending replies). Not with ghost posts."},"linkAttachment":{"type":"string","format":"uri","description":"Link preview card (TEXT posts only). Alias: link_attachment."},"poll":{"description":"Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, `{ options: [...] }` or `{ option_a … option_d }`.","oneOf":[{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},{"type":"object","properties":{"options":{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},"option_a":{"type":"string"},"option_b":{"type":"string"},"option_c":{"type":"string"},"option_d":{"type":"string"}}}]},"gif":{"type":"object","description":"GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).","required":["gifId"],"properties":{"gifId":{"type":"string"},"provider":{"type":"string","enum":["GIPHY"],"default":"GIPHY"}}},"textSpoilers":{"type":"array","maxItems":10,"description":"Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].","items":{"type":"object","required":["offset","length"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1}}}},"spoilerMedia":{"type":"boolean","description":"Blur the image/video/carousel as a spoiler (is_spoiler_media)."},"textAttachment":{"type":"object","description":"Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.","required":["plaintext"],"properties":{"plaintext":{"type":"string","maxLength":10000},"linkAttachmentUrl":{"type":"string","format":"uri","description":"Not allowed when linkAttachment is set."},"styling":{"type":"array","description":"Non-overlapping style ranges.","items":{"type":"object","required":["offset","length","styles"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1},"styles":{"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}}}}}},"topicTag":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[^.&]+$","description":"One topic tag per post (no \".\" or \"&\"; a leading \"#\" is stripped). Alias: topic_tag."},"ghostPost":{"type":"boolean","description":"Ghost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only."},"quotePostId":{"type":"string","description":"Quote this Threads post id (also post.quoteExternalId)."},"replyToId":{"type":"string","description":"Publish as a reply to this post id (also post.replyToExternalId)."},"allowlistedCountryCodes":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z]{2}$"},"description":"Geo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only)."},"locationId":{"type":"string","description":"Location tag id from location search (threads_location_tagging)."},"crossShareToInstagram":{"type":"boolean","description":"Also share to the linked Instagram account as a Story (threads_share_to_instagram)."},"crossShareToInstagramDarkMode":{"type":"boolean","description":"Dark-mode Instagram Story."},"autoPublishText":{"type":"boolean","description":"Publish TEXT posts in one call (auto_publish_text)."},"thread":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","maxLength":500},"media":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}}},"mediaItems":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}},"description":"Zernio alias of media."},"linkAttachment":{"type":"string","format":"uri","description":"Link preview card (TEXT posts only). Alias: link_attachment."},"poll":{"description":"Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, `{ options: [...] }` or `{ option_a … option_d }`.","oneOf":[{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},{"type":"object","properties":{"options":{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},"option_a":{"type":"string"},"option_b":{"type":"string"},"option_c":{"type":"string"},"option_d":{"type":"string"}}}]},"gif":{"type":"object","description":"GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).","required":["gifId"],"properties":{"gifId":{"type":"string"},"provider":{"type":"string","enum":["GIPHY"],"default":"GIPHY"}}},"textSpoilers":{"type":"array","maxItems":10,"description":"Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].","items":{"type":"object","required":["offset","length"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1}}}},"spoilerMedia":{"type":"boolean","description":"Blur the image/video/carousel as a spoiler (is_spoiler_media)."},"textAttachment":{"type":"object","description":"Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.","required":["plaintext"],"properties":{"plaintext":{"type":"string","maxLength":10000},"linkAttachmentUrl":{"type":"string","format":"uri","description":"Not allowed when linkAttachment is set."},"styling":{"type":"array","description":"Non-overlapping style ranges.","items":{"type":"object","required":["offset","length","styles"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1},"styles":{"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}}}}}},"topicTag":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[^.&]+$","description":"One topic tag per post (no \".\" or \"&\"; a leading \"#\" is stripped). Alias: topic_tag."}}},"description":"Follow-up posts chained after the root (each replies to the previous one)."},"threadItems":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","maxLength":500},"media":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}}},"mediaItems":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}},"description":"Zernio alias of media."},"linkAttachment":{"type":"string","format":"uri","description":"Link preview card (TEXT posts only). Alias: link_attachment."},"poll":{"description":"Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, `{ options: [...] }` or `{ option_a … option_d }`.","oneOf":[{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},{"type":"object","properties":{"options":{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},"option_a":{"type":"string"},"option_b":{"type":"string"},"option_c":{"type":"string"},"option_d":{"type":"string"}}}]},"gif":{"type":"object","description":"GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).","required":["gifId"],"properties":{"gifId":{"type":"string"},"provider":{"type":"string","enum":["GIPHY"],"default":"GIPHY"}}},"textSpoilers":{"type":"array","maxItems":10,"description":"Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].","items":{"type":"object","required":["offset","length"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1}}}},"spoilerMedia":{"type":"boolean","description":"Blur the image/video/carousel as a spoiler (is_spoiler_media)."},"textAttachment":{"type":"object","description":"Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.","required":["plaintext"],"properties":{"plaintext":{"type":"string","maxLength":10000},"linkAttachmentUrl":{"type":"string","format":"uri","description":"Not allowed when linkAttachment is set."},"styling":{"type":"array","description":"Non-overlapping style ranges.","items":{"type":"object","required":["offset","length","styles"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1},"styles":{"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}}}}}},"topicTag":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[^.&]+$","description":"One topic tag per post (no \".\" or \"&\"; a leading \"#\" is stripped). Alias: topic_tag."}}},"description":"Zernio semantics: the full thread, [0] is the root; when set, the post content/media are not published."},"firstComment":{"type":"string","maxLength":500,"description":"Self-reply posted under the root post (counts toward 250/24 h)."},"altText":{"type":"string","maxLength":1000,"description":"Fallback alt text for single-media posts."},"checkQuota":{"type":"boolean","description":"Check threads_publishing_limit before publishing (fails fast at 250/24 h)."}},"description":"Text, image, video or carousel (2–20) post with any Threads option."}}},"description":"Text, image, video or carousel (2–20) post with any Threads option."},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-quote","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/posts/{itemId}/reply":{"post":{"operationId":"threadsPostsReply","summary":"Threads: Reply (Posts)","tags":["Focus · Threads"],"description":"Reply. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":500},"media":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"media_id":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"type":{"type":"string","enum":["image","video","gif"]},"altText":{"type":"string","maxLength":1000}},"description":"JPEG/PNG ≤ 8 MB or MP4/MOV ≤ 5 min / 1 GB, aspect within 10:1"},"maxItems":20}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/posts/{itemId}/repost":{"post":{"operationId":"threadsPostsRepost","summary":"Threads: Repost (Posts)","tags":["Focus · Threads"],"description":"Repost. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-repost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/posts/{itemId}/insights":{"post":{"operationId":"threadsPostsInsights","summary":"Threads: Insights (Posts)","tags":["Focus · Threads"],"description":"Lifetime views, likes, replies, reposts, quotes and shares. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-insights","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/posts/validate":{"post":{"operationId":"threadsPostsValidate","summary":"Threads: Validate draft (Posts)","tags":["Focus · Threads"],"description":"Pre-flight checks (length, links, media, option combinations) without publishing. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":500,"description":"Post text (≤500; emoji count by UTF-8 bytes)"},"media":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"media_id":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"type":{"type":"string","enum":["image","video","gif"]},"altText":{"type":"string","maxLength":1000}},"description":"JPEG/PNG ≤ 8 MB or MP4/MOV ≤ 5 min / 1 GB, aspect within 10:1"},"maxItems":20},"replyControl":{"type":"string","enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"],"description":"Who can reply. Alias: reply_control."},"enableReplyApprovals":{"type":"boolean","description":"Hold replies for approval (pending replies). Not with ghost posts."},"linkAttachment":{"type":"string","format":"uri","description":"Link preview card (TEXT posts only). Alias: link_attachment."},"poll":{"description":"Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, `{ options: [...] }` or `{ option_a … option_d }`.","oneOf":[{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},{"type":"object","properties":{"options":{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},"option_a":{"type":"string"},"option_b":{"type":"string"},"option_c":{"type":"string"},"option_d":{"type":"string"}}}]},"gif":{"type":"object","description":"GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).","required":["gifId"],"properties":{"gifId":{"type":"string"},"provider":{"type":"string","enum":["GIPHY"],"default":"GIPHY"}}},"textSpoilers":{"type":"array","maxItems":10,"description":"Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].","items":{"type":"object","required":["offset","length"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1}}}},"spoilerMedia":{"type":"boolean","description":"Blur the image/video/carousel as a spoiler (is_spoiler_media)."},"textAttachment":{"type":"object","description":"Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.","required":["plaintext"],"properties":{"plaintext":{"type":"string","maxLength":10000},"linkAttachmentUrl":{"type":"string","format":"uri","description":"Not allowed when linkAttachment is set."},"styling":{"type":"array","description":"Non-overlapping style ranges.","items":{"type":"object","required":["offset","length","styles"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1},"styles":{"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}}}}}},"topicTag":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[^.&]+$","description":"One topic tag per post (no \".\" or \"&\"; a leading \"#\" is stripped). Alias: topic_tag."},"ghostPost":{"type":"boolean","description":"Ghost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only."},"quotePostId":{"type":"string","description":"Quote this Threads post id (also post.quoteExternalId)."},"replyToId":{"type":"string","description":"Publish as a reply to this post id (also post.replyToExternalId)."},"allowlistedCountryCodes":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z]{2}$"},"description":"Geo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only)."},"locationId":{"type":"string","description":"Location tag id from location search (threads_location_tagging)."},"crossShareToInstagram":{"type":"boolean","description":"Also share to the linked Instagram account as a Story (threads_share_to_instagram)."},"crossShareToInstagramDarkMode":{"type":"boolean","description":"Dark-mode Instagram Story."},"autoPublishText":{"type":"boolean","description":"Publish TEXT posts in one call (auto_publish_text)."},"thread":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","maxLength":500},"media":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}}},"mediaItems":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}},"description":"Zernio alias of media."},"linkAttachment":{"type":"string","format":"uri","description":"Link preview card (TEXT posts only). Alias: link_attachment."},"poll":{"description":"Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, `{ options: [...] }` or `{ option_a … option_d }`.","oneOf":[{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},{"type":"object","properties":{"options":{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},"option_a":{"type":"string"},"option_b":{"type":"string"},"option_c":{"type":"string"},"option_d":{"type":"string"}}}]},"gif":{"type":"object","description":"GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).","required":["gifId"],"properties":{"gifId":{"type":"string"},"provider":{"type":"string","enum":["GIPHY"],"default":"GIPHY"}}},"textSpoilers":{"type":"array","maxItems":10,"description":"Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].","items":{"type":"object","required":["offset","length"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1}}}},"spoilerMedia":{"type":"boolean","description":"Blur the image/video/carousel as a spoiler (is_spoiler_media)."},"textAttachment":{"type":"object","description":"Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.","required":["plaintext"],"properties":{"plaintext":{"type":"string","maxLength":10000},"linkAttachmentUrl":{"type":"string","format":"uri","description":"Not allowed when linkAttachment is set."},"styling":{"type":"array","description":"Non-overlapping style ranges.","items":{"type":"object","required":["offset","length","styles"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1},"styles":{"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}}}}}},"topicTag":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[^.&]+$","description":"One topic tag per post (no \".\" or \"&\"; a leading \"#\" is stripped). Alias: topic_tag."}}},"description":"Follow-up posts chained after the root (each replies to the previous one)."},"threadItems":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","maxLength":500},"media":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}}},"mediaItems":{"type":"array","maxItems":20,"items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"altText":{"type":"string","maxLength":1000}}},"description":"Zernio alias of media."},"linkAttachment":{"type":"string","format":"uri","description":"Link preview card (TEXT posts only). Alias: link_attachment."},"poll":{"description":"Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, `{ options: [...] }` or `{ option_a … option_d }`.","oneOf":[{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},{"type":"object","properties":{"options":{"type":"array","minItems":2,"maxItems":4,"items":{"type":"string","minLength":1,"maxLength":25}},"option_a":{"type":"string"},"option_b":{"type":"string"},"option_c":{"type":"string"},"option_d":{"type":"string"}}}]},"gif":{"type":"object","description":"GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).","required":["gifId"],"properties":{"gifId":{"type":"string"},"provider":{"type":"string","enum":["GIPHY"],"default":"GIPHY"}}},"textSpoilers":{"type":"array","maxItems":10,"description":"Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].","items":{"type":"object","required":["offset","length"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1}}}},"spoilerMedia":{"type":"boolean","description":"Blur the image/video/carousel as a spoiler (is_spoiler_media)."},"textAttachment":{"type":"object","description":"Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.","required":["plaintext"],"properties":{"plaintext":{"type":"string","maxLength":10000},"linkAttachmentUrl":{"type":"string","format":"uri","description":"Not allowed when linkAttachment is set."},"styling":{"type":"array","description":"Non-overlapping style ranges.","items":{"type":"object","required":["offset","length","styles"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1},"styles":{"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}}}}}},"topicTag":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[^.&]+$","description":"One topic tag per post (no \".\" or \"&\"; a leading \"#\" is stripped). Alias: topic_tag."}}},"description":"Zernio semantics: the full thread, [0] is the root; when set, the post content/media are not published."},"firstComment":{"type":"string","maxLength":500,"description":"Self-reply posted under the root post (counts toward 250/24 h)."},"altText":{"type":"string","maxLength":1000,"description":"Fallback alt text for single-media posts."},"checkQuota":{"type":"boolean","description":"Check threads_publishing_limit before publishing (fails fast at 250/24 h)."}},"description":"Text, image, video or carousel (2–20) post with any Threads option."}}},"description":"Text, image, video or carousel (2–20) post with any Threads option."},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-validate","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/posts/container-status":{"post":{"operationId":"threadsPostsContainerStatus","summary":"Threads: Container status (Posts)","tags":["Focus · Threads"],"description":"IN_PROGRESS / FINISHED / PUBLISHED / ERROR / EXPIRED with error_message. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"container_id":{"type":"string"}},"required":["container_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-container-status","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/posts/web-intent":{"post":{"operationId":"threadsPostsWebIntent","summary":"Threads: Web intent link (Posts)","tags":["Focus · Threads"],"description":"threads.net composer link prefilled with text (no API call). Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"url":{"type":"string","format":"uri"},"reply_control":{"type":"string"},"topic_tag":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-posts-web-intent","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/ghost-posts":{"get":{"operationId":"threadsGhostPostsList","summary":"Threads: List Ghost posts","tags":["Focus · Threads"],"description":"Text posts that auto-archive after 24 hours (ACTIVE / ARCHIVED). Text spoilers only, cannot be replies. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/create-posts/ghost-posts.md Generic route: `/v1/accounts/{accountId}/focus/ghost-posts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-ghost-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"],"maxLength":500},"media_type":{"type":"string","enum":["TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"],"readOnly":true},"media_product_type":{"type":["null","string"],"readOnly":true},"media_url":{"type":["null","string"],"format":"uri","readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"permalink":{"type":["null","string"],"format":"uri","readOnly":true},"shortcode":{"type":["null","string"],"readOnly":true},"username":{"type":["null","string"],"readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"timestamp":{"type":"string","format":"date-time","readOnly":true},"is_quote_post":{"type":"boolean","readOnly":true},"quoted_post_id":{"type":["null","string"],"readOnly":true},"is_repost":{"type":"boolean","readOnly":true},"reposted_post_id":{"type":["null","string"],"readOnly":true},"alt_text":{"type":["null","string"],"maxLength":1000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri","readOnly":true},"has_replies":{"type":"boolean","readOnly":true},"reply_audience":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null],"readOnly":true},"is_spoiler_media":{"type":"boolean"},"text_spoilers":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"}}}},"text_attachment":{"type":["null","object"],"properties":{"plaintext":{"type":"string","maxLength":10000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"text_with_styling_info":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"},"styling_info":{"type":"array","items":{"type":"string"}}}}}}},"topic_tag":{"type":["null","string"],"maxLength":50},"location_id":{"type":["null","string"]},"poll":{"type":["null","object"],"properties":{"options":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"votes_percentage":{"type":["null","number"]}}}},"total_votes":{"type":["null","integer"]},"expires_at":{"type":["null","string"],"format":"date-time"}}},"children":{"type":"array","items":{"type":"string"},"readOnly":true},"allowlisted_country_codes":{"type":["null","array"],"items":{"type":"string"}},"ghost_post_status":{"type":["null","string"],"enum":["ACTIVE","ARCHIVED",null],"readOnly":true},"ghost_post_expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"threadsGhostPostsCreate","summary":"Threads: Create a Ghost posts item","tags":["Focus · Threads"],"description":"Text posts that auto-archive after 24 hours (ACTIVE / ARCHIVED). Text spoilers only, cannot be replies. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/create-posts/ghost-posts.md Generic route: `/v1/accounts/{accountId}/focus/ghost-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":500},"textSpoilers":{"type":"array","maxItems":10,"description":"Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].","items":{"type":"object","required":["offset","length"],"properties":{"offset":{"type":"integer","minimum":0},"length":{"type":"integer","minimum":1}}}},"replyControl":{"type":"string","enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"],"description":"Who can reply. Alias: reply_control."},"topicTag":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[^.&]+$","description":"One topic tag per post (no \".\" or \"&\"; a leading \"#\" is stripped). Alias: topic_tag."}},"required":["content"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_threads","x-mcp-tool":"threads-ghost-posts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"],"maxLength":500},"media_type":{"type":"string","enum":["TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"],"readOnly":true},"media_product_type":{"type":["null","string"],"readOnly":true},"media_url":{"type":["null","string"],"format":"uri","readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"permalink":{"type":["null","string"],"format":"uri","readOnly":true},"shortcode":{"type":["null","string"],"readOnly":true},"username":{"type":["null","string"],"readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"timestamp":{"type":"string","format":"date-time","readOnly":true},"is_quote_post":{"type":"boolean","readOnly":true},"quoted_post_id":{"type":["null","string"],"readOnly":true},"is_repost":{"type":"boolean","readOnly":true},"reposted_post_id":{"type":["null","string"],"readOnly":true},"alt_text":{"type":["null","string"],"maxLength":1000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri","readOnly":true},"has_replies":{"type":"boolean","readOnly":true},"reply_audience":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null],"readOnly":true},"is_spoiler_media":{"type":"boolean"},"text_spoilers":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"}}}},"text_attachment":{"type":["null","object"],"properties":{"plaintext":{"type":"string","maxLength":10000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"text_with_styling_info":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"},"styling_info":{"type":"array","items":{"type":"string"}}}}}}},"topic_tag":{"type":["null","string"],"maxLength":50},"location_id":{"type":["null","string"]},"poll":{"type":["null","object"],"properties":{"options":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"votes_percentage":{"type":["null","number"]}}}},"total_votes":{"type":["null","integer"]},"expires_at":{"type":["null","string"],"format":"date-time"}}},"children":{"type":"array","items":{"type":"string"},"readOnly":true},"allowlisted_country_codes":{"type":["null","array"],"items":{"type":"string"}},"ghost_post_status":{"type":["null","string"],"enum":["ACTIVE","ARCHIVED",null],"readOnly":true},"ghost_post_expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/ghost-posts/{itemId}":{"delete":{"operationId":"threadsGhostPostsDelete","summary":"Threads: Delete a Ghost posts item","tags":["Focus · Threads"],"description":"Text posts that auto-archive after 24 hours (ACTIVE / ARCHIVED). Text spoilers only, cannot be replies. Requires scopes: threads_basic, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/create-posts/ghost-posts.md Generic route: `/v1/accounts/{accountId}/focus/ghost-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_threads","x-mcp-tool":"threads-ghost-posts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/reposts":{"get":{"operationId":"threadsRepostsList","summary":"Threads: List Reposts","tags":["Focus · Threads"],"description":"Posts you reposted (REPOST_FACADE). Repost any post by id, or undo a repost. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/posts/reposts.md Generic route: `/v1/accounts/{accountId}/focus/reposts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-reposts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"],"maxLength":500},"media_type":{"type":"string","enum":["TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"],"readOnly":true},"media_product_type":{"type":["null","string"],"readOnly":true},"media_url":{"type":["null","string"],"format":"uri","readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"permalink":{"type":["null","string"],"format":"uri","readOnly":true},"shortcode":{"type":["null","string"],"readOnly":true},"username":{"type":["null","string"],"readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"timestamp":{"type":"string","format":"date-time","readOnly":true},"is_quote_post":{"type":"boolean","readOnly":true},"quoted_post_id":{"type":["null","string"],"readOnly":true},"is_repost":{"type":"boolean","readOnly":true},"reposted_post_id":{"type":["null","string"],"readOnly":true},"alt_text":{"type":["null","string"],"maxLength":1000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri","readOnly":true},"has_replies":{"type":"boolean","readOnly":true},"reply_audience":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null],"readOnly":true},"is_spoiler_media":{"type":"boolean"},"text_spoilers":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"}}}},"text_attachment":{"type":["null","object"],"properties":{"plaintext":{"type":"string","maxLength":10000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"text_with_styling_info":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"},"styling_info":{"type":"array","items":{"type":"string"}}}}}}},"topic_tag":{"type":["null","string"],"maxLength":50},"location_id":{"type":["null","string"]},"poll":{"type":["null","object"],"properties":{"options":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"votes_percentage":{"type":["null","number"]}}}},"total_votes":{"type":["null","integer"]},"expires_at":{"type":["null","string"],"format":"date-time"}}},"children":{"type":"array","items":{"type":"string"},"readOnly":true},"allowlisted_country_codes":{"type":["null","array"],"items":{"type":"string"}},"ghost_post_status":{"type":["null","string"],"enum":["ACTIVE","ARCHIVED",null],"readOnly":true},"ghost_post_expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"threadsRepostsCreate","summary":"Threads: Create a Reposts item","tags":["Focus · Threads"],"description":"Posts you reposted (REPOST_FACADE). Repost any post by id, or undo a repost. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/posts/reposts.md Generic route: `/v1/accounts/{accountId}/focus/reposts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string","description":"Threads media id to repost"}},"required":["post_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_threads","x-mcp-tool":"threads-reposts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"],"maxLength":500},"media_type":{"type":"string","enum":["TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"],"readOnly":true},"media_product_type":{"type":["null","string"],"readOnly":true},"media_url":{"type":["null","string"],"format":"uri","readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"permalink":{"type":["null","string"],"format":"uri","readOnly":true},"shortcode":{"type":["null","string"],"readOnly":true},"username":{"type":["null","string"],"readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"timestamp":{"type":"string","format":"date-time","readOnly":true},"is_quote_post":{"type":"boolean","readOnly":true},"quoted_post_id":{"type":["null","string"],"readOnly":true},"is_repost":{"type":"boolean","readOnly":true},"reposted_post_id":{"type":["null","string"],"readOnly":true},"alt_text":{"type":["null","string"],"maxLength":1000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri","readOnly":true},"has_replies":{"type":"boolean","readOnly":true},"reply_audience":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null],"readOnly":true},"is_spoiler_media":{"type":"boolean"},"text_spoilers":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"}}}},"text_attachment":{"type":["null","object"],"properties":{"plaintext":{"type":"string","maxLength":10000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"text_with_styling_info":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"},"styling_info":{"type":"array","items":{"type":"string"}}}}}}},"topic_tag":{"type":["null","string"],"maxLength":50},"location_id":{"type":["null","string"]},"poll":{"type":["null","object"],"properties":{"options":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"votes_percentage":{"type":["null","number"]}}}},"total_votes":{"type":["null","integer"]},"expires_at":{"type":["null","string"],"format":"date-time"}}},"children":{"type":"array","items":{"type":"string"},"readOnly":true},"allowlisted_country_codes":{"type":["null","array"],"items":{"type":"string"}},"ghost_post_status":{"type":["null","string"],"enum":["ACTIVE","ARCHIVED",null],"readOnly":true},"ghost_post_expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/reposts/{itemId}":{"delete":{"operationId":"threadsRepostsDelete","summary":"Threads: Delete a Reposts item","tags":["Focus · Threads"],"description":"Posts you reposted (REPOST_FACADE). Repost any post by id, or undo a repost. Requires scopes: threads_basic, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/posts/reposts.md Generic route: `/v1/accounts/{accountId}/focus/reposts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_threads","x-mcp-tool":"threads-reposts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/locations":{"get":{"operationId":"threadsLocationsList","summary":"Threads: List Locations","tags":["Focus · Threads"],"description":"Search places to tag on posts (500 searches / 24 h). Use the id as `locationId` when composing. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_location_tagging. Network docs: https://developers.facebook.com/documentation/threads/create-posts/location-tagging.md Generic route: `/v1/accounts/{accountId}/focus/locations`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":false,"description":"Place name"},{"schema":{"type":"number"},"in":"query","name":"latitude","required":false},{"schema":{"type":"number"},"in":"query","name":"longitude","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-locations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"address":{"type":["null","string"]},"city":{"type":["null","string"]},"country":{"type":["null","string"]},"latitude":{"type":["null","number"]},"longitude":{"type":["null","number"]},"postal_code":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/locations/{itemId}":{"get":{"operationId":"threadsLocationsGet","summary":"Threads: Get a Locations item","tags":["Focus · Threads"],"description":"Search places to tag on posts (500 searches / 24 h). Use the id as `locationId` when composing. Requires scopes: threads_location_tagging. Network docs: https://developers.facebook.com/documentation/threads/create-posts/location-tagging.md Generic route: `/v1/accounts/{accountId}/focus/locations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-locations-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"address":{"type":["null","string"]},"city":{"type":["null","string"]},"country":{"type":["null","string"]},"latitude":{"type":["null","number"]},"longitude":{"type":["null","number"]},"postal_code":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/commented-posts":{"get":{"operationId":"threadsCommentedPostsList","summary":"Threads: List Posts with replies","tags":["Focus · Threads"],"description":"Your recent posts that have replies — the entry point to moderation. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_basic. Generic route: `/v1/accounts/{accountId}/focus/commented-posts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-commented-posts-list","x-zernio":["GET /v1/inbox/comments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"media_type":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"],"format":"uri"},"has_replies":{"type":"boolean"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/replies":{"get":{"operationId":"threadsRepliesList","summary":"Threads: List Replies","tags":["Focus · Threads"],"description":"Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_read_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: `/v1/accounts/{accountId}/focus/replies`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"post_id","required":true,"description":"Threads post id"},{"schema":{"type":"boolean","default":true},"in":"query","name":"reverse","required":false,"description":"Newest first"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-replies-list","x-zernio":["GET /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"],"format":"uri"},"author_verified":{"type":["null","boolean"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer","description":"Always 0: Threads exposes no reply like counts"},"permalink":{"type":["null","string"],"format":"uri"},"media_type":{"type":["null","string"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri"},"has_replies":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"root_owner_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"is_own":{"type":"boolean"},"hide_status":{"type":["null","string"],"enum":["NOT_HUSHED","UNHUSHED","HIDDEN","COVERED","BLOCKED","RESTRICTED",null]},"hidden":{"type":"boolean"},"reply_audience":{"type":["null","string"]},"is_quote_post":{"type":"boolean"},"quoted_post_id":{"type":["null","string"]},"topic_tag":{"type":["null","string"]},"approval_status":{"type":["null","string"],"enum":["pending","ignored","approved",null]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"threadsRepliesCreate","summary":"Threads: Create a Replies item","tags":["Focus · Threads"],"description":"Reply to a post or reply (`reply_to_id`). Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reply_to_id":{"type":"string"},"text":{"type":"string","maxLength":500},"media":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"media_id":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"type":{"type":"string","enum":["image","video","gif"]},"altText":{"type":"string","maxLength":1000}},"description":"JPEG/PNG ≤ 8 MB or MP4/MOV ≤ 5 min / 1 GB, aspect within 10:1"},"maxItems":20}},"required":["reply_to_id","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_threads","x-mcp-tool":"threads-replies-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}","POST /v1/inbox/comments/{postId}/{commentId}/hide"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"],"format":"uri"},"author_verified":{"type":["null","boolean"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer","description":"Always 0: Threads exposes no reply like counts"},"permalink":{"type":["null","string"],"format":"uri"},"media_type":{"type":["null","string"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri"},"has_replies":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"root_owner_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"is_own":{"type":"boolean"},"hide_status":{"type":["null","string"],"enum":["NOT_HUSHED","UNHUSHED","HIDDEN","COVERED","BLOCKED","RESTRICTED",null]},"hidden":{"type":"boolean"},"reply_audience":{"type":["null","string"]},"is_quote_post":{"type":"boolean"},"quoted_post_id":{"type":["null","string"]},"topic_tag":{"type":["null","string"]},"approval_status":{"type":["null","string"],"enum":["pending","ignored","approved",null]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/replies/{itemId}":{"delete":{"operationId":"threadsRepliesDelete","summary":"Threads: Delete a Replies item","tags":["Focus · Threads"],"description":"Delete one of your own replies. Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: `/v1/accounts/{accountId}/focus/replies`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_threads","x-mcp-tool":"threads-replies-delete","x-zernio":["DELETE /v1/inbox/comments/{postId}","DELETE /v1/inbox/comments/{postId}/{commentId}/hide"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/replies/{itemId}/reply":{"post":{"operationId":"threadsRepliesReply","summary":"Threads: Reply (Replies)","tags":["Focus · Threads"],"description":"Reply. Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":500},"media":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"media_id":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"type":{"type":"string","enum":["image","video","gif"]},"altText":{"type":"string","maxLength":1000}},"description":"JPEG/PNG ≤ 8 MB or MP4/MOV ≤ 5 min / 1 GB, aspect within 10:1"},"maxItems":20}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-replies-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/replies/{itemId}/hide":{"post":{"operationId":"threadsRepliesHide","summary":"Threads: Hide (Replies)","tags":["Focus · Threads"],"description":"Hide a top-level reply (nested replies are hidden with it). Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-replies-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/replies/{itemId}/unhide":{"post":{"operationId":"threadsRepliesUnhide","summary":"Threads: Unhide (Replies)","tags":["Focus · Threads"],"description":"Unhide. Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-replies-unhide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/conversation":{"get":{"operationId":"threadsConversationList","summary":"Threads: List Conversation","tags":["Focus · Threads"],"description":"The full, flattened conversation of a post (top-level and nested replies). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_read_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: `/v1/accounts/{accountId}/focus/conversation`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"post_id","required":true,"description":"Threads post id"},{"schema":{"type":"boolean","default":true},"in":"query","name":"reverse","required":false,"description":"Newest first"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-conversation-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"],"format":"uri"},"author_verified":{"type":["null","boolean"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer","description":"Always 0: Threads exposes no reply like counts"},"permalink":{"type":["null","string"],"format":"uri"},"media_type":{"type":["null","string"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri"},"has_replies":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"root_owner_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"is_own":{"type":"boolean"},"hide_status":{"type":["null","string"],"enum":["NOT_HUSHED","UNHUSHED","HIDDEN","COVERED","BLOCKED","RESTRICTED",null]},"hidden":{"type":"boolean"},"reply_audience":{"type":["null","string"]},"is_quote_post":{"type":"boolean"},"quoted_post_id":{"type":["null","string"]},"topic_tag":{"type":["null","string"]},"approval_status":{"type":["null","string"],"enum":["pending","ignored","approved",null]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/conversation/{itemId}/reply":{"post":{"operationId":"threadsConversationReply","summary":"Threads: Reply (Conversation)","tags":["Focus · Threads"],"description":"Reply. The full, flattened conversation of a post (top-level and nested replies). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: `/v1/accounts/{accountId}/focus/conversation`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":500},"media":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"media_id":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"type":{"type":"string","enum":["image","video","gif"]},"altText":{"type":"string","maxLength":1000}},"description":"JPEG/PNG ≤ 8 MB or MP4/MOV ≤ 5 min / 1 GB, aspect within 10:1"},"maxItems":20}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-conversation-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/conversation/{itemId}/hide":{"post":{"operationId":"threadsConversationHide","summary":"Threads: Hide (Conversation)","tags":["Focus · Threads"],"description":"Hide a top-level reply (nested replies are hidden with it). The full, flattened conversation of a post (top-level and nested replies). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: `/v1/accounts/{accountId}/focus/conversation`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-conversation-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/conversation/{itemId}/unhide":{"post":{"operationId":"threadsConversationUnhide","summary":"Threads: Unhide (Conversation)","tags":["Focus · Threads"],"description":"Unhide. The full, flattened conversation of a post (top-level and nested replies). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: `/v1/accounts/{accountId}/focus/conversation`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-conversation-unhide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/pending-replies":{"get":{"operationId":"threadsPendingRepliesList","summary":"Threads: List Reply approvals","tags":["Focus · Threads"],"description":"Replies held for approval on posts published with reply approvals. Approve or ignore them. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/reply-management.md Generic route: `/v1/accounts/{accountId}/focus/pending-replies`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"post_id","required":true},{"schema":{"type":"string","enum":["pending","ignored"],"default":"pending"},"in":"query","name":"approval_status","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"reverse","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-pending-replies-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"],"format":"uri"},"author_verified":{"type":["null","boolean"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer","description":"Always 0: Threads exposes no reply like counts"},"permalink":{"type":["null","string"],"format":"uri"},"media_type":{"type":["null","string"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri"},"has_replies":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"root_owner_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"is_own":{"type":"boolean"},"hide_status":{"type":["null","string"],"enum":["NOT_HUSHED","UNHUSHED","HIDDEN","COVERED","BLOCKED","RESTRICTED",null]},"hidden":{"type":"boolean"},"reply_audience":{"type":["null","string"]},"is_quote_post":{"type":"boolean"},"quoted_post_id":{"type":["null","string"]},"topic_tag":{"type":["null","string"]},"approval_status":{"type":["null","string"],"enum":["pending","ignored","approved",null]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/pending-replies/{itemId}/approve":{"post":{"operationId":"threadsPendingRepliesApprove","summary":"Threads: Approve (Reply approvals)","tags":["Focus · Threads"],"description":"Approve. Replies held for approval on posts published with reply approvals. Approve or ignore them. Requires scopes: threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/reply-management.md Generic route: `/v1/accounts/{accountId}/focus/pending-replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-pending-replies-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/pending-replies/{itemId}/ignore":{"post":{"operationId":"threadsPendingRepliesIgnore","summary":"Threads: Ignore (Reply approvals)","tags":["Focus · Threads"],"description":"Ignore. Replies held for approval on posts published with reply approvals. Approve or ignore them. Destructive. Requires scopes: threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/reply-management.md Generic route: `/v1/accounts/{accountId}/focus/pending-replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_threads","x-mcp-tool":"threads-pending-replies-ignore","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/mentions":{"get":{"operationId":"threadsMentionsList","summary":"Threads: List Mentions","tags":["Focus · Threads"],"description":"Public posts that @mention you, including quote posts. Reply from here. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_manage_mentions. Network docs: https://developers.facebook.com/documentation/threads/threads-mentions.md Generic route: `/v1/accounts/{accountId}/focus/mentions`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-mentions-list","x-zernio":["GET /v1/inbox/mentions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"kind":{"type":"string","enum":["mention","reply","quote"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"permalink":{"type":["null","string"],"format":"uri"},"post_id":{"type":"string"},"media_type":{"type":["null","string"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri"},"alt_text":{"type":["null","string"]},"has_replies":{"type":"boolean"},"is_quote_post":{"type":"boolean"},"quoted_post_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/mentions/{itemId}/reply":{"post":{"operationId":"threadsMentionsReply","summary":"Threads: Reply (Mentions)","tags":["Focus · Threads"],"description":"Reply. Public posts that @mention you, including quote posts. Reply from here. Requires scopes: threads_manage_mentions. Network docs: https://developers.facebook.com/documentation/threads/threads-mentions.md Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":500},"media":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"media_id":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"type":{"type":"string","enum":["image","video","gif"]},"altText":{"type":"string","maxLength":1000}},"description":"JPEG/PNG ≤ 8 MB or MP4/MOV ≤ 5 min / 1 GB, aspect within 10:1"},"maxItems":20}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-mentions-reply","x-idempotent":true,"x-zernio":["POST /v1/inbox/mentions/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/quote-mentions":{"get":{"operationId":"threadsQuoteMentionsList","summary":"Threads: List Quotes","tags":["Focus · Threads"],"description":"Quote posts that mention you (from the mentions feed). Per-post quote and repost counts are under Insights › Engagement. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_manage_mentions. Generic route: `/v1/accounts/{accountId}/focus/quote-mentions`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-quote-mentions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"kind":{"type":"string","enum":["mention","reply","quote"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer"},"permalink":{"type":["null","string"],"format":"uri"},"post_id":{"type":"string"},"media_type":{"type":["null","string"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri"},"alt_text":{"type":["null","string"]},"has_replies":{"type":"boolean"},"is_quote_post":{"type":"boolean"},"quoted_post_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/quote-mentions/{itemId}/reply":{"post":{"operationId":"threadsQuoteMentionsReply","summary":"Threads: Reply (Quotes)","tags":["Focus · Threads"],"description":"Reply. Quote posts that mention you (from the mentions feed). Per-post quote and repost counts are under Insights › Engagement. Requires scopes: threads_manage_mentions. Generic route: `/v1/accounts/{accountId}/focus/quote-mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":500},"media":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"media_id":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"type":{"type":"string","enum":["image","video","gif"]},"altText":{"type":"string","maxLength":1000}},"description":"JPEG/PNG ≤ 8 MB or MP4/MOV ≤ 5 min / 1 GB, aspect within 10:1"},"maxItems":20}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-quote-mentions-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/my-replies":{"get":{"operationId":"threadsMyRepliesList","summary":"Threads: List My replies","tags":["Focus · Threads"],"description":"Replies you published anywhere on Threads. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_read_replies. Generic route: `/v1/accounts/{accountId}/focus/my-replies`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-my-replies-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"],"format":"uri"},"author_verified":{"type":["null","boolean"]},"created_at":{"type":"string","format":"date-time"},"like_count":{"type":"integer","description":"Always 0: Threads exposes no reply like counts"},"permalink":{"type":["null","string"],"format":"uri"},"media_type":{"type":["null","string"]},"media_url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri"},"has_replies":{"type":"boolean"},"parent_id":{"type":["null","string"]},"root_id":{"type":["null","string"]},"root_owner_id":{"type":["null","string"]},"is_reply":{"type":"boolean"},"is_own":{"type":"boolean"},"hide_status":{"type":["null","string"],"enum":["NOT_HUSHED","UNHUSHED","HIDDEN","COVERED","BLOCKED","RESTRICTED",null]},"hidden":{"type":"boolean"},"reply_audience":{"type":["null","string"]},"is_quote_post":{"type":"boolean"},"quoted_post_id":{"type":["null","string"]},"topic_tag":{"type":["null","string"]},"approval_status":{"type":["null","string"],"enum":["pending","ignored","approved",null]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/my-replies/{itemId}":{"delete":{"operationId":"threadsMyRepliesDelete","summary":"Threads: Delete a My replies item","tags":["Focus · Threads"],"description":"Replies you published anywhere on Threads. Requires scopes: threads_read_replies, threads_delete. Generic route: `/v1/accounts/{accountId}/focus/my-replies`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_threads","x-mcp-tool":"threads-my-replies-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/keyword-search":{"get":{"operationId":"threadsKeywordSearchList","summary":"Threads: List Listening","tags":["Focus · Threads"],"description":"Search public posts by keyword or topic tag (TOP or RECENT) and reply to them. 2200 queries / user / 24 h; without Advanced Access only your own posts are searched. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_keyword_search. Network docs: https://developers.facebook.com/documentation/threads/keyword-search.md Generic route: `/v1/accounts/{accountId}/focus/keyword-search`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":true,"description":"Keyword, or topic tag when search_mode=TAG"},{"schema":{"type":"string","enum":["TOP","RECENT"],"default":"TOP"},"in":"query","name":"search_type","required":false},{"schema":{"type":"string","enum":["KEYWORD","TAG"],"default":"KEYWORD"},"in":"query","name":"search_mode","required":false},{"schema":{"type":"string","enum":["TEXT","IMAGE","VIDEO"]},"in":"query","name":"media_type","required":false},{"schema":{"type":"string"},"in":"query","name":"author_username","required":false,"description":"Exact username (without @)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-keyword-search-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"],"maxLength":500},"media_type":{"type":"string","enum":["TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"],"readOnly":true},"media_product_type":{"type":["null","string"],"readOnly":true},"media_url":{"type":["null","string"],"format":"uri","readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"permalink":{"type":["null","string"],"format":"uri","readOnly":true},"shortcode":{"type":["null","string"],"readOnly":true},"username":{"type":["null","string"],"readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"timestamp":{"type":"string","format":"date-time","readOnly":true},"is_quote_post":{"type":"boolean","readOnly":true},"quoted_post_id":{"type":["null","string"],"readOnly":true},"is_repost":{"type":"boolean","readOnly":true},"reposted_post_id":{"type":["null","string"],"readOnly":true},"alt_text":{"type":["null","string"],"maxLength":1000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri","readOnly":true},"has_replies":{"type":"boolean","readOnly":true},"reply_audience":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null],"readOnly":true},"is_spoiler_media":{"type":"boolean"},"text_spoilers":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"}}}},"text_attachment":{"type":["null","object"],"properties":{"plaintext":{"type":"string","maxLength":10000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"text_with_styling_info":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"},"styling_info":{"type":"array","items":{"type":"string"}}}}}}},"topic_tag":{"type":["null","string"],"maxLength":50},"location_id":{"type":["null","string"]},"poll":{"type":["null","object"],"properties":{"options":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"votes_percentage":{"type":["null","number"]}}}},"total_votes":{"type":["null","integer"]},"expires_at":{"type":["null","string"],"format":"date-time"}}},"children":{"type":"array","items":{"type":"string"},"readOnly":true},"allowlisted_country_codes":{"type":["null","array"],"items":{"type":"string"}},"ghost_post_status":{"type":["null","string"],"enum":["ACTIVE","ARCHIVED",null],"readOnly":true},"ghost_post_expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/keyword-search/{itemId}/reply":{"post":{"operationId":"threadsKeywordSearchReply","summary":"Threads: Reply (Listening)","tags":["Focus · Threads"],"description":"Reply to a public post found by search (allowed with threads_keyword_search). Search public posts by keyword or topic tag (TOP or RECENT) and reply to them. 2200 queries / user / 24 h; without Advanced Access only your own posts are searched. Requires scopes: threads_keyword_search. Network docs: https://developers.facebook.com/documentation/threads/keyword-search.md Generic route: `/v1/accounts/{accountId}/focus/keyword-search`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":500},"media":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"media_id":{"type":"string","description":"Socialit media id (resolved to a public URL)"},"type":{"type":"string","enum":["image","video","gif"]},"altText":{"type":"string","maxLength":1000}},"description":"JPEG/PNG ≤ 8 MB or MP4/MOV ≤ 5 min / 1 GB, aspect within 10:1"},"maxItems":20}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_threads","x-mcp-tool":"threads-keyword-search-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/recent-searches":{"get":{"operationId":"threadsRecentSearchesList","summary":"Threads: List Recent searches","tags":["Focus · Threads"],"description":"Keywords you searched recently (shared with the Threads app). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_keyword_search. Generic route: `/v1/accounts/{accountId}/focus/recent-searches`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-recent-searches-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"searched_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/benchmarks":{"get":{"operationId":"threadsBenchmarksList","summary":"Threads: List Benchmarks","tags":["Focus · Threads"],"description":"Compare public profiles (≥100 followers): followers and 7-day views, likes, replies, reposts, quotes. 1000 lookups / 24 h; Standard Access only allows @meta, @threads, @instagram, @facebook. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_profile_discovery. Network docs: https://developers.facebook.com/documentation/threads/threads-profiles.md Generic route: `/v1/accounts/{accountId}/focus/benchmarks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"usernames","required":true,"description":"Comma-separated usernames"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-benchmarks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"username":{"type":"string"},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"biography":{"type":["null","string"]},"is_verified":{"type":"boolean"},"follower_count":{"type":["null","integer"]},"views_count_7d":{"type":["null","integer"]},"likes_count_7d":{"type":["null","integer"]},"replies_count_7d":{"type":["null","integer"]},"reposts_count_7d":{"type":["null","integer"]},"quotes_count_7d":{"type":["null","integer"]},"profile_url":{"type":["null","string"],"format":"uri"},"error":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/benchmarks/{itemId}":{"get":{"operationId":"threadsBenchmarksGet","summary":"Threads: Get a Benchmarks item","tags":["Focus · Threads"],"description":"Compare public profiles (≥100 followers): followers and 7-day views, likes, replies, reposts, quotes. 1000 lookups / 24 h; Standard Access only allows @meta, @threads, @instagram, @facebook. Requires scopes: threads_profile_discovery. Network docs: https://developers.facebook.com/documentation/threads/threads-profiles.md Generic route: `/v1/accounts/{accountId}/focus/benchmarks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-benchmarks-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"biography":{"type":["null","string"]},"is_verified":{"type":"boolean"},"follower_count":{"type":["null","integer"]},"views_count_7d":{"type":["null","integer"]},"likes_count_7d":{"type":["null","integer"]},"replies_count_7d":{"type":["null","integer"]},"reposts_count_7d":{"type":["null","integer"]},"quotes_count_7d":{"type":["null","integer"]},"profile_url":{"type":["null","string"],"format":"uri"},"error":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/profile-posts":{"get":{"operationId":"threadsProfilePostsList","summary":"Threads: List Profile posts","tags":["Focus · Threads"],"description":"Public posts of another profile (competitor content). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_profile_discovery. Network docs: https://developers.facebook.com/documentation/threads/threads-profiles.md Generic route: `/v1/accounts/{accountId}/focus/profile-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"username","required":true},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (`next_cursor` of the previous page)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-profile-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"],"maxLength":500},"media_type":{"type":"string","enum":["TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"],"readOnly":true},"media_product_type":{"type":["null","string"],"readOnly":true},"media_url":{"type":["null","string"],"format":"uri","readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"permalink":{"type":["null","string"],"format":"uri","readOnly":true},"shortcode":{"type":["null","string"],"readOnly":true},"username":{"type":["null","string"],"readOnly":true},"owner_id":{"type":["null","string"],"readOnly":true},"timestamp":{"type":"string","format":"date-time","readOnly":true},"is_quote_post":{"type":"boolean","readOnly":true},"quoted_post_id":{"type":["null","string"],"readOnly":true},"is_repost":{"type":"boolean","readOnly":true},"reposted_post_id":{"type":["null","string"],"readOnly":true},"alt_text":{"type":["null","string"],"maxLength":1000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"gif_url":{"type":["null","string"],"format":"uri","readOnly":true},"has_replies":{"type":"boolean","readOnly":true},"reply_audience":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null],"readOnly":true},"is_spoiler_media":{"type":"boolean"},"text_spoilers":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"}}}},"text_attachment":{"type":["null","object"],"properties":{"plaintext":{"type":"string","maxLength":10000},"link_attachment_url":{"type":["null","string"],"format":"uri"},"text_with_styling_info":{"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer"},"length":{"type":"integer"},"styling_info":{"type":"array","items":{"type":"string"}}}}}}},"topic_tag":{"type":["null","string"],"maxLength":50},"location_id":{"type":["null","string"]},"poll":{"type":["null","object"],"properties":{"options":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"votes_percentage":{"type":["null","number"]}}}},"total_votes":{"type":["null","integer"]},"expires_at":{"type":["null","string"],"format":"date-time"}}},"children":{"type":"array","items":{"type":"string"},"readOnly":true},"allowlisted_country_codes":{"type":["null","array"],"items":{"type":"string"}},"ghost_post_status":{"type":["null","string"],"enum":["ACTIVE","ARCHIVED",null],"readOnly":true},"ghost_post_expires_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/account-insights":{"get":{"operationId":"threadsAccountInsightsGet","summary":"Threads: Get Overview","tags":["Focus · Threads"],"description":"Profile views per day plus likes, replies, reposts, quotes and link clicks, with the current follower count. Data from 2024-06-01. Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: `/v1/accounts/{accountId}/focus/account-insights`.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"boolean"},"in":"query","name":"daily","required":false,"description":"Per-day interactions (one request per day; default for ≤31 days)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-account-insights-get","x-zernio":["GET /v1/accounts/follower-stats","GET /v1/analytics/daily-metrics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"metrics":{"type":"object","properties":{"views":{"type":"number"},"profile_views":{"type":"number"},"likes":{"type":"number"},"comments":{"type":"number","description":"Replies"},"shares":{"type":"number","description":"Reposts (+ shares on posts)"},"quotes":{"type":"number"},"clicks":{"type":"number","description":"Link clicks"},"followers":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"}}}}}},"totals":{"type":"object","properties":{"views":{"type":"number"},"profile_views":{"type":"number"},"likes":{"type":"number"},"comments":{"type":"number","description":"Replies"},"shares":{"type":"number","description":"Reposts (+ shares on posts)"},"quotes":{"type":"number"},"clicks":{"type":"number","description":"Link clicks"},"followers":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/post-insights":{"get":{"operationId":"threadsPostInsightsList","summary":"Threads: List Post performance","tags":["Focus · Threads"],"description":"Lifetime views, likes, replies, reposts, quotes and shares of your recent posts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: `/v1/accounts/{accountId}/focus/post-insights`.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["views","likes","replies","reposts","quotes","shares","engagements"],"default":"views"},"in":"query","name":"sort_by","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-post-insights-list","x-zernio":["GET /v1/analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"timestamp":{"type":"string","format":"date-time"},"media_type":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"],"format":"uri"},"topic_tag":{"type":["null","string"]},"views":{"type":"number"},"likes":{"type":"number"},"replies":{"type":"number"},"reposts":{"type":"number"},"quotes":{"type":"number"},"shares":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":["null","number"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/quotes-reposts":{"get":{"operationId":"threadsQuotesRepostsList","summary":"Threads: List Quotes & reposts","tags":["Focus · Threads"],"description":"How often each of your posts was quoted and reposted (Threads does not list who reposted). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: `/v1/accounts/{accountId}/focus/quotes-reposts`.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["views","likes","replies","reposts","quotes","shares","engagements"],"default":"quotes"},"in":"query","name":"sort_by","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-quotes-reposts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"timestamp":{"type":"string","format":"date-time"},"media_type":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"],"format":"uri"},"topic_tag":{"type":["null","string"]},"views":{"type":"number"},"likes":{"type":"number"},"replies":{"type":"number"},"reposts":{"type":"number"},"quotes":{"type":"number"},"shares":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":["null","number"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/demographics":{"get":{"operationId":"threadsDemographicsGet","summary":"Threads: Get Audience","tags":["Focus · Threads"],"description":"Follower split by country, city, age and gender (needs ≥100 followers). Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: `/v1/accounts/{accountId}/focus/demographics`.","parameters":[{"schema":{"type":"string","enum":["country","city","age","gender"]},"in":"query","name":"breakdown","required":false,"description":"Only this breakdown (one request)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-demographics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"number"}}}},"cities":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"number"}}}},"ages":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"number"}}}},"genders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"number"}}}},"age_gender":{"type":"array","items":{"type":"object","properties":{"age":{"type":"string"},"gender":{"type":["null","string"]},"value":{"type":"number"}}}},"unavailable":{"type":"array","items":{"type":"object","properties":{"breakdown":{"type":"string"},"error":{"type":"string"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/link-clicks":{"get":{"operationId":"threadsLinkClicksList","summary":"Threads: List Link clicks","tags":["Focus · Threads"],"description":"Clicks per link in your posts for the period. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_manage_insights. Generic route: `/v1/accounts/{accountId}/focus/link-clicks`.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"Start (ISO date/time or unix seconds)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false,"description":"End (ISO date/time or unix seconds)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-link-clicks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"link_url":{"type":"string","format":"uri"},"clicks":{"type":"integer"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/polls":{"get":{"operationId":"threadsPollsList","summary":"Threads: List Poll results","tags":["Focus · Threads"],"description":"Your recent polls with vote percentages, total votes and expiry. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: threads_basic. Generic route: `/v1/accounts/{accountId}/focus/polls`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-polls-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":["null","string"]},"permalink":{"type":["null","string"],"format":"uri"},"timestamp":{"type":"string","format":"date-time"},"options":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"votes_percentage":{"type":["null","number"]}}}},"total_votes":{"type":["null","integer"]},"expires_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/publishing-limit":{"get":{"operationId":"threadsPublishingLimitGet","summary":"Threads: Get Publishing limits","tags":["Focus · Threads"],"description":"Rolling 24 h usage: 250 posts, 1000 replies, 100 deletes, 500 location searches. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/troubleshooting.md Generic route: `/v1/accounts/{accountId}/focus/publishing-limit`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-publishing-limit-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"posts":{"type":"object","properties":{"used":{"type":"integer"},"total":{"type":"integer"},"remaining":{"type":"integer"},"window_seconds":{"type":"integer"}}},"replies":{"type":"object","properties":{"used":{"type":"integer"},"total":{"type":"integer"},"remaining":{"type":"integer"},"window_seconds":{"type":"integer"}}},"deletes":{"type":"object","properties":{"used":{"type":"integer"},"total":{"type":"integer"},"remaining":{"type":"integer"},"window_seconds":{"type":"integer"}}},"location_searches":{"type":"object","properties":{"used":{"type":"integer"},"total":{"type":"integer"},"remaining":{"type":"integer"},"window_seconds":{"type":"integer"}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/profile":{"get":{"operationId":"threadsProfileGet","summary":"Threads: Get Profile","tags":["Focus · Threads"],"description":"Your Threads profile. Threads has no API to edit name, bio or picture; links are parsed from the bio. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/reference/user.md Generic route: `/v1/accounts/{accountId}/focus/profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":["null","string"],"readOnly":true},"biography":{"type":["null","string"],"readOnly":true},"bio_links":{"type":"array","items":{"type":"string"},"readOnly":true},"avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_verified":{"type":"boolean","readOnly":true},"profile_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_eligible_for_geo_gating":{"type":["null","boolean"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/publishing-defaults":{"get":{"operationId":"threadsPublishingDefaultsGet","summary":"Threads: Get Publishing defaults","tags":["Focus · Threads"],"description":"Defaults applied to every Threads post from this account (per-post options win): cross-share to Instagram Story, who can reply, reply approvals, topic tag, country allowlist. Requires scopes: threads_basic. Generic route: `/v1/accounts/{accountId}/focus/publishing-defaults`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-publishing-defaults-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"replyControl":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null]},"enableReplyApprovals":{"type":"boolean","default":false},"topicTag":{"type":["null","string"],"maxLength":50},"allowlistedCountryCodes":{"type":["null","array"],"items":{"type":"string","pattern":"^[A-Z]{2}$"}},"crossShareToInstagram":{"type":"boolean","default":false,"description":"Also share new posts to the linked Instagram Story"},"crossShareToInstagramDarkMode":{"type":"boolean","default":false},"autoPublishText":{"type":"boolean","default":false},"checkQuota":{"type":"boolean","default":false}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"threadsPublishingDefaultsUpdate","summary":"Threads: Update Publishing defaults","tags":["Focus · Threads"],"description":"Returns `metadata` to persist on the social account. Defaults applied to every Threads post from this account (per-post options win): cross-share to Instagram Story, who can reply, reply approvals, topic tag, country allowlist. Requires scopes: threads_basic. Generic route: `/v1/accounts/{accountId}/focus/publishing-defaults`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"replyControl":{"type":["string","null"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null]},"enableReplyApprovals":{"type":"boolean","default":false},"topicTag":{"type":["string","null"],"maxLength":50},"allowlistedCountryCodes":{"type":["array","null"],"items":{"type":"string","pattern":"^[A-Z]{2}$"}},"crossShareToInstagram":{"type":"boolean","default":false,"description":"Also share new posts to the linked Instagram Story"},"crossShareToInstagramDarkMode":{"type":"boolean","default":false},"autoPublishText":{"type":"boolean","default":false},"checkQuota":{"type":"boolean","default":false}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_threads","x-mcp-tool":"threads-publishing-defaults-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"replyControl":{"type":["null","string"],"enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only",null]},"enableReplyApprovals":{"type":"boolean","default":false},"topicTag":{"type":["null","string"],"maxLength":50},"allowlistedCountryCodes":{"type":["null","array"],"items":{"type":"string","pattern":"^[A-Z]{2}$"}},"crossShareToInstagram":{"type":"boolean","default":false,"description":"Also share new posts to the linked Instagram Story"},"crossShareToInstagramDarkMode":{"type":"boolean","default":false},"autoPublishText":{"type":"boolean","default":false},"checkQuota":{"type":"boolean","default":false}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/connection":{"get":{"operationId":"threadsConnectionGet","summary":"Threads: Get Connection","tags":["Focus · Threads"],"description":"Token validity, expiry and granted permissions vs. the full Threads permission set. Requires scopes: threads_basic. Generic route: `/v1/accounts/{accountId}/focus/connection`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_threads","x-mcp-tool":"threads-connection-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"is_valid":{"type":["null","boolean"]},"user_id":{"type":["null","string"]},"expires_at":{"type":["null","string"],"format":"date-time"},"data_access_expires_at":{"type":["null","string"],"format":"date-time"},"scopes":{"type":"array","items":{"type":"string"}},"missing_core":{"type":"array","items":{"type":"string"}},"missing_focus":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/threads/connection/permission-checks":{"post":{"operationId":"threadsConnectionPermissionChecks","summary":"Threads: Run permission checks (Connection)","tags":["Focus · Threads"],"description":"One API call per granted permission for Meta App Review (publishes and deletes a throwaway post). Token validity, expiry and granted permissions vs. the full Threads permission set. Destructive. Requires scopes: threads_basic. Generic route: `/v1/accounts/{accountId}/focus/connection`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_threads","x-mcp-tool":"threads-connection-permission-checks","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/profile":{"get":{"operationId":"tiktokProfileGet","summary":"TikTok: Get Profile","tags":["Focus · TikTok"],"description":"Get the TikTok profile. Display name, @username, avatar, bio, verification and lifetime counters. Requires one of: user.info.basic | business:user.info.basic. Network docs: https://developers.tiktok.com/doc/tiktok-api-v2-get-user-info Generic route: `/v1/accounts/{accountId}/focus/profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"open_id (app-specific)"},"lane":{"type":"string","enum":["creator","business"]},"username":{"type":["null","string"],"description":"@handle"},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri","description":"Temporary CDN URL (≈2 h TTL)"},"bio":{"type":["null","string"]},"profile_url":{"type":["null","string"],"format":"uri"},"is_verified":{"type":["null","boolean"]},"is_business_account":{"type":["null","boolean"]},"has_advanced_access":{"type":["null","boolean"]},"followers":{"type":["null","integer"]},"following":{"type":["null","integer"]},"likes":{"type":["null","integer"]},"videos":{"type":["null","integer"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/videos":{"get":{"operationId":"tiktokVideosList","summary":"TikTok: List Videos & photos","tags":["Focus · TikTok"],"description":"List posts (newest first, ≤20 per page). Public posts with lifetime counts (Display API on creator connections; Accounts API incl. \"Only show in ads\" posts on Business). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: video.list | business:video.list. Network docs: https://developers.tiktok.com/doc/tiktok-api-v2-video-list Generic route: `/v1/accounts/{accountId}/focus/videos`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from the previous page"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-videos-list","x-zernio":["GET /v1/accounts/{accountId}/posts"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"lane":{"type":"string","enum":["creator","business"]},"media_type":{"type":["null","string"],"enum":["video","photo",null]},"is_ad":{"type":["null","boolean"]},"caption":{"type":["null","string"]},"title":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"duration_sec":{"type":["null","number"]},"cover_url":{"type":["null","string"],"format":"uri","description":"Expires (TT4D ≈6 h); refresh via get"},"share_url":{"type":["null","string"],"format":"uri"},"embed_url":{"type":["null","string"],"format":"uri"},"views":{"type":["null","integer"]},"likes":{"type":["null","integer"]},"comments":{"type":["null","integer"]},"shares":{"type":["null","integer"]},"saves":{"type":["null","integer"]},"reach":{"type":["null","integer"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/videos/{itemId}":{"get":{"operationId":"tiktokVideosGet","summary":"TikTok: Get a Videos & photos item","tags":["Focus · TikTok"],"description":"Get one post (refreshes expiring cover URLs). Public posts with lifetime counts (Display API on creator connections; Accounts API incl. \"Only show in ads\" posts on Business). Requires one of: video.list | business:video.list. Network docs: https://developers.tiktok.com/doc/tiktok-api-v2-video-list Generic route: `/v1/accounts/{accountId}/focus/videos`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-videos-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"lane":{"type":"string","enum":["creator","business"]},"media_type":{"type":["null","string"],"enum":["video","photo",null]},"is_ad":{"type":["null","boolean"]},"caption":{"type":["null","string"]},"title":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"duration_sec":{"type":["null","number"]},"cover_url":{"type":["null","string"],"format":"uri","description":"Expires (TT4D ≈6 h); refresh via get"},"share_url":{"type":["null","string"],"format":"uri"},"embed_url":{"type":["null","string"],"format":"uri"},"views":{"type":["null","integer"]},"likes":{"type":["null","integer"]},"comments":{"type":["null","integer"]},"shares":{"type":["null","integer"]},"saves":{"type":["null","integer"]},"reach":{"type":["null","integer"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/videos/{itemId}/embed":{"post":{"operationId":"tiktokVideosEmbed","summary":"TikTok: Embed code (Videos & photos)","tags":["Focus · TikTok"],"description":"oEmbed HTML + player URL for the post. Public posts with lifetime counts (Display API on creator connections; Accounts API incl. \"Only show in ads\" posts on Business). Requires one of: video.list | business:video.list. Network docs: https://developers.tiktok.com/doc/tiktok-api-v2-video-list Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-videos-embed","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/post-insights":{"get":{"operationId":"tiktokPostInsightsList","summary":"TikTok: List Post insights","tags":["Focus · TikTok"],"description":"Posts with insights. Reach, watch time, completion, traffic sources, audience and retention per post (Business, T+24–48 h, lifetime). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:video.list, business:video.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228421622786 Generic route: `/v1/accounts/{accountId}/focus/post-insights`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from the previous page"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-post-insights-list","x-zernio":["GET /v1/analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"caption":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"cover_url":{"type":["null","string"],"format":"uri"},"metrics":{"type":"object","properties":{"views":{"type":"number"},"reach":{"type":"number"},"likes":{"type":"number"},"comments":{"type":"number"},"shares":{"type":"number"},"saves":{"type":"number"},"profile_views":{"type":"number"},"website_clicks":{"type":"number"},"clicks":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"},"avg_view_percentage":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"}}},"completion_rate":{"type":["null","number"],"minimum":0,"maximum":1},"new_followers":{"type":["null","integer"]},"retention":{"type":"array","items":{"type":"object","properties":{"second":{"type":"number"},"percentage":{"type":"number"}}}},"traffic_sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"percentage":{"type":"number"}}}},"audience":{"type":"object","properties":{"types":{"type":"array","items":{"type":"object","properties":{}}},"genders":{"type":"array","items":{"type":"object","properties":{}}},"countries":{"type":"array","items":{"type":"object","properties":{}}},"cities":{"type":"array","items":{"type":"object","properties":{}}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/post-insights/{itemId}":{"get":{"operationId":"tiktokPostInsightsGet","summary":"TikTok: Get a Post insights item","tags":["Focus · TikTok"],"description":"Full insights for one post. Reach, watch time, completion, traffic sources, audience and retention per post (Business, T+24–48 h, lifetime). Requires scopes: business:video.list, business:video.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228421622786 Generic route: `/v1/accounts/{accountId}/focus/post-insights`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-post-insights-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"caption":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"cover_url":{"type":["null","string"],"format":"uri"},"metrics":{"type":"object","properties":{"views":{"type":"number"},"reach":{"type":"number"},"likes":{"type":"number"},"comments":{"type":"number"},"shares":{"type":"number"},"saves":{"type":"number"},"profile_views":{"type":"number"},"website_clicks":{"type":"number"},"clicks":{"type":"number"},"watch_time_seconds":{"type":"number"},"avg_view_duration_seconds":{"type":"number"},"avg_view_percentage":{"type":"number"},"engagements":{"type":"number"},"engagement_rate":{"type":"number"}}},"completion_rate":{"type":["null","number"],"minimum":0,"maximum":1},"new_followers":{"type":["null","integer"]},"retention":{"type":"array","items":{"type":"object","properties":{"second":{"type":"number"},"percentage":{"type":"number"}}}},"traffic_sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"percentage":{"type":"number"}}}},"audience":{"type":"object","properties":{"types":{"type":"array","items":{"type":"object","properties":{}}},"genders":{"type":"array","items":{"type":"object","properties":{}}},"countries":{"type":"array","items":{"type":"object","properties":{}}},"cities":{"type":"array","items":{"type":"object","properties":{}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/publish":{"post":{"operationId":"tiktokPublishCreate","summary":"TikTok: Create a Post to TikTok item","tags":["Focus · TikTok"],"description":"Direct post. Direct Post a video or photo carousel now (scheduling is Socialit-side). Requires an explicit privacy choice and user consent. Requires one of: video.publish | business:video.publish. Network docs: https://developers.tiktok.com/doc/content-posting-api-reference-direct-post Generic route: `/v1/accounts/{accountId}/focus/publish`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"Caption (video ≤2200; photo description ≤4000)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"1 video or 1–35 photos (Socialit media ids)"},"media_urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Alternative to media_ids: public https URLs on a verified domain"},"options":{"type":"object","additionalProperties":true,"properties":{"privacyLevel":{"type":"string","enum":["PUBLIC_TO_EVERYONE","MUTUAL_FOLLOW_FRIENDS","FOLLOWER_OF_CREATOR","SELF_ONLY"],"description":"Required for direct posts; must be one of creator_info privacy_level_options and selected by the user (no default). Alias: privacy_level, privacy."},"allowComment":{"type":"boolean","description":"User opted in to comments (default false). Ignored (forced off) when the creator disabled comments."},"allowDuet":{"type":"boolean","description":"Video only. User opted in to Duet (default false)."},"allowStitch":{"type":"boolean","description":"Video only. User opted in to Stitch (default false)."},"contentPreviewConfirmed":{"type":"boolean","description":"The user reviewed the preview. `false` blocks publishing."},"expressConsentGiven":{"type":"boolean","description":"The user explicitly consented to sending the content to TikTok. `false` blocks publishing."},"draft":{"type":"boolean","description":"Send to the creator’s TikTok inbox (Upload API / Business upload_to_draft) instead of posting. Needs video.upload."},"mediaType":{"type":"string","enum":["video","photo"],"description":"Override; inferred from media."},"title":{"type":"string","maxLength":90,"description":"Photo posts: title (≤90 UTF-16). Defaults to the caption without hashtags/URLs."},"description":{"type":"string","maxLength":4000,"description":"Photo posts: long caption (≤4000). Defaults to `content`."},"videoCoverTimestampMs":{"type":"integer","minimum":0,"description":"Cover frame in ms (default 1000, clamped inside the clip). Alias: coverTimestampMs."},"videoCoverImageUrl":{"type":"string","format":"uri","description":"Business lane, video: custom cover image (verified URL property)."},"photoCoverIndex":{"type":"integer","minimum":0,"description":"0-based cover photo (default 0)."},"autoAddMusic":{"type":"boolean","description":"Photo posts: let TikTok add recommended music."},"musicSoundInfo":{"type":"object","description":"Business lane only: Commercial Music Library track (ignored on drafts).","properties":{"musicSoundId":{"type":"string","description":"Prefer the trending/full-duration song_clip_id from listCommercialMusic()."},"musicSoundVolume":{"type":"integer","minimum":0,"maximum":100,"default":50},"musicSoundStart":{"type":"integer","minimum":0},"musicSoundEnd":{"type":"integer","minimum":0}},"required":["musicSoundId"]},"videoOriginalSoundVolume":{"type":"integer","minimum":0,"maximum":100,"description":"Business lane, video with musicSoundInfo."},"videoMadeWithAi":{"type":"boolean","description":"AI-generated content label (is_aigc / is_ai_generated). Business lane: video only."},"locationId":{"type":"string","description":"Business lane: location tag id from searchLocations(); requires locationName."},"locationName":{"type":"string"},"isAdsOnly":{"type":"boolean","description":"Business lane, video: \"Only show in ads\" post (Spark Ads source)."},"ttoInviteLink":{"type":"string","description":"Business lane, branded content: TikTok One campaign invite link."},"commercialContentType":{"type":"string","enum":["none","brand_organic","brand_content"],"description":"Disclosure shortcut: brand_organic = \"Your brand\" (Promotional content), brand_content = \"Branded content\" (Paid partnership)."},"isBrandOrganicPost":{"type":"boolean","description":"\"Your brand\" checkbox (brand_organic_toggle). Alias: brandedOrganic."},"brandPartnerPromote":{"type":"boolean","description":"\"Branded content\" checkbox (brand_content_toggle). Alias: brandedContent. Cannot be SELF_ONLY."},"commercialDisclosure":{"type":"boolean","description":"Disclosure toggle state; when true at least one of the two checkboxes is required."},"source":{"type":"string","enum":["PULL_FROM_URL","FILE_UPLOAD"],"description":"Creator lane video transfer (default PULL_FROM_URL; FILE_UPLOAD needs media[].buffer)."},"waitForCompletion":{"type":"boolean","description":"Poll status until complete (default true). When false, returns the publish_id immediately."}}}},"required":["options"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-publish-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"external_id":{"type":"string","description":"Post id when public, else publish_id"},"url":{"type":["null","string"],"format":"uri"},"publish_id":{"type":"string"},"status":{"type":"string"},"is_draft":{"type":"boolean"},"media_type":{"type":"string","enum":["video","photo"]},"post_ids":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/drafts":{"post":{"operationId":"tiktokDraftsCreate","summary":"TikTok: Create a Send to TikTok inbox item","tags":["Focus · TikTok"],"description":"Upload draft to the TikTok inbox. Upload a video or photos as a draft; the creator finishes and posts it from the TikTok inbox notification (max 5 pending per 24 h). Requires one of: video.upload | business:video.upload. Network docs: https://developers.tiktok.com/doc/content-posting-api-reference-upload-video Generic route: `/v1/accounts/{accountId}/focus/drafts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"Caption (video ≤2200; photo description ≤4000)"},"media_ids":{"type":"array","items":{"type":"string"},"description":"1 video or 1–35 photos (Socialit media ids)"},"media_urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Alternative to media_ids: public https URLs on a verified domain"},"options":{"type":"object","additionalProperties":true,"properties":{"privacyLevel":{"type":"string","enum":["PUBLIC_TO_EVERYONE","MUTUAL_FOLLOW_FRIENDS","FOLLOWER_OF_CREATOR","SELF_ONLY"],"description":"Required for direct posts; must be one of creator_info privacy_level_options and selected by the user (no default). Alias: privacy_level, privacy."},"allowComment":{"type":"boolean","description":"User opted in to comments (default false). Ignored (forced off) when the creator disabled comments."},"allowDuet":{"type":"boolean","description":"Video only. User opted in to Duet (default false)."},"allowStitch":{"type":"boolean","description":"Video only. User opted in to Stitch (default false)."},"contentPreviewConfirmed":{"type":"boolean","description":"The user reviewed the preview. `false` blocks publishing."},"expressConsentGiven":{"type":"boolean","description":"The user explicitly consented to sending the content to TikTok. `false` blocks publishing."},"draft":{"type":"boolean","description":"Send to the creator’s TikTok inbox (Upload API / Business upload_to_draft) instead of posting. Needs video.upload."},"mediaType":{"type":"string","enum":["video","photo"],"description":"Override; inferred from media."},"title":{"type":"string","maxLength":90,"description":"Photo posts: title (≤90 UTF-16). Defaults to the caption without hashtags/URLs."},"description":{"type":"string","maxLength":4000,"description":"Photo posts: long caption (≤4000). Defaults to `content`."},"videoCoverTimestampMs":{"type":"integer","minimum":0,"description":"Cover frame in ms (default 1000, clamped inside the clip). Alias: coverTimestampMs."},"videoCoverImageUrl":{"type":"string","format":"uri","description":"Business lane, video: custom cover image (verified URL property)."},"photoCoverIndex":{"type":"integer","minimum":0,"description":"0-based cover photo (default 0)."},"autoAddMusic":{"type":"boolean","description":"Photo posts: let TikTok add recommended music."},"musicSoundInfo":{"type":"object","description":"Business lane only: Commercial Music Library track (ignored on drafts).","properties":{"musicSoundId":{"type":"string","description":"Prefer the trending/full-duration song_clip_id from listCommercialMusic()."},"musicSoundVolume":{"type":"integer","minimum":0,"maximum":100,"default":50},"musicSoundStart":{"type":"integer","minimum":0},"musicSoundEnd":{"type":"integer","minimum":0}},"required":["musicSoundId"]},"videoOriginalSoundVolume":{"type":"integer","minimum":0,"maximum":100,"description":"Business lane, video with musicSoundInfo."},"videoMadeWithAi":{"type":"boolean","description":"AI-generated content label (is_aigc / is_ai_generated). Business lane: video only."},"locationId":{"type":"string","description":"Business lane: location tag id from searchLocations(); requires locationName."},"locationName":{"type":"string"},"isAdsOnly":{"type":"boolean","description":"Business lane, video: \"Only show in ads\" post (Spark Ads source)."},"ttoInviteLink":{"type":"string","description":"Business lane, branded content: TikTok One campaign invite link."},"commercialContentType":{"type":"string","enum":["none","brand_organic","brand_content"],"description":"Disclosure shortcut: brand_organic = \"Your brand\" (Promotional content), brand_content = \"Branded content\" (Paid partnership)."},"isBrandOrganicPost":{"type":"boolean","description":"\"Your brand\" checkbox (brand_organic_toggle). Alias: brandedOrganic."},"brandPartnerPromote":{"type":"boolean","description":"\"Branded content\" checkbox (brand_content_toggle). Alias: brandedContent. Cannot be SELF_ONLY."},"commercialDisclosure":{"type":"boolean","description":"Disclosure toggle state; when true at least one of the two checkboxes is required."},"source":{"type":"string","enum":["PULL_FROM_URL","FILE_UPLOAD"],"description":"Creator lane video transfer (default PULL_FROM_URL; FILE_UPLOAD needs media[].buffer)."},"waitForCompletion":{"type":"boolean","description":"Poll status until complete (default true). When false, returns the publish_id immediately."}}}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-drafts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"external_id":{"type":"string","description":"Post id when public, else publish_id"},"url":{"type":["null","string"],"format":"uri"},"publish_id":{"type":"string"},"status":{"type":"string"},"is_draft":{"type":"boolean"},"media_type":{"type":"string","enum":["video","photo"]},"post_ids":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/publish-status/{itemId}":{"get":{"operationId":"tiktokPublishStatusGet","summary":"TikTok: Get a Publish status item","tags":["Focus · TikTok"],"description":"Fetch status. Track a publish/draft task by publish_id (processing → inbox / complete / failed, post id after moderation). Requires one of: video.publish | video.upload | business:video.publish | business:video.upload. Network docs: https://developers.tiktok.com/doc/content-posting-api-reference-get-video-status Generic route: `/v1/accounts/{accountId}/focus/publish-status`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-publish-status-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"publish_id":{"type":"string"},"lane":{"type":"string","enum":["creator","business"]},"status":{"type":"string","enum":["PROCESSING_UPLOAD","PROCESSING_DOWNLOAD","SEND_TO_USER_INBOX","PUBLISH_COMPLETE","FAILED","UNKNOWN"]},"terminal":{"type":"boolean"},"is_draft":{"type":"boolean"},"fail_reason":{"type":["null","string"]},"fail_message":{"type":["null","string"]},"retryable":{"type":"boolean"},"post_ids":{"type":"array","items":{"type":"string"}},"post_id":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"},"uploaded_bytes":{"type":["null","integer"]},"downloaded_bytes":{"type":["null","integer"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/publish-status/{itemId}/cancel":{"post":{"operationId":"tiktokPublishStatusCancel","summary":"TikTok: Cancel upload (Publish status)","tags":["Focus · TikTok"],"description":"Cancel an in-flight PULL_FROM_URL upload (creator connections, best effort). Track a publish/draft task by publish_id (processing → inbox / complete / failed, post id after moderation). Destructive. Requires one of: video.publish | video.upload | business:video.publish | business:video.upload. Network docs: https://developers.tiktok.com/doc/content-posting-api-reference-get-video-status Generic route: `/v1/accounts/{accountId}/focus/publish-status`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-publish-status-cancel","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/capacity":{"get":{"operationId":"tiktokCapacityGet","summary":"TikTok: Get Posting capacity","tags":["Focus · TikTok"],"description":"Check capacity. Dry run: can this account direct-post right now (spam caps, active-creator cap)? Requires one of: video.publish | business:video.publish. Network docs: https://developers.tiktok.com/doc/content-sharing-guidelines Generic route: `/v1/accounts/{accountId}/focus/capacity`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-capacity-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"canPublish":{"type":"boolean"},"lane":{"type":"string","enum":["creator","business"]},"reason":{"type":["null","string"]},"message":{"type":["null","string"]},"privacyLevelOptions":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/hashtags":{"get":{"operationId":"tiktokHashtagsList","summary":"TikTok: List Hashtag suggestions","tags":["Focus · TikTok"],"description":"Suggest hashtags. 10 recommended hashtags for a keyword (exact match first, then by post count). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:video.publish. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228503821314 Generic route: `/v1/accounts/{accountId}/focus/hashtags`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"keyword","required":true},{"schema":{"type":"string","default":"en"},"in":"query","name":"language","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-hashtags-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"post_count":{"type":"integer"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comments":{"get":{"operationId":"tiktokCommentsList","summary":"TikTok: List Comments","tags":["Focus · TikTok"],"description":"Comments on a post. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:comment.list. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"video_id","required":true,"description":"Post id (item_id)"},{"schema":{"type":"string","enum":["PUBLIC","ALL"],"default":"ALL"},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["likes","replies","create_time"]},"in":"query","name":"sort_field","required":false},{"schema":{"type":"string","enum":["asc","desc","smart"]},"in":"query","name":"sort_order","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"include_replies","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":30},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comments-list","x-zernio":["GET /v1/inbox/comments","GET /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"string","description":"\"<videoId>:<commentId>\" — use as item id"},"id":{"type":"string"},"post_id":{"type":"string"},"parent_id":{"type":["null","string"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"author_name":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"],"format":"uri"},"author_id":{"type":["null","string"],"description":"unique_identifier (stable across APIs)"},"created_at":{"type":["null","string"],"format":"date-time"},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_owner":{"type":"boolean"},"liked":{"type":"boolean"},"pinned":{"type":"boolean"},"hidden":{"type":"boolean"},"status":{"type":["null","string"],"enum":["PUBLIC","HIDDEN",null]},"image_url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"tiktokCommentsCreate","summary":"TikTok: Create a Comments item","tags":["Focus · TikTok"],"description":"Comment on an owned post (text ≤1200 chars, or an image). All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"text":{"type":"string","maxLength":1200},"image_media_id":{"type":"string"}},"required":["video_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comments-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}","POST /v1/inbox/comments/{postId}/{commentId}/hide","POST /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"ref":{"type":"string","description":"\"<videoId>:<commentId>\" — use as item id"},"id":{"type":"string"},"post_id":{"type":"string"},"parent_id":{"type":["null","string"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"author_name":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"],"format":"uri"},"author_id":{"type":["null","string"],"description":"unique_identifier (stable across APIs)"},"created_at":{"type":["null","string"],"format":"date-time"},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_owner":{"type":"boolean"},"liked":{"type":"boolean"},"pinned":{"type":"boolean"},"hidden":{"type":"boolean"},"status":{"type":["null","string"],"enum":["PUBLIC","HIDDEN",null]},"image_url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comments/{itemId}":{"delete":{"operationId":"tiktokCommentsDelete","summary":"TikTok: Delete a Comments item","tags":["Focus · TikTok"],"description":"Delete one of your own comments. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comments-delete","x-zernio":["DELETE /v1/inbox/comments/{postId}","DELETE /v1/inbox/comments/{postId}/{commentId}/hide","DELETE /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comments/{itemId}/reply":{"post":{"operationId":"tiktokCommentsReply","summary":"TikTok: Reply (Comments)","tags":["Focus · TikTok"],"description":"Reply. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":1200},"image_media_id":{"type":"string"},"image_url":{"type":"string","format":"uri"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comments-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comments/{itemId}/like":{"post":{"operationId":"tiktokCommentsLike","summary":"TikTok: Like (Comments)","tags":["Focus · TikTok"],"description":"Like. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comments-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comments/{itemId}/unlike":{"post":{"operationId":"tiktokCommentsUnlike","summary":"TikTok: Unlike (Comments)","tags":["Focus · TikTok"],"description":"Unlike. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comments-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comments/{itemId}/hide":{"post":{"operationId":"tiktokCommentsHide","summary":"TikTok: Hide (Comments)","tags":["Focus · TikTok"],"description":"Hide. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comments-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comments/{itemId}/unhide":{"post":{"operationId":"tiktokCommentsUnhide","summary":"TikTok: Unhide (Comments)","tags":["Focus · TikTok"],"description":"Unhide. All comments (public and hidden) on an owned post, with up to 3 inline replies each. Hide others’ comments; delete only your own. Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comments-unhide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comment-replies":{"get":{"operationId":"tiktokCommentRepliesList","summary":"TikTok: List Comment replies","tags":["Focus · TikTok"],"description":"Replies to a comment. Every reply to one comment (public and hidden). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:comment.list. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: `/v1/accounts/{accountId}/focus/comment-replies`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"video_id","required":true},{"schema":{"type":"string"},"in":"query","name":"comment_id","required":true},{"schema":{"type":"string","enum":["PUBLIC","ALL"]},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["likes","replies","create_time"]},"in":"query","name":"sort_field","required":false},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"sort_order","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":30},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comment-replies-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"string","description":"\"<videoId>:<commentId>\" — use as item id"},"id":{"type":"string"},"post_id":{"type":"string"},"parent_id":{"type":["null","string"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"author_name":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"],"format":"uri"},"author_id":{"type":["null","string"],"description":"unique_identifier (stable across APIs)"},"created_at":{"type":["null","string"],"format":"date-time"},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_owner":{"type":"boolean"},"liked":{"type":"boolean"},"pinned":{"type":"boolean"},"hidden":{"type":"boolean"},"status":{"type":["null","string"],"enum":["PUBLIC","HIDDEN",null]},"image_url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"tiktokCommentRepliesCreate","summary":"TikTok: Create a Comment replies item","tags":["Focus · TikTok"],"description":"Reply to the comment. Every reply to one comment (public and hidden). Requires scopes: business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1776065099288577 Generic route: `/v1/accounts/{accountId}/focus/comment-replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"comment_id":{"type":"string"},"text":{"type":"string","maxLength":1200},"image_media_id":{"type":"string"}},"required":["video_id","comment_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comment-replies-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"ref":{"type":"string","description":"\"<videoId>:<commentId>\" — use as item id"},"id":{"type":"string"},"post_id":{"type":"string"},"parent_id":{"type":["null","string"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"author_username":{"type":["null","string"]},"author_name":{"type":["null","string"]},"author_avatar_url":{"type":["null","string"],"format":"uri"},"author_id":{"type":["null","string"],"description":"unique_identifier (stable across APIs)"},"created_at":{"type":["null","string"],"format":"date-time"},"like_count":{"type":"integer"},"reply_count":{"type":"integer"},"is_owner":{"type":"boolean"},"liked":{"type":"boolean"},"pinned":{"type":"boolean"},"hidden":{"type":"boolean"},"status":{"type":["null","string"],"enum":["PUBLIC","HIDDEN",null]},"image_url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/mentioned-posts":{"get":{"operationId":"tiktokMentionedPostsList","summary":"TikTok: List Post mentions","tags":["Focus · TikTok"],"description":"Mentioned posts. Top 1000 posts that @mention the business in their caption (last 1–90 days; Business Accounts; refresh daily after 07:00 UTC). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: `/v1/accounts/{accountId}/focus/mentioned-posts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":90,"default":90},"in":"query","name":"days","required":false},{"schema":{"type":"array","items":{"type":"string","description":"ISO 3166-1 alpha-2"}},"in":"query","name":"regions","required":false},{"schema":{"type":"string"},"in":"query","name":"sort_field","required":false},{"schema":{"type":"string","enum":["ASC","DESC"]},"in":"query","name":"sort_type","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-mentioned-posts-list","x-zernio":["GET /v1/inbox/mentions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["post","comment"]},"post_id":{"type":"string"},"comment_id":{"type":["null","string"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"comment_type":{"type":["null","string"],"enum":["COMMENT","REPLY",null]},"metrics":{"type":"object","properties":{"views":{"type":["null","integer"]},"reach":{"type":["null","integer"]},"comments":{"type":["null","integer"]},"shares":{"type":["null","integer"]},"post_likes":{"type":["null","integer"]}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/mentioned-posts/{itemId}":{"get":{"operationId":"tiktokMentionedPostsGet","summary":"TikTok: Get a Post mentions item","tags":["Focus · TikTok"],"description":"Mentioned post detail (from a mentions webhook). Top 1000 posts that @mention the business in their caption (last 1–90 days; Business Accounts; refresh daily after 07:00 UTC). Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: `/v1/accounts/{accountId}/focus/mentioned-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-mentioned-posts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["post","comment"]},"post_id":{"type":"string"},"comment_id":{"type":["null","string"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"comment_type":{"type":["null","string"],"enum":["COMMENT","REPLY",null]},"metrics":{"type":"object","properties":{"views":{"type":["null","integer"]},"reach":{"type":["null","integer"]},"comments":{"type":["null","integer"]},"shares":{"type":["null","integer"]},"post_likes":{"type":["null","integer"]}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comment-mentions":{"get":{"operationId":"tiktokCommentMentionsList","summary":"TikTok: List Comment mentions","tags":["Focus · TikTok"],"description":"Comment mentions. Top 1000 comments that @mention the business; reply from here. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:biz.brand.insights, business:comment.list. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: `/v1/accounts/{accountId}/focus/comment-mentions`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":90,"default":90},"in":"query","name":"days","required":false},{"schema":{"type":"array","items":{"type":"string","description":"ISO 3166-1 alpha-2"}},"in":"query","name":"regions","required":false},{"schema":{"type":"string"},"in":"query","name":"sort_field","required":false},{"schema":{"type":"string","enum":["ASC","DESC"]},"in":"query","name":"sort_type","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comment-mentions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["post","comment"]},"post_id":{"type":"string"},"comment_id":{"type":["null","string"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"comment_type":{"type":["null","string"],"enum":["COMMENT","REPLY",null]},"metrics":{"type":"object","properties":{"views":{"type":["null","integer"]},"reach":{"type":["null","integer"]},"comments":{"type":["null","integer"]},"shares":{"type":["null","integer"]},"post_likes":{"type":["null","integer"]}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comment-mentions/{itemId}":{"get":{"operationId":"tiktokCommentMentionsGet","summary":"TikTok: Get a Comment mentions item","tags":["Focus · TikTok"],"description":"Comment mention detail; id = \"<postId>:<commentId>\". Top 1000 comments that @mention the business; reply from here. Requires scopes: business:biz.brand.insights, business:comment.list. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: `/v1/accounts/{accountId}/focus/comment-mentions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comment-mentions-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["post","comment"]},"post_id":{"type":"string"},"comment_id":{"type":["null","string"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"comment_type":{"type":["null","string"],"enum":["COMMENT","REPLY",null]},"metrics":{"type":"object","properties":{"views":{"type":["null","integer"]},"reach":{"type":["null","integer"]},"comments":{"type":["null","integer"]},"shares":{"type":["null","integer"]},"post_likes":{"type":["null","integer"]}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comment-mentions/{itemId}/reply":{"post":{"operationId":"tiktokCommentMentionsReply","summary":"TikTok: Reply (Comment mentions)","tags":["Focus · TikTok"],"description":"Reply to the mentioning comment; id = \"<postId>:<commentId>\" or pass post_id. Top 1000 comments that @mention the business; reply from here. Requires scopes: business:biz.brand.insights, business:comment.list, business:comment.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: `/v1/accounts/{accountId}/focus/comment-mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":1200},"post_id":{"type":"string"}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comment-mentions-reply","x-idempotent":true,"x-zernio":["POST /v1/inbox/mentions/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/mention-trends":{"get":{"operationId":"tiktokMentionTrendsList","summary":"TikTok: List Mention keywords & hashtags","tags":["Focus · TikTok"],"description":"Top terms. Top 20 words or hashtags used in the top 1000 posts mentioning the business. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825103341635586 Generic route: `/v1/accounts/{accountId}/focus/mention-trends`.","parameters":[{"schema":{"type":"string","enum":["word","hashtag"],"default":"word"},"in":"query","name":"kind","required":false},{"schema":{"type":"array","items":{"type":"string","description":"ISO 3166-1 alpha-2"}},"in":"query","name":"regions","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-mention-trends-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"term":{"type":"string"},"count":{"type":"integer"},"kind":{"type":"string","enum":["word","hashtag"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/brand-hashtags":{"get":{"operationId":"tiktokBrandHashtagsList","summary":"TikTok: List Brand hashtags","tags":["Focus · TikTok"],"description":"Enabled brand hashtags. Hashtags tracked as brand mentions (≤50; removable after 7 days). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825108001123522 Generic route: `/v1/accounts/{accountId}/focus/brand-hashtags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-brand-hashtags-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"hashtag":{"type":"string"},"create_date":{"type":["null","string"],"format":"date"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"tiktokBrandHashtagsCreate","summary":"TikTok: Create a Brand hashtags item","tags":["Focus · TikTok"],"description":"Enable brand hashtags. Hashtags tracked as brand mentions (≤50; removable after 7 days). Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825108001123522 Generic route: `/v1/accounts/{accountId}/focus/brand-hashtags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hashtags":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":50}},"required":["hashtags"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-brand-hashtags-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"hashtag":{"type":"string"},"create_date":{"type":["null","string"],"format":"date"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/brand-hashtags/{itemId}":{"delete":{"operationId":"tiktokBrandHashtagsDelete","summary":"TikTok: Delete a Brand hashtags item","tags":["Focus · TikTok"],"description":"Remove a brand hashtag. Hashtags tracked as brand mentions (≤50; removable after 7 days). Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825108001123522 Generic route: `/v1/accounts/{accountId}/focus/brand-hashtags`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-brand-hashtags-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/brand-hashtags/suggestions":{"post":{"operationId":"tiktokBrandHashtagsSuggestions","summary":"TikTok: Valid hashtags (Brand hashtags)","tags":["Focus · TikTok"],"description":"Hashtags that can be enabled, with 90-day post/like counts. Hashtags tracked as brand mentions (≤50; removable after 7 days). Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825108001123522 Generic route: `/v1/accounts/{accountId}/focus/brand-hashtags`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-brand-hashtags-suggestions","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/brand-hashtag-posts":{"get":{"operationId":"tiktokBrandHashtagPostsList","summary":"TikTok: List Brand hashtag posts","tags":["Focus · TikTok"],"description":"Posts with brand hashtags. Top 1000 posts using the brand hashtags (last 90 days). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:biz.brand.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1825108001123522 Generic route: `/v1/accounts/{accountId}/focus/brand-hashtag-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"hashtag","required":false},{"schema":{"type":"integer","minimum":1,"maximum":90},"in":"query","name":"days","required":false},{"schema":{"type":"array","items":{"type":"string","description":"ISO 3166-1 alpha-2"}},"in":"query","name":"regions","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-brand-hashtag-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["post","comment"]},"post_id":{"type":"string"},"comment_id":{"type":["null","string"]},"text":{"type":["null","string"]},"author":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":["null","string"],"format":"uri"},"thumbnail_url":{"type":["null","string"],"format":"uri"},"like_count":{"type":"integer"},"comment_type":{"type":["null","string"],"enum":["COMMENT","REPLY",null]},"metrics":{"type":"object","properties":{"views":{"type":["null","integer"]},"reach":{"type":["null","integer"]},"comments":{"type":["null","integer"]},"shares":{"type":["null","integer"]},"post_likes":{"type":["null","integer"]}}},"matched_hashtags":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/conversations":{"get":{"operationId":"tiktokConversationsList","summary":"TikTok: List Conversations","tags":["Focus · TikTok"],"description":"Conversations. Direct-message conversations users started (accepted + message requests). TikTok direct messages are only available through the Business Messaging API for TikTok Accounts with Advanced Access or Verified Business Accounts that were NOT signed up in the EEA, Switzerland or the UK (US accounts also need TikTok’s US data security review). Businesses can only reply to conversations users started. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string","enum":["SINGLE","STRANGER"],"default":"SINGLE"},"in":"query","name":"type","required":false,"description":"STRANGER = message requests"},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-conversations-list","x-zernio":["GET /v1/inbox/conversations"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["single","stranger"]},"updated_at":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"last_message":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"is_follower":{"type":["null","boolean"]}}}},"referral":{"type":["null","object"],"properties":{}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/conversations/{itemId}":{"get":{"operationId":"tiktokConversationsGet","summary":"TikTok: Get a Conversations item","tags":["Focus · TikTok"],"description":"Conversation with its 20 most recent messages. Direct-message conversations users started (accepted + message requests). TikTok direct messages are only available through the Business Messaging API for TikTok Accounts with Advanced Access or Verified Business Accounts that were NOT signed up in the EEA, Switzerland or the UK (US accounts also need TikTok’s US data security review). Businesses can only reply to conversations users started. Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-conversations-get","x-zernio":["GET /v1/inbox/conversations/{conversationId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["single","stranger"]},"updated_at":{"type":["null","string"],"format":"date-time"},"unread_count":{"type":"integer"},"last_message":{"type":["null","string"]},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["null","string"]},"avatar_url":{"type":["null","string"],"format":"uri"},"is_follower":{"type":["null","boolean"]}}}},"referral":{"type":["null","object"],"properties":{}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/conversations/{itemId}/typing":{"post":{"operationId":"tiktokConversationsTyping","summary":"TikTok: Typing indicator (Conversations)","tags":["Focus · TikTok"],"description":"Typing indicator. Direct-message conversations users started (accepted + message requests). TikTok direct messages are only available through the Business Messaging API for TikTok Accounts with Advanced Access or Verified Business Accounts that were NOT signed up in the EEA, Switzerland or the UK (US accounts also need TikTok’s US data security review). Businesses can only reply to conversations users started. Requires scopes: business:message.list.read, business:message.list.send. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-conversations-typing","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/typing","POST /v1/inbox/conversations/{conversationId}/read"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/conversations/{itemId}/mark-read":{"post":{"operationId":"tiktokConversationsMarkRead","summary":"TikTok: Mark as read (Conversations)","tags":["Focus · TikTok"],"description":"Mark as read. Direct-message conversations users started (accepted + message requests). TikTok direct messages are only available through the Business Messaging API for TikTok Accounts with Advanced Access or Verified Business Accounts that were NOT signed up in the EEA, Switzerland or the UK (US accounts also need TikTok’s US data security review). Businesses can only reply to conversations users started. Requires scopes: business:message.list.read, business:message.list.send. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-conversations-mark-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/messages":{"get":{"operationId":"tiktokMessagesList","summary":"TikTok: List Messages","tags":["Focus · TikTok"],"description":"Messages (20 most recent). Messages in a conversation; reply with text (≤6000), one image, a shared post or a Q&A card (10 messages per 48 h after each user message). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: `/v1/accounts/{accountId}/focus/messages`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"conversation_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-messages-list","x-zernio":["GET /v1/inbox/conversations/{conversationId}/messages"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":["null","string"]},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":["null","string"],"format":"date-time"},"from_id":{"type":["null","string"]},"from_username":{"type":["null","string"]},"type":{"type":["null","string"],"enum":["text","image","share_post","video","emoji","sticker","template","other",null]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"media_id":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"},"embed_url":{"type":["null","string"],"format":"uri"}}}},"auto_message_type":{"type":["null","string"]},"reply_to_id":{"type":["null","string"]},"source":{"type":["null","string"],"enum":["APP","WEB","API","OTHERS","UNKNOWN_SOURCE",null]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"tiktokMessagesCreate","summary":"TikTok: Create a Messages item","tags":["Focus · TikTok"],"description":"Send a message. Messages in a conversation; reply with text (≤6000), one image, a shared post or a Q&A card (10 messages per 48 h after each user message). Requires scopes: business:message.list.read, business:message.list.send. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"conversation_id":{"type":"string"},"text":{"type":"string","maxLength":6000},"image_media_id":{"type":"string","description":"JPG/PNG ≤3 MB; not with text"},"media_id":{"type":"string","description":"TikTok media_id from a previous upload"},"share_post_id":{"type":"string","description":"Share one of your own posts"},"reply_to_message_id":{"type":"string"},"template":{"type":"object","properties":{"type":{"type":"string","enum":["QA_BUTTON_CARD","QA_LINK_CARD"]},"title":{"type":"string","maxLength":40},"buttons":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":40}}},"minItems":1,"maxItems":3}}}},"required":["conversation_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-messages-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations/{conversationId}/messages"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":["null","string"]},"direction":{"type":"string","enum":["in","out"]},"sent_at":{"type":["null","string"],"format":"date-time"},"from_id":{"type":["null","string"]},"from_username":{"type":["null","string"]},"type":{"type":["null","string"],"enum":["text","image","share_post","video","emoji","sticker","template","other",null]},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"media_id":{"type":["null","string"]},"url":{"type":["null","string"],"format":"uri"},"embed_url":{"type":["null","string"],"format":"uri"}}}},"auto_message_type":{"type":["null","string"]},"reply_to_id":{"type":["null","string"]},"source":{"type":["null","string"],"enum":["APP","WEB","API","OTHERS","UNKNOWN_SOURCE",null]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/messages/{itemId}/download-media":{"post":{"operationId":"tiktokMessagesDownloadMedia","summary":"TikTok: Download attachment (Messages)","tags":["Focus · TikTok"],"description":"Signed download URL (24 h) for an image/video in a message. Messages in a conversation; reply with text (≤6000), one image, a shared post or a Q&A card (10 messages per 48 h after each user message). Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"conversation_id":{"type":"string"},"media_id":{"type":"string"},"media_type":{"type":"string","enum":["IMAGE","VIDEO"]}},"required":["conversation_id","media_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-messages-download-media","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/messages/direct-reply":{"post":{"operationId":"tiktokMessagesDirectReply","summary":"TikTok: Comment-to-Message reply (Messages)","tags":["Focus · TikTok"],"description":"DM reply to a high-intent comment (Comment-to-Message enabled; VN/ID/TH accounts). Messages in a conversation; reply with text (≤6000), one image, a shared post or a Q&A card (10 messages per 48 h after each user message). Requires scopes: business:message.list.read, business:message.list.send. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: `/v1/accounts/{accountId}/focus/messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment_id":{"type":"string"},"text":{"type":"string","maxLength":6000}},"required":["comment_id","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-messages-direct-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/auto-messages":{"get":{"operationId":"tiktokAutoMessagesList","summary":"TikTok: List Automatic messages","tags":["Focus · TikTok"],"description":"Auto messages of a type (all types when omitted). Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: `/v1/accounts/{accountId}/focus/auto-messages`.","parameters":[{"schema":{"type":"string","enum":["WELCOME_MESSAGE","SUGGESTED_QUESTION","CHAT_PROMPT","FOLLOW_WELCOME"]},"in":"query","name":"type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-auto-messages-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"string","description":"\"<TYPE>:<id>\""},"id":{"type":"string"},"type":{"type":"string","enum":["WELCOME_MESSAGE","SUGGESTED_QUESTION","CHAT_PROMPT","FOLLOW_WELCOME"]},"audit_status":{"type":["null","string"],"enum":["REVIEWING","APPROVED","REJECTED",null]},"operation_status":{"type":["null","string"],"enum":["ENABLE","DISABLE",null]},"content":{"type":["null","string"]},"question":{"type":["null","string"]},"answer":{"type":["null","string"]},"title":{"type":["null","string"]},"interaction":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"tiktokAutoMessagesCreate","summary":"TikTok: Create a Automatic messages item","tags":["Focus · TikTok"],"description":"Create an auto message. Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: `/v1/accounts/{accountId}/focus/auto-messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["WELCOME_MESSAGE","SUGGESTED_QUESTION","CHAT_PROMPT","FOLLOW_WELCOME"]},"content":{"type":"string","description":"Welcome message (≤250) / chat prompt question (≤150)"},"question":{"type":"string","maxLength":80},"answer":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":18,"description":"Chat prompt button"},"message":{"type":"string","description":"New-follower message; {s_nickname} placeholder"},"interaction":{"type":"string","enum":["NONE","QUICK_REPLY","QUICK_ACTION"]},"quick_reply_text":{"type":"string","maxLength":20},"quick_action_type":{"type":"string","enum":["SHOP","JOIN_GROUP"]}},"required":["type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-auto-messages-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"ref":{"type":"string","description":"\"<TYPE>:<id>\""},"id":{"type":"string"},"type":{"type":"string","enum":["WELCOME_MESSAGE","SUGGESTED_QUESTION","CHAT_PROMPT","FOLLOW_WELCOME"]},"audit_status":{"type":["null","string"],"enum":["REVIEWING","APPROVED","REJECTED",null]},"operation_status":{"type":["null","string"],"enum":["ENABLE","DISABLE",null]},"content":{"type":["null","string"]},"question":{"type":["null","string"]},"answer":{"type":["null","string"]},"title":{"type":["null","string"]},"interaction":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/auto-messages/{itemId}":{"patch":{"operationId":"tiktokAutoMessagesUpdate","summary":"TikTok: Update a Automatic messages item","tags":["Focus · TikTok"],"description":"Update an auto message. Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: `/v1/accounts/{accountId}/focus/auto-messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["WELCOME_MESSAGE","SUGGESTED_QUESTION","CHAT_PROMPT","FOLLOW_WELCOME"]},"content":{"type":"string","description":"Welcome message (≤250) / chat prompt question (≤150)"},"question":{"type":"string","maxLength":80},"answer":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":18,"description":"Chat prompt button"},"message":{"type":"string","description":"New-follower message; {s_nickname} placeholder"},"interaction":{"type":"string","enum":["NONE","QUICK_REPLY","QUICK_ACTION"]},"quick_reply_text":{"type":"string","maxLength":20},"quick_action_type":{"type":"string","enum":["SHOP","JOIN_GROUP"]}},"required":["type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-auto-messages-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ref":{"type":"string","description":"\"<TYPE>:<id>\""},"id":{"type":"string"},"type":{"type":"string","enum":["WELCOME_MESSAGE","SUGGESTED_QUESTION","CHAT_PROMPT","FOLLOW_WELCOME"]},"audit_status":{"type":["null","string"],"enum":["REVIEWING","APPROVED","REJECTED",null]},"operation_status":{"type":["null","string"],"enum":["ENABLE","DISABLE",null]},"content":{"type":["null","string"]},"question":{"type":["null","string"]},"answer":{"type":["null","string"]},"title":{"type":["null","string"]},"interaction":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"tiktokAutoMessagesDelete","summary":"TikTok: Delete a Automatic messages item","tags":["Focus · TikTok"],"description":"Delete an auto message (id \"<TYPE>:<id>\"). Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: `/v1/accounts/{accountId}/focus/auto-messages`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-auto-messages-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/auto-messages/enable":{"post":{"operationId":"tiktokAutoMessagesEnable","summary":"TikTok: Turn on type (Automatic messages)","tags":["Focus · TikTok"],"description":"Turn on type. Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: `/v1/accounts/{accountId}/focus/auto-messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["WELCOME_MESSAGE","SUGGESTED_QUESTION","CHAT_PROMPT","FOLLOW_WELCOME"]}},"required":["type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-auto-messages-enable","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/auto-messages/disable":{"post":{"operationId":"tiktokAutoMessagesDisable","summary":"TikTok: Turn off type (Automatic messages)","tags":["Focus · TikTok"],"description":"Turn off type. Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: `/v1/accounts/{accountId}/focus/auto-messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["WELCOME_MESSAGE","SUGGESTED_QUESTION","CHAT_PROMPT","FOLLOW_WELCOME"]}},"required":["type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-auto-messages-disable","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/auto-messages/sort":{"post":{"operationId":"tiktokAutoMessagesSort","summary":"TikTok: Reorder chat prompts (Automatic messages)","tags":["Focus · TikTok"],"description":"Reorder chat prompts. Welcome message (1), suggested questions (≤3), chat prompts (≤6) and new-follower message. Requires scopes: business:message.list.manage. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184584869890 Generic route: `/v1/accounts/{accountId}/focus/auto-messages`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}}},"required":["ids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-auto-messages-sort","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/comment-to-message":{"get":{"operationId":"tiktokCommentToMessageGet","summary":"TikTok: Get Comment-to-Message","tags":["Focus · TikTok"],"description":"Setting. Let TikTok flag high-intent comments for a DM reply (accounts registered in VN, ID, TH). Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1843697551083522 Generic route: `/v1/accounts/{accountId}/focus/comment-to-message`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comment-to-message-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["COMMENT_TO_MESSAGE"]},"enabled":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"tiktokCommentToMessageUpdate","summary":"TikTok: Update Comment-to-Message","tags":["Focus · TikTok"],"description":"Enable/disable. Let TikTok flag high-intent comments for a DM reply (accounts registered in VN, ID, TH). Requires scopes: business:message.list.read, business:message.list.send. Network docs: https://business-api.tiktok.com/portal/docs?id=1843697551083522 Generic route: `/v1/accounts/{accountId}/focus/comment-to-message`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-comment-to-message-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["COMMENT_TO_MESSAGE"]},"enabled":{"type":"boolean"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/messaging-capabilities":{"get":{"operationId":"tiktokMessagingCapabilitiesGet","summary":"TikTok: Get Messaging capabilities","tags":["Focus · TikTok"],"description":"Capabilities. Can the account send images in a conversation / send new-follower messages? Requires scopes: business:message.list.read. Network docs: https://business-api.tiktok.com/portal/docs?id=1832184236919810 Generic route: `/v1/accounts/{accountId}/focus/messaging-capabilities`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"conversation_id","required":false},{"schema":{"type":"string","enum":["SINGLE","STRANGER"]},"in":"query","name":"conversation_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-messaging-capabilities-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"IMAGE_SEND":{"type":["null","boolean"]},"FOLLOW_WELCOME":{"type":["null","boolean"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/account-insights":{"get":{"operationId":"tiktokAccountInsightsList","summary":"TikTok: List Account insights","tags":["Focus · TikTok"],"description":"Daily series. Daily video views, reached audience, profile views, likes, comments, shares, followers and profile clicks (T+24–48 h, 60-day lookback; some metrics need Advanced Access / Verified Business). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:user.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228399168514 Generic route: `/v1/accounts/{accountId}/focus/account-insights`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (UTC); ≤60 days back"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (UTC); default yesterday"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-account-insights-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"views":{"type":"number"},"reach":{"type":"number"},"profile_views":{"type":"number"},"likes":{"type":"number"},"comments":{"type":"number"},"shares":{"type":"number"},"followers":{"type":"number"},"follower_change":{"type":"number"},"website_clicks":{"type":"number"},"clicks":{"type":"number"},"engagements":{"type":"number"},"engaged_audience":{"type":["null","number"]},"daily_new_followers":{"type":["null","number"]},"daily_lost_followers":{"type":["null","number"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/audience":{"get":{"operationId":"tiktokAudienceGet","summary":"TikTok: Get Audience demographics","tags":["Focus · TikTok"],"description":"Demographics. Follower age, gender, top countries and cities (≥100 followers). Requires scopes: business:user.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228399168514 Generic route: `/v1/accounts/{accountId}/focus/audience`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-audience-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ages":{"type":"array","items":{"type":"object","properties":{"age":{"type":"string"},"value":{"type":"number"}}}},"genders":{"type":"array","items":{"type":"object","properties":{"gender":{"type":"string"},"value":{"type":"number"}}}},"countries":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"number"}}}},"cities":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"number"}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/audience-activity":{"get":{"operationId":"tiktokAudienceActivityList","summary":"TikTok: List Follower activity","tags":["Focus · TikTok"],"description":"Hourly activity. When followers are online: average active followers per UTC hour (best time to post). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:user.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228399168514 Generic route: `/v1/accounts/{accountId}/focus/audience-activity`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (UTC); ≤60 days back"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (UTC); default yesterday"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-audience-activity-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"hour":{"type":"integer","minimum":0,"maximum":23},"avg_active_followers":{"type":"number"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/account-counters":{"get":{"operationId":"tiktokAccountCountersGet","summary":"TikTok: Get Followers & totals","tags":["Focus · TikTok"],"description":"Account counters. Followers, following, total likes, video count (live) and followers gained/lost (Business daily data). Requires one of: user.info.stats | business:user.info.stats. Network docs: https://business-api.tiktok.com/portal/docs?id=1762228399168514 Generic route: `/v1/accounts/{accountId}/focus/account-counters`.","parameters":[{"schema":{"type":"array","items":{"type":"string","enum":["follower_count","following_count","likes_count","video_count","followers_gained","followers_lost"]}},"in":"query","name":"metrics","required":false},{"schema":{"type":"string","enum":["total_value","time_series"]},"in":"query","name":"metricType","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-account-counters-get","x-zernio":["GET /v1/analytics/tiktok/account-insights"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"metrics":{"type":"object","properties":{"follower_count":{"type":"object","properties":{"value":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number"}}}}}},"following_count":{"type":"object","properties":{"value":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number"}}}}}},"likes_count":{"type":"object","properties":{"value":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number"}}}}}},"video_count":{"type":"object","properties":{"value":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number"}}}}}},"followers_gained":{"type":"object","properties":{"value":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number"}}}}}},"followers_lost":{"type":"object","properties":{"value":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number"}}}}}}}},"unavailableMetrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"reason":{"type":"string"}}}},"metricType":{"type":"string","enum":["total_value","time_series"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/benchmarks":{"get":{"operationId":"tiktokBenchmarksList","summary":"TikTok: List Category benchmarks","tags":["Focus · TikTok"],"description":"Benchmark for a category. Average likes, comments, shares, followers, growth, engagement rate and views of Business Accounts in a category. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:user.insights. Network docs: https://business-api.tiktok.com/portal/docs?id=1822388944791617 Generic route: `/v1/accounts/{accountId}/focus/benchmarks`.","parameters":[{"schema":{"type":"string","enum":["ART_AND_CRAFTS","AUTOMOTIVE_AND_TRANSPORTATION","BABY","BEAUTY","CLOTHING_AND_ACCESSORIES","EDUCATION_AND_TRAINING","ELECTRONICS","FINANCE_AND_INVESTING","FOOD_AND_BEVERAGE","GAMING","HEALTH_AND_WELLNESS","HOME_FURNITURE_AND_APPLIANCES","MACHINERY_AND_EQUIPMENT","MEDIA_AND_ENTERTAINMENT","PERSONAL_BLOG","PETS","PROFESSIONAL_SERVICES","PUBLIC_ADMINISTRATION","REAL_ESTATE","RESTAURANTS_AND_BARS","SHOPPING_AND_RETAIL","SOFTWARE_AND_APPS","SPORTS_FITNESS_AND_OUTDOORS","TRAVEL_AND_TOURISM","OTHERS"]},"in":"query","name":"business_category","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-benchmarks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"business_category":{"type":"string","enum":["ART_AND_CRAFTS","AUTOMOTIVE_AND_TRANSPORTATION","BABY","BEAUTY","CLOTHING_AND_ACCESSORIES","EDUCATION_AND_TRAINING","ELECTRONICS","FINANCE_AND_INVESTING","FOOD_AND_BEVERAGE","GAMING","HEALTH_AND_WELLNESS","HOME_FURNITURE_AND_APPLIANCES","MACHINERY_AND_EQUIPMENT","MEDIA_AND_ENTERTAINMENT","PERSONAL_BLOG","PETS","PROFESSIONAL_SERVICES","PUBLIC_ADMINISTRATION","REAL_ESTATE","RESTAURANTS_AND_BARS","SHOPPING_AND_RETAIL","SOFTWARE_AND_APPS","SPORTS_FITNESS_AND_OUTDOORS","TRAVEL_AND_TOURISM","OTHERS"]},"category_label":{"type":["null","string"]},"average_likes":{"type":"number"},"average_comments":{"type":"number"},"average_shares":{"type":"number"},"average_video_count":{"type":"number"},"average_follower_count":{"type":"number"},"average_follower_growth":{"type":"number"},"average_engagement_rate":{"type":"number"},"average_video_views":{"type":"number"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}":{"get":{"operationId":"tiktokSparkAuthCodesGet","summary":"TikTok: Get a Spark Ads codes item","tags":["Focus · TikTok"],"description":"Authorization status. Enable ad authorization for a post and get its Spark Ads code; extend, inspect or delete it. Requires scopes: business:biz.spark.auth. Network docs: https://business-api.tiktok.com/portal/docs?id=1815051741912066 Generic route: `/v1/accounts/{accountId}/focus/spark-auth-codes`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-spark-auth-codes-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"auth_code":{"type":["null","string"]},"auth_code_start_time":{"type":["null","string"]},"auth_code_end_time":{"type":["null","string"]},"authorization_days":{"type":["null","integer"]},"status":{"type":["null","string"],"enum":["NOT_USED","IN_USE","EXPIRED","DELETED",null]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"tiktokSparkAuthCodesUpdate","summary":"TikTok: Update a Spark Ads codes item","tags":["Focus · TikTok"],"description":"Extend the authorization period. Enable ad authorization for a post and get its Spark Ads code; extend, inspect or delete it. Requires scopes: business:biz.spark.auth. Network docs: https://business-api.tiktok.com/portal/docs?id=1815051741912066 Generic route: `/v1/accounts/{accountId}/focus/spark-auth-codes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"authorization_days":{"type":"integer","enum":[7,30,60,180,365]}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-spark-auth-codes-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"auth_code":{"type":["null","string"]},"auth_code_start_time":{"type":["null","string"]},"auth_code_end_time":{"type":["null","string"]},"authorization_days":{"type":["null","integer"]},"status":{"type":["null","string"],"enum":["NOT_USED","IN_USE","EXPIRED","DELETED",null]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"tiktokSparkAuthCodesDelete","summary":"TikTok: Delete a Spark Ads codes item","tags":["Focus · TikTok"],"description":"Delete the code. Enable ad authorization for a post and get its Spark Ads code; extend, inspect or delete it. Requires scopes: business:biz.spark.auth. Network docs: https://business-api.tiktok.com/portal/docs?id=1815051741912066 Generic route: `/v1/accounts/{accountId}/focus/spark-auth-codes`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-spark-auth-codes-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/spark-auth-codes":{"post":{"operationId":"tiktokSparkAuthCodesCreate","summary":"TikTok: Create a Spark Ads codes item","tags":["Focus · TikTok"],"description":"Enable ad authorization (returns the code). Enable ad authorization for a post and get its Spark Ads code; extend, inspect or delete it. Requires scopes: business:biz.spark.auth. Network docs: https://business-api.tiktok.com/portal/docs?id=1815051741912066 Generic route: `/v1/accounts/{accountId}/focus/spark-auth-codes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"authorization_days":{"type":"integer","enum":[7,30,60,180,365],"default":30}},"required":["item_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-spark-auth-codes-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"item_id":{"type":"string"},"auth_code":{"type":["null","string"]},"auth_code_start_time":{"type":["null","string"]},"auth_code_end_time":{"type":["null","string"]},"authorization_days":{"type":["null","integer"]},"status":{"type":["null","string"],"enum":["NOT_USED","IN_USE","EXPIRED","DELETED",null]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/spark-auth-codes/{itemId}/disable":{"post":{"operationId":"tiktokSparkAuthCodesDisable","summary":"TikTok: Disable ad authorization (Spark Ads codes)","tags":["Focus · TikTok"],"description":"Disable ad authorization. Enable ad authorization for a post and get its Spark Ads code; extend, inspect or delete it. Destructive. Requires scopes: business:biz.spark.auth. Network docs: https://business-api.tiktok.com/portal/docs?id=1815051741912066 Generic route: `/v1/accounts/{accountId}/focus/spark-auth-codes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-spark-auth-codes-disable","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/spark-recommendations":{"get":{"operationId":"tiktokSparkRecommendationsList","summary":"TikTok: List Promotion recommendations","tags":["Focus · TikTok"],"description":"Recommendations. Which of your videos are best suited for Spark Ads (HIGH / MEDIUM / LOW), for an objective. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: business:biz.ads.recommend. Network docs: https://business-api.tiktok.com/portal/docs?id=1825128684907522 Generic route: `/v1/accounts/{accountId}/focus/spark-recommendations`.","parameters":[{"schema":{"type":"string","enum":["PAST_ONE_MONTH","PAST_THREE_MONTHS","PAST_SIX_MONTHS"]},"in":"query","name":"time","required":false},{"schema":{"type":"string","enum":["REACH","TRAFFIC","VIDEO_VIEWS","ENGAGEMENT","APP_PROMOTION","LEAD_GENERATION","WEB_CONVERSIONS","PRODUCT_SALES"]},"in":"query","name":"objective_type","required":false},{"schema":{"type":"array","items":{"type":"string"}},"in":"query","name":"video_ids","required":false},{"schema":{"type":"array","items":{"type":"string"}},"in":"query","name":"exclude_video_ids","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-spark-recommendations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"string"},"recommendation_level":{"type":"string","enum":["HIGH","MEDIUM","LOW"]},"thumbnail_url":{"type":["null","string"],"format":"uri"},"embed_url":{"type":["null","string"],"format":"uri"},"created_at":{"type":["null","string"],"format":"date-time"},"views":{"type":["null","number"]},"likes":{"type":["null","number"]},"comments":{"type":["null","number"]},"shares":{"type":["null","number"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/embed":{"get":{"operationId":"tiktokEmbedList","summary":"TikTok: List Embed / oEmbed","tags":["Focus · TikTok"],"description":"Look up a post URL. oEmbed metadata, embed HTML and player URL for any public TikTok post. Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://developers.tiktok.com/doc/embed-videos Generic route: `/v1/accounts/{accountId}/focus/embed`.","parameters":[{"schema":{"type":"string","format":"uri"},"in":"query","name":"url","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-embed-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"video_id":{"type":["null","string"]},"title":{"type":["null","string"]},"author_name":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"],"format":"uri"},"html":{"type":["null","string"]},"player_url":{"type":["null","string"],"format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/download":{"get":{"operationId":"tiktokDownloadList","summary":"TikTok: List Video lookup","tags":["Focus · TikTok"],"description":"Look up a video. Zernio \"TikTok download\" parity. TikTok’s official APIs do not allow downloading videos, so this returns metadata (title, author, cover, embed, duration for own videos) with downloadUrl = null. Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://developers.tiktok.com/doc/embed-videos Generic route: `/v1/accounts/{accountId}/focus/download`.","parameters":[{"schema":{"type":"string","format":"uri"},"in":"query","name":"url","required":true},{"schema":{"type":"string","enum":["download","formats"]},"in":"query","name":"action","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-download-list","x-zernio":["GET /v1/tools/tiktok/download"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"success":{"type":"boolean"},"title":{"type":["null","string"]},"author":{"type":["null","string"]},"duration":{"type":["null","number"]},"cover":{"type":["null","string"],"format":"uri"},"playerUrl":{"type":["null","string"],"format":"uri"},"shareUrl":{"type":["null","string"],"format":"uri"},"downloadUrl":{"type":["null","string"],"format":"uri"},"unavailableReason":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/tiktok/token-info":{"get":{"operationId":"tiktokTokenInfoGet","summary":"TikTok: Get Granted permissions","tags":["Focus · TikTok"],"description":"Inspect token. Scopes TikTok actually granted to this Business connection (token inspector). Requires scopes: business:user.info.basic. Network docs: https://business-api.tiktok.com/portal/docs?id=1765927978092545 Generic route: `/v1/accounts/{accountId}/focus/token-info`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_tiktok","x-mcp-tool":"tiktok-token-info-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"app_id":{"type":["null","string"]},"creator_id":{"type":["null","string"]},"scopes":{"type":"array","items":{"type":"string"}},"scopes_prefixed":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/posts":{"get":{"operationId":"xPostsList","summary":"X: List Posts","tags":["Focus · X"],"description":"Your timeline (GET /2/users/:id/tweets). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["replies","retweets","replies,retweets"]},"in":"query","name":"exclude","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start_time","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end_time","required":false},{"schema":{"type":"string"},"in":"query","name":"since_id","required":false},{"schema":{"type":"string"},"in":"query","name":"until_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-posts-list","x-zernio":["GET /v1/accounts/{accountId}/posts","GET /v1/twitter/tweet"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xPostsCreate","summary":"X: Create a Posts item","tags":["Focus · X"],"description":"Publish a post (POST /2/tweets). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","title":"Text"},"media":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"object","properties":{"media":{"type":"string"},"alt_text":{"type":"string","maxLength":1000}}}]},"maxItems":4,"description":"Up to 4 images, or 1 GIF, or 1 video"},"reply_settings":{"type":"string","enum":["following","mentionedUsers","subscribers","verified"]},"reply_to_post_id":{"type":"string","description":"Reply to this post (id or URL)"},"quote_post_id":{"type":"string","description":"Quote this post (Enterprise-only)"},"community_id":{"type":"string"},"for_super_followers_only":{"type":"boolean"},"paid_partnership":{"type":"boolean"},"made_with_ai":{"type":"boolean"},"sensitive_media":{"type":"object","properties":{"adult_content":{"type":"boolean"},"graphic_violence":{"type":"boolean"},"other":{"type":"boolean"}}},"geo_countries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"maxItems":25},"place_id":{"type":"string"},"tagged_user_ids":{"type":"array","items":{"type":"string"},"maxItems":10},"long_video":{"type":"boolean"},"first_comment":{"type":"string"},"auto_thread":{"type":"boolean","description":"Split long text into a thread"}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-posts-create","x-idempotent":true,"x-zernio":["POST /v1/posts","POST /v1/posts/{postId}/edit","POST /v1/posts/{postId}/unpublish","POST /v1/twitter/retweet","POST /v1/twitter/bookmark","POST /v1/inbox/posts/{postId}/like"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/posts/{itemId}":{"get":{"operationId":"xPostsGet","summary":"X: Get a Posts item","tags":["Focus · X"],"description":"Post lookup (GET /2/tweets/:id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-posts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"xPostsUpdate","summary":"X: Update a Posts item","tags":["Focus · X"],"description":"Edit a post (X Premium; returns a new post id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"media":{"type":"array","items":{"type":"string"},"maxItems":4}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_x","x-mcp-tool":"x-posts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"xPostsDelete","summary":"X: Delete a Posts item","tags":["Focus · X"],"description":"Delete a post (DELETE /2/tweets/:id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-posts-delete","x-zernio":["DELETE /v1/twitter/retweet","DELETE /v1/twitter/bookmark","DELETE /v1/inbox/posts/{postId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/posts/{itemId}/reply":{"post":{"operationId":"xPostsReply","summary":"X: Reply (Posts)","tags":["Focus · X"],"description":"Reply. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":25000},"media":{"type":"array","items":{"type":"string"},"maxItems":4}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-posts-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/posts/{itemId}/repost":{"post":{"operationId":"xPostsRepost","summary":"X: Repost (Posts)","tags":["Focus · X"],"description":"Repost. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-posts-repost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/posts/{itemId}/undo-repost":{"post":{"operationId":"xPostsUndoRepost","summary":"X: Undo repost (Posts)","tags":["Focus · X"],"description":"Undo repost. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-posts-undo-repost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/posts/{itemId}/like":{"post":{"operationId":"xPostsLike","summary":"X: Like (Posts)","tags":["Focus · X"],"description":"Enterprise-only on X. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-posts-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/posts/{itemId}/unlike":{"post":{"operationId":"xPostsUnlike","summary":"X: Unlike (Posts)","tags":["Focus · X"],"description":"Enterprise-only on X. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-posts-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/posts/{itemId}/bookmark":{"post":{"operationId":"xPostsBookmark","summary":"X: Bookmark (Posts)","tags":["Focus · X"],"description":"Bookmark. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"folder_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-posts-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/posts/{itemId}/remove-bookmark":{"post":{"operationId":"xPostsRemoveBookmark","summary":"X: Remove bookmark (Posts)","tags":["Focus · X"],"description":"Remove bookmark. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: `/v1/accounts/{accountId}/focus/posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-posts-remove-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/threads/{itemId}":{"get":{"operationId":"xThreadsGet","summary":"X: Get a Threads item","tags":["Focus · X"],"description":"Your posts in the conversation rooted at :id (recent search). Publish multi-post threads and read back your own threads. Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/threads`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-threads-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"]}},"thread_ids":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/threads":{"post":{"operationId":"xThreadsCreate","summary":"X: Create a Threads item","tags":["Focus · X"],"description":"Publish a thread (chained POST /2/tweets). Publish multi-post threads and read back your own threads. Requires scopes: tweet.read, users.read, tweet.write. Generic route: `/v1/accounts/{accountId}/focus/threads`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"media":{"type":"array","items":{"type":"string"},"maxItems":4}},"required":["text"]},"minItems":1},"reply_settings":{"type":"string","enum":["following","mentionedUsers","subscribers","verified"]},"first_comment":{"type":"string"}},"required":["items"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-threads-create","x-idempotent":true,"x-zernio":["POST /v1/posts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"]}},"thread_ids":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/polls":{"get":{"operationId":"xPollsList","summary":"X: List Polls","tags":["Focus · X"],"description":"Your recent posts that carry a poll. Create polls (2-4 options, 5 min to 7 days) and follow their results. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/polls`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-polls-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":"object","properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xPollsCreate","summary":"X: Create a Polls item","tags":["Focus · X"],"description":"Publish a poll. Create polls (2-4 options, 5 min to 7 days) and follow their results. Requires scopes: tweet.read, users.read, tweet.write. Generic route: `/v1/accounts/{accountId}/focus/polls`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"options":{"type":"array","items":{"type":"string","minLength":1,"maxLength":25},"minItems":2,"maxItems":4},"duration_minutes":{"type":"integer","minimum":5,"maximum":10080,"default":1440},"reply_settings":{"type":"string","enum":["following","mentionedUsers","subscribers","verified"]}},"required":["text","options","duration_minutes"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-polls-create","x-idempotent":true,"x-zernio":["POST /v1/posts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":"object","properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/polls/{itemId}":{"get":{"operationId":"xPollsGet","summary":"X: Get a Polls item","tags":["Focus · X"],"description":"Poll results for a post. Create polls (2-4 options, 5 min to 7 days) and follow their results. Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/polls`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-polls-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":"object","properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/articles":{"post":{"operationId":"xArticlesCreate","summary":"X: Create a Articles item","tags":["Focus · X"],"description":"Create an Article draft and optionally publish it. Long-form X Articles: save a draft on X or publish (the account must be eligible for Articles). Requires scopes: tweet.write. Network docs: https://docs.x.com/x-api/articles/introduction Generic route: `/v1/accounts/{accountId}/focus/articles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1},"text":{"type":"string","description":"Body; \"# \", \"## \", \"> \", \"- \", \"1. \" prefixes become headings, quotes and lists"},"content_state":{"type":"object","properties":{"blocks":{"type":"array","items":{"type":"object","properties":{}}},"entities":{"type":"array","items":{"type":"object","properties":{}}}},"description":"DraftJS content_state (snake_case); overrides text"},"mode":{"type":"string","enum":["publish","draft"],"default":"publish"},"cover":{"type":"string","description":"Cover image (JPG, PNG or WebP)"},"cover_alt_text":{"type":"string","maxLength":1000}},"required":["title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-articles-create","x-idempotent":true,"x-zernio":["POST /v1/posts"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"article_id":{"type":"string","readOnly":true},"title":{"type":"string"},"mode":{"type":"string","enum":["publish","draft"]},"url":{"type":["null","string"],"format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/articles/{itemId}/publish":{"post":{"operationId":"xArticlesPublish","summary":"X: Publish draft (Articles)","tags":["Focus · X"],"description":"POST /2/articles/:id/publish. Long-form X Articles: save a draft on X or publish (the account must be eligible for Articles). Requires scopes: tweet.write. Network docs: https://docs.x.com/x-api/articles/introduction Generic route: `/v1/accounts/{accountId}/focus/articles`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-articles-publish","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/media":{"get":{"operationId":"xMediaList","summary":"X: List Media","tags":["Focus · X"],"description":"Look up media by key (GET /2/media). Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read. Network docs: https://docs.x.com/x-api/media/introduction Generic route: `/v1/accounts/{accountId}/focus/media`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"media_keys","required":true,"description":"Comma-separated media keys"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-media-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string","readOnly":true},"media_id":{"type":["null","string"],"readOnly":true},"type":{"type":"string","readOnly":true},"url":{"type":["null","string"],"format":"uri","readOnly":true},"preview_image_url":{"type":["null","string"],"format":"uri","readOnly":true},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration_ms":{"type":["null","integer"]},"alt_text":{"type":["null","string"],"maxLength":1000},"view_count":{"type":["null","integer"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xMediaCreate","summary":"X: Create a Media item","tags":["Focus · X"],"description":"Upload media (simple for images, chunked for GIF/video). Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string"},"category":{"type":"string","enum":["tweet_image","tweet_gif","tweet_video","amplify_video","dm_image","dm_gif","dm_video"],"default":"tweet_image"},"alt_text":{"type":"string","maxLength":1000}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-media-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"media_key":{"type":"string","readOnly":true},"media_id":{"type":["null","string"],"readOnly":true},"type":{"type":"string","readOnly":true},"url":{"type":["null","string"],"format":"uri","readOnly":true},"preview_image_url":{"type":["null","string"],"format":"uri","readOnly":true},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration_ms":{"type":["null","integer"]},"alt_text":{"type":["null","string"],"maxLength":1000},"view_count":{"type":["null","integer"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/media/{itemId}":{"get":{"operationId":"xMediaGet","summary":"X: Get a Media item","tags":["Focus · X"],"description":"GET /2/media/:media_key. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read. Network docs: https://docs.x.com/x-api/media/introduction Generic route: `/v1/accounts/{accountId}/focus/media`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-media-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"media_key":{"type":"string","readOnly":true},"media_id":{"type":["null","string"],"readOnly":true},"type":{"type":"string","readOnly":true},"url":{"type":["null","string"],"format":"uri","readOnly":true},"preview_image_url":{"type":["null","string"],"format":"uri","readOnly":true},"width":{"type":["null","integer"]},"height":{"type":["null","integer"]},"duration_ms":{"type":["null","integer"]},"alt_text":{"type":["null","string"],"maxLength":1000},"view_count":{"type":["null","integer"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/media/{itemId}/set-metadata":{"post":{"operationId":"xMediaSetMetadata","summary":"X: Alt text and flags (Media)","tags":["Focus · X"],"description":"Alt text and flags. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"alt_text":{"type":"string","maxLength":1000},"sensitive_media":{"type":"object","properties":{"adult_content":{"type":"boolean"},"graphic_violence":{"type":"boolean"},"other":{"type":"boolean"}}},"geo_countries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2}},"allow_download":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-media-set-metadata","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/media/{itemId}/add-subtitles":{"post":{"operationId":"xMediaAddSubtitles","summary":"X: Add subtitles (Media)","tags":["Focus · X"],"description":"Add subtitles. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"SRT or VTT file"},"language":{"type":"string","minLength":2},"display_name":{"type":"string"},"amplify":{"type":"boolean"}},"required":["file","language"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-media-add-subtitles","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/media/{itemId}/delete-subtitles":{"post":{"operationId":"xMediaDeleteSubtitles","summary":"X: Delete subtitles (Media)","tags":["Focus · X"],"description":"Delete subtitles. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Destructive. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"language":{"type":"string","minLength":2},"amplify":{"type":"boolean"}},"required":["language"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_x","x-mcp-tool":"x-media-delete-subtitles","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/media/{itemId}/status":{"post":{"operationId":"xMediaStatus","summary":"X: Processing status (Media)","tags":["Focus · X"],"description":"Processing status. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: `/v1/accounts/{accountId}/focus/media`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-media-status","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/replies":{"get":{"operationId":"xRepliesList","summary":"X: List Replies","tags":["Focus · X"],"description":"Replies to one post (post_id) or to all your recent posts. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/replies`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":false,"description":"Root post id or URL"},{"schema":{"type":"boolean"},"in":"query","name":"archive","required":false,"description":"Full-archive search (older than 7 days)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-replies-list","x-zernio":["GET /v1/inbox/comments","GET /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true},"author":{"type":"string","readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"hidden":{"type":["null","boolean"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xRepliesCreate","summary":"X: Create a Replies item","tags":["Focus · X"],"description":"Reply to a post or reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reply_to_id":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"string"},"maxItems":4}},"required":["reply_to_id","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-replies-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}","POST /v1/inbox/comments/{postId}/{commentId}/hide","POST /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true},"author":{"type":"string","readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"hidden":{"type":["null","boolean"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/replies/{itemId}":{"delete":{"operationId":"xRepliesDelete","summary":"X: Delete a Replies item","tags":["Focus · X"],"description":"Delete one of your replies. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: `/v1/accounts/{accountId}/focus/replies`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-replies-delete","x-zernio":["DELETE /v1/inbox/comments/{postId}","DELETE /v1/inbox/comments/{postId}/{commentId}/hide","DELETE /v1/inbox/comments/{postId}/{commentId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/replies/{itemId}/reply":{"post":{"operationId":"xRepliesReply","summary":"X: Reply (Replies)","tags":["Focus · X"],"description":"Reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"media":{"type":"array","items":{"type":"string"},"maxItems":4}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-replies-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/replies/{itemId}/like":{"post":{"operationId":"xRepliesLike","summary":"X: Like (Replies)","tags":["Focus · X"],"description":"Enterprise-only on X. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, like.write. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-replies-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/replies/{itemId}/unlike":{"post":{"operationId":"xRepliesUnlike","summary":"X: Unlike (Replies)","tags":["Focus · X"],"description":"Enterprise-only on X. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, like.write. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-replies-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/replies/{itemId}/repost":{"post":{"operationId":"xRepliesRepost","summary":"X: Repost (Replies)","tags":["Focus · X"],"description":"Repost. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-replies-repost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/replies/{itemId}/bookmark":{"post":{"operationId":"xRepliesBookmark","summary":"X: Bookmark (Replies)","tags":["Focus · X"],"description":"Bookmark. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-replies-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/replies/{itemId}/hide":{"post":{"operationId":"xRepliesHide","summary":"X: Hide reply (Replies)","tags":["Focus · X"],"description":"Hide reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-replies-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/replies/{itemId}/unhide":{"post":{"operationId":"xRepliesUnhide","summary":"X: Unhide reply (Replies)","tags":["Focus · X"],"description":"Unhide reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: `/v1/accounts/{accountId}/focus/replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-replies-unhide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/mentions":{"get":{"operationId":"xMentionsList","summary":"X: List Mentions","tags":["Focus · X"],"description":"GET /2/users/:id/mentions. Posts that mention you. Replying is allowed on self-serve because you were summoned. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/mentions`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"since_id","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start_time","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end_time","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-mentions-list","x-zernio":["GET /v1/inbox/mentions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true},"author":{"type":"string","readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"hidden":{"type":["null","boolean"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/mentions/{itemId}/reply":{"post":{"operationId":"xMentionsReply","summary":"X: Reply (Mentions)","tags":["Focus · X"],"description":"Reply. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.write. Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"media":{"type":"array","items":{"type":"string"},"maxItems":4}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-mentions-reply","x-idempotent":true,"x-zernio":["POST /v1/inbox/mentions/reply"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/mentions/{itemId}/like":{"post":{"operationId":"xMentionsLike","summary":"X: Like (Mentions)","tags":["Focus · X"],"description":"Enterprise-only on X. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, like.write. Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-mentions-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/mentions/{itemId}/unlike":{"post":{"operationId":"xMentionsUnlike","summary":"X: Unlike (Mentions)","tags":["Focus · X"],"description":"Enterprise-only on X. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, like.write. Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-mentions-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/mentions/{itemId}/repost":{"post":{"operationId":"xMentionsRepost","summary":"X: Repost (Mentions)","tags":["Focus · X"],"description":"Repost. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.write. Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-mentions-repost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/mentions/{itemId}/bookmark":{"post":{"operationId":"xMentionsBookmark","summary":"X: Bookmark (Mentions)","tags":["Focus · X"],"description":"Bookmark. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-mentions-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/mentions/{itemId}/hide":{"post":{"operationId":"xMentionsHide","summary":"X: Hide reply (Mentions)","tags":["Focus · X"],"description":"Only for replies in your conversations. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: `/v1/accounts/{accountId}/focus/mentions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-mentions-hide","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/quotes":{"get":{"operationId":"xQuotesList","summary":"X: List Quotes","tags":["Focus · X"],"description":"GET /2/tweets/:id/quote_tweets. Quote posts of one of your posts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/quotes`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-quotes-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/quotes/{itemId}/reply":{"post":{"operationId":"xQuotesReply","summary":"X: Reply (Quotes)","tags":["Focus · X"],"description":"Reply. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, tweet.write. Generic route: `/v1/accounts/{accountId}/focus/quotes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"media":{"type":"array","items":{"type":"string"},"maxItems":4}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-quotes-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/quotes/{itemId}/like":{"post":{"operationId":"xQuotesLike","summary":"X: Like (Quotes)","tags":["Focus · X"],"description":"Enterprise-only on X. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, like.write. Generic route: `/v1/accounts/{accountId}/focus/quotes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-quotes-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/quotes/{itemId}/unlike":{"post":{"operationId":"xQuotesUnlike","summary":"X: Unlike (Quotes)","tags":["Focus · X"],"description":"Enterprise-only on X. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, like.write. Generic route: `/v1/accounts/{accountId}/focus/quotes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-quotes-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/quotes/{itemId}/repost":{"post":{"operationId":"xQuotesRepost","summary":"X: Repost (Quotes)","tags":["Focus · X"],"description":"Repost. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, tweet.write. Generic route: `/v1/accounts/{accountId}/focus/quotes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-quotes-repost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/quotes/{itemId}/bookmark":{"post":{"operationId":"xQuotesBookmark","summary":"X: Bookmark (Quotes)","tags":["Focus · X"],"description":"Bookmark. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: `/v1/accounts/{accountId}/focus/quotes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-quotes-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/reposts-of-me":{"get":{"operationId":"xRepostsOfMeList","summary":"X: List Reposts of me","tags":["Focus · X"],"description":"GET /2/users/reposts_of_me. Your posts that other accounts reposted. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, timeline.read. Generic route: `/v1/accounts/{accountId}/focus/reposts-of-me`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-reposts-of-me-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/liking-users":{"get":{"operationId":"xLikingUsersList","summary":"X: List Liked by","tags":["Focus · X"],"description":"GET /2/tweets/:id/liking_users. Accounts that liked a post. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read, like.read. Generic route: `/v1/accounts/{accountId}/focus/liking-users`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-liking-users-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/reposted-by":{"get":{"operationId":"xRepostedByList","summary":"X: List Reposted by","tags":["Focus · X"],"description":"GET /2/tweets/:id/retweeted_by. Accounts that reposted a post. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/reposted-by`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"post_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-reposted-by-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/liked-posts":{"get":{"operationId":"xLikedPostsList","summary":"X: List Likes","tags":["Focus · X"],"description":"GET /2/users/:id/liked_tweets. Posts you liked. Liking and unliking are Enterprise-only on X. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read, like.read. Generic route: `/v1/accounts/{accountId}/focus/liked-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-liked-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xLikedPostsCreate","summary":"X: Create a Likes item","tags":["Focus · X"],"description":"Like a post (Enterprise-only). Posts you liked. Liking and unliking are Enterprise-only on X. Requires scopes: tweet.read, users.read, like.read, like.write. Generic route: `/v1/accounts/{accountId}/focus/liked-posts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"post_id":{"type":"string"}},"required":["post_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-liked-posts-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/posts/{postId}/like"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/liked-posts/{itemId}":{"delete":{"operationId":"xLikedPostsDelete","summary":"X: Delete a Likes item","tags":["Focus · X"],"description":"Unlike a post (Enterprise-only). Posts you liked. Liking and unliking are Enterprise-only on X. Requires scopes: tweet.read, users.read, like.read, like.write. Generic route: `/v1/accounts/{accountId}/focus/liked-posts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-liked-posts-delete","x-zernio":["DELETE /v1/inbox/posts/{postId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/bookmark-folders":{"get":{"operationId":"xBookmarkFoldersList","summary":"X: List Bookmark folders","tags":["Focus · X"],"description":"GET /2/users/:id/bookmarks/folders. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: users.read, bookmark.read. Generic route: `/v1/accounts/{accountId}/focus/bookmark-folders`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-bookmark-folders-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25}},"required":["name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xBookmarkFoldersCreate","summary":"X: Create a Bookmark folders item","tags":["Focus · X"],"description":"POST /2/users/:id/bookmarks/folders. Requires scopes: users.read, bookmark.read, bookmark.write. Generic route: `/v1/accounts/{accountId}/focus/bookmark-folders`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":25}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-bookmark-folders-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25}},"required":["name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/home-timeline":{"get":{"operationId":"xHomeTimelineList","summary":"X: List Home timeline","tags":["Focus · X"],"description":"GET /2/users/:id/timelines/reverse_chronological. Posts from accounts you follow, newest first. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["replies","retweets","replies,retweets"]},"in":"query","name":"exclude","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start_time","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end_time","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-home-timeline-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/home-timeline/{itemId}/reply":{"post":{"operationId":"xHomeTimelineReply","summary":"X: Reply (Home timeline)","tags":["Focus · X"],"description":"Reply. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"media":{"type":"array","items":{"type":"string"},"maxItems":4}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-home-timeline-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/home-timeline/{itemId}/like":{"post":{"operationId":"xHomeTimelineLike","summary":"X: Like (Home timeline)","tags":["Focus · X"],"description":"Enterprise-only on X. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-home-timeline-like","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/home-timeline/{itemId}/unlike":{"post":{"operationId":"xHomeTimelineUnlike","summary":"X: Unlike (Home timeline)","tags":["Focus · X"],"description":"Enterprise-only on X. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-home-timeline-unlike","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/home-timeline/{itemId}/repost":{"post":{"operationId":"xHomeTimelineRepost","summary":"X: Repost (Home timeline)","tags":["Focus · X"],"description":"Repost. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-home-timeline-repost","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/home-timeline/{itemId}/bookmark":{"post":{"operationId":"xHomeTimelineBookmark","summary":"X: Bookmark (Home timeline)","tags":["Focus · X"],"description":"Bookmark. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: `/v1/accounts/{accountId}/focus/home-timeline`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-home-timeline-bookmark","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/profile":{"get":{"operationId":"xProfileGet","summary":"X: Get Profile","tags":["Focus · X"],"description":"GET /2/users/me. The connected account: handle, bio, verification and public counts. X has no profile-editing API. Requires scopes: users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/profile`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-profile-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true},"confirmed_email":{"type":["null","string"],"format":"email","readOnly":true,"description":"Needs users.email"},"subscription_type":{"type":["null","string"],"readOnly":true},"verified_followers_count":{"type":["null","integer"],"readOnly":true},"pinned_post_id":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followers":{"get":{"operationId":"xFollowersList","summary":"X: List Followers","tags":["Focus · X"],"description":"GET /2/users/:id/followers ($0.010 per user returned). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: follows.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/followers`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":1000},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"user_id","required":false,"description":"Defaults to the connected account"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-followers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followers/{itemId}/follow":{"post":{"operationId":"xFollowersFollow","summary":"X: Follow (Followers)","tags":["Focus · X"],"description":"Enterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-followers-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followers/{itemId}/unfollow":{"post":{"operationId":"xFollowersUnfollow","summary":"X: Unfollow (Followers)","tags":["Focus · X"],"description":"Enterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-followers-unfollow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followers/{itemId}/mute":{"post":{"operationId":"xFollowersMute","summary":"X: Mute (Followers)","tags":["Focus · X"],"description":"Mute. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-followers-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followers/{itemId}/unmute":{"post":{"operationId":"xFollowersUnmute","summary":"X: Unmute (Followers)","tags":["Focus · X"],"description":"Unmute. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-followers-unmute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followers/{itemId}/block":{"post":{"operationId":"xFollowersBlock","summary":"X: Block (Followers)","tags":["Focus · X"],"description":"Enterprise-only on X. Destructive. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_x","x-mcp-tool":"x-followers-block","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followers/{itemId}/unblock":{"post":{"operationId":"xFollowersUnblock","summary":"X: Unblock (Followers)","tags":["Focus · X"],"description":"Enterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-followers-unblock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followers/{itemId}/block-dms":{"post":{"operationId":"xFollowersBlockDms","summary":"X: Block DMs (Followers)","tags":["Focus · X"],"description":"Block DMs. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-followers-block-dms","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followers/{itemId}/unblock-dms":{"post":{"operationId":"xFollowersUnblockDms","summary":"X: Unblock DMs (Followers)","tags":["Focus · X"],"description":"Unblock DMs. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-followers-unblock-dms","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followers/{itemId}/send-dm":{"post":{"operationId":"xFollowersSendDm","summary":"X: Send DM (Followers)","tags":["Focus · X"],"description":"Send DM. Requires scopes: follows.read, users.read, tweet.read, dm.write, dm.read. Generic route: `/v1/accounts/{accountId}/focus/followers`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":10000}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-followers-send-dm","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following/{itemId}/follow":{"post":{"operationId":"xFollowingFollow","summary":"X: Follow (Following)","tags":["Focus · X"],"description":"Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-following-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following/{itemId}/unfollow":{"post":{"operationId":"xFollowingUnfollow","summary":"X: Unfollow (Following)","tags":["Focus · X"],"description":"Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-following-unfollow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following/{itemId}/mute":{"post":{"operationId":"xFollowingMute","summary":"X: Mute (Following)","tags":["Focus · X"],"description":"Mute. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-following-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following/{itemId}/unmute":{"post":{"operationId":"xFollowingUnmute","summary":"X: Unmute (Following)","tags":["Focus · X"],"description":"Unmute. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-following-unmute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following/{itemId}/block":{"post":{"operationId":"xFollowingBlock","summary":"X: Block (Following)","tags":["Focus · X"],"description":"Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Destructive. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_x","x-mcp-tool":"x-following-block","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following/{itemId}/unblock":{"post":{"operationId":"xFollowingUnblock","summary":"X: Unblock (Following)","tags":["Focus · X"],"description":"Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-following-unblock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following/{itemId}/block-dms":{"post":{"operationId":"xFollowingBlockDms","summary":"X: Block DMs (Following)","tags":["Focus · X"],"description":"Block DMs. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-following-block-dms","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following/{itemId}/unblock-dms":{"post":{"operationId":"xFollowingUnblockDms","summary":"X: Unblock DMs (Following)","tags":["Focus · X"],"description":"Unblock DMs. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-following-unblock-dms","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/following/{itemId}/send-dm":{"post":{"operationId":"xFollowingSendDm","summary":"X: Send DM (Following)","tags":["Focus · X"],"description":"Send DM. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write, dm.read. Generic route: `/v1/accounts/{accountId}/focus/following`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":10000}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-following-send-dm","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users":{"get":{"operationId":"xUsersList","summary":"X: List People","tags":["Focus · X"],"description":"GET /2/users/search. Search and look up X accounts; follow, mute, block or DM them. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/users`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":true,"description":"Name or handle"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-users-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users/{itemId}":{"get":{"operationId":"xUsersGet","summary":"X: Get a People item","tags":["Focus · X"],"description":"GET /2/users/:id or /2/users/by/username/:username. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/users`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-users-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users/{itemId}/follow":{"post":{"operationId":"xUsersFollow","summary":"X: Follow (People)","tags":["Focus · X"],"description":"Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, follows.write. Generic route: `/v1/accounts/{accountId}/focus/users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-users-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users/{itemId}/unfollow":{"post":{"operationId":"xUsersUnfollow","summary":"X: Unfollow (People)","tags":["Focus · X"],"description":"Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, follows.write. Generic route: `/v1/accounts/{accountId}/focus/users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-users-unfollow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users/{itemId}/mute":{"post":{"operationId":"xUsersMute","summary":"X: Mute (People)","tags":["Focus · X"],"description":"Mute. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, mute.write. Generic route: `/v1/accounts/{accountId}/focus/users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-users-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users/{itemId}/unmute":{"post":{"operationId":"xUsersUnmute","summary":"X: Unmute (People)","tags":["Focus · X"],"description":"Unmute. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, mute.write. Generic route: `/v1/accounts/{accountId}/focus/users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-users-unmute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users/{itemId}/block":{"post":{"operationId":"xUsersBlock","summary":"X: Block (People)","tags":["Focus · X"],"description":"Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Destructive. Requires scopes: users.read, tweet.read, block.write. Generic route: `/v1/accounts/{accountId}/focus/users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_x","x-mcp-tool":"x-users-block","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users/{itemId}/unblock":{"post":{"operationId":"xUsersUnblock","summary":"X: Unblock (People)","tags":["Focus · X"],"description":"Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, block.write. Generic route: `/v1/accounts/{accountId}/focus/users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-users-unblock","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users/{itemId}/block-dms":{"post":{"operationId":"xUsersBlockDms","summary":"X: Block DMs (People)","tags":["Focus · X"],"description":"Block DMs. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write. Generic route: `/v1/accounts/{accountId}/focus/users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-users-block-dms","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users/{itemId}/unblock-dms":{"post":{"operationId":"xUsersUnblockDms","summary":"X: Unblock DMs (People)","tags":["Focus · X"],"description":"Unblock DMs. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write. Generic route: `/v1/accounts/{accountId}/focus/users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-users-unblock-dms","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/users/{itemId}/send-dm":{"post":{"operationId":"xUsersSendDm","summary":"X: Send DM (People)","tags":["Focus · X"],"description":"Send DM. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write, dm.read. Generic route: `/v1/accounts/{accountId}/focus/users`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":10000}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-users-send-dm","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/affiliates":{"get":{"operationId":"xAffiliatesList","summary":"X: List Affiliates","tags":["Focus · X"],"description":"GET /2/users/:id/affiliates. Accounts affiliated with a verified organization. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/affiliates`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"user_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-affiliates-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/mutes":{"get":{"operationId":"xMutesList","summary":"X: List Muted accounts","tags":["Focus · X"],"description":"GET /2/users/:id/muting. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: mute.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: `/v1/accounts/{accountId}/focus/mutes`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":1000},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-mutes-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xMutesCreate","summary":"X: Create a Muted accounts item","tags":["Focus · X"],"description":"Mute a user. Requires scopes: mute.read, users.read, tweet.read, mute.write. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: `/v1/accounts/{accountId}/focus/mutes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"},"username":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-mutes-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/mutes/{itemId}":{"delete":{"operationId":"xMutesDelete","summary":"X: Delete a Muted accounts item","tags":["Focus · X"],"description":"Unmute. Requires scopes: mute.read, users.read, tweet.read, mute.write. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: `/v1/accounts/{accountId}/focus/mutes`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-mutes-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/blocks":{"get":{"operationId":"xBlocksList","summary":"X: List Blocked accounts","tags":["Focus · X"],"description":"GET /2/users/:id/blocking. Reading the block list is self-serve; block/unblock are Enterprise-only on X. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: block.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: `/v1/accounts/{accountId}/focus/blocks`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":1000},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-blocks-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xBlocksCreate","summary":"X: Create a Blocked accounts item","tags":["Focus · X"],"description":"Block a user (Enterprise-only). Reading the block list is self-serve; block/unblock are Enterprise-only on X. Requires scopes: block.read, users.read, tweet.read, block.write. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: `/v1/accounts/{accountId}/focus/blocks`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"},"username":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-blocks-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/blocks/{itemId}":{"delete":{"operationId":"xBlocksDelete","summary":"X: Delete a Blocked accounts item","tags":["Focus · X"],"description":"Unblock (Enterprise-only). Reading the block list is self-serve; block/unblock are Enterprise-only on X. Requires scopes: block.read, users.read, tweet.read, block.write. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: `/v1/accounts/{accountId}/focus/blocks`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-blocks-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/lists":{"get":{"operationId":"xListsList","summary":"X: List My lists","tags":["Focus · X"],"description":"GET /2/users/:id/owned_lists. Lists you own: create, edit, delete, add or remove members, follow and pin. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: list.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"user_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-lists-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":["null","string"],"maxLength":100},"private":{"type":"boolean","default":false},"member_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"owner_id":{"type":"string","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["id","name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xListsCreate","summary":"X: Create a My lists item","tags":["Focus · X"],"description":"POST /2/lists. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":"string","maxLength":100},"private":{"type":"boolean"}},"required":["name"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-lists-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":["null","string"],"maxLength":100},"private":{"type":"boolean","default":false},"member_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"owner_id":{"type":"string","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["id","name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/lists/{itemId}":{"get":{"operationId":"xListsGet","summary":"X: Get a My lists item","tags":["Focus · X"],"description":"GET /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-lists-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":["null","string"],"maxLength":100},"private":{"type":"boolean","default":false},"member_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"owner_id":{"type":"string","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["id","name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"xListsUpdate","summary":"X: Update a My lists item","tags":["Focus · X"],"description":"PUT /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":"string","maxLength":100},"private":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_x","x-mcp-tool":"x-lists-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":["null","string"],"maxLength":100},"private":{"type":"boolean","default":false},"member_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"owner_id":{"type":"string","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["id","name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"xListsDelete","summary":"X: Delete a My lists item","tags":["Focus · X"],"description":"DELETE /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-lists-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/lists/{itemId}/add-member":{"post":{"operationId":"xListsAddMember","summary":"X: Add member (My lists)","tags":["Focus · X"],"description":"Add member. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"},"username":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-lists-add-member","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/lists/{itemId}/remove-member":{"post":{"operationId":"xListsRemoveMember","summary":"X: Remove member (My lists)","tags":["Focus · X"],"description":"Remove member. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-lists-remove-member","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/lists/{itemId}/follow":{"post":{"operationId":"xListsFollow","summary":"X: Follow list (My lists)","tags":["Focus · X"],"description":"Follow list. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-lists-follow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/lists/{itemId}/unfollow":{"post":{"operationId":"xListsUnfollow","summary":"X: Unfollow list (My lists)","tags":["Focus · X"],"description":"Unfollow list. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-lists-unfollow","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/lists/{itemId}/pin":{"post":{"operationId":"xListsPin","summary":"X: Pin (My lists)","tags":["Focus · X"],"description":"Pin. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-lists-pin","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/lists/{itemId}/unpin":{"post":{"operationId":"xListsUnpin","summary":"X: Unpin (My lists)","tags":["Focus · X"],"description":"Unpin. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: `/v1/accounts/{accountId}/focus/lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-lists-unpin","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/list-members":{"get":{"operationId":"xListMembersList","summary":"X: List List members","tags":["Focus · X"],"description":"GET /2/lists/:id/members (item id = \"<list_id>:<user_id>\"). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: list.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/list-members`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"list_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-list-members-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true},"list_id":{"type":"string","readOnly":true},"user_id":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xListMembersCreate","summary":"X: Create a List members item","tags":["Focus · X"],"description":"POST /2/lists/:id/members. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: `/v1/accounts/{accountId}/focus/list-members`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list_id":{"type":"string"},"user_id":{"type":"string"},"username":{"type":"string"}},"required":["list_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-list-members-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true},"list_id":{"type":"string","readOnly":true},"user_id":{"type":"string","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/list-members/{itemId}":{"delete":{"operationId":"xListMembersDelete","summary":"X: Delete a List members item","tags":["Focus · X"],"description":"DELETE /2/lists/:id/members/:user_id. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: `/v1/accounts/{accountId}/focus/list-members`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-list-members-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/list-followers":{"get":{"operationId":"xListFollowersList","summary":"X: List List followers","tags":["Focus · X"],"description":"GET /2/lists/:id/followers. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: list.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/list-followers`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"list_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-list-followers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/list-posts":{"get":{"operationId":"xListPostsList","summary":"X: List List timeline","tags":["Focus · X"],"description":"GET /2/lists/:id/tweets. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: list.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/list-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"list_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-list-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followed-lists":{"get":{"operationId":"xFollowedListsList","summary":"X: List Followed lists","tags":["Focus · X"],"description":"GET /2/users/:id/followed_lists. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: list.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/followed-lists`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-followed-lists-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":["null","string"],"maxLength":100},"private":{"type":"boolean","default":false},"member_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"owner_id":{"type":"string","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["id","name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xFollowedListsCreate","summary":"X: Create a Followed lists item","tags":["Focus · X"],"description":"Follow a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: `/v1/accounts/{accountId}/focus/followed-lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list_id":{"type":"string"}},"required":["list_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-followed-lists-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":["null","string"],"maxLength":100},"private":{"type":"boolean","default":false},"member_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"owner_id":{"type":"string","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["id","name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/followed-lists/{itemId}":{"delete":{"operationId":"xFollowedListsDelete","summary":"X: Delete a Followed lists item","tags":["Focus · X"],"description":"Unfollow a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: `/v1/accounts/{accountId}/focus/followed-lists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-followed-lists-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/pinned-lists":{"get":{"operationId":"xPinnedListsList","summary":"X: List Pinned lists","tags":["Focus · X"],"description":"GET /2/users/:id/pinned_lists. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: list.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/pinned-lists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-pinned-lists-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":["null","string"],"maxLength":100},"private":{"type":"boolean","default":false},"member_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"owner_id":{"type":"string","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["id","name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xPinnedListsCreate","summary":"X: Create a Pinned lists item","tags":["Focus · X"],"description":"Pin a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: `/v1/accounts/{accountId}/focus/pinned-lists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"list_id":{"type":"string"}},"required":["list_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-pinned-lists-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":["null","string"],"maxLength":100},"private":{"type":"boolean","default":false},"member_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"owner_id":{"type":"string","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["id","name"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/pinned-lists/{itemId}":{"delete":{"operationId":"xPinnedListsDelete","summary":"X: Delete a Pinned lists item","tags":["Focus · X"],"description":"Unpin a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: `/v1/accounts/{accountId}/focus/pinned-lists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-pinned-lists-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/list-memberships":{"get":{"operationId":"xListMembershipsList","summary":"X: List Lists I am on","tags":["Focus · X"],"description":"GET /2/users/:id/list_memberships. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: list.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/list-memberships`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-list-memberships-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","minLength":1,"maxLength":25},"description":{"type":["null","string"],"maxLength":100},"private":{"type":"boolean","default":false},"member_count":{"type":"integer","readOnly":true},"follower_count":{"type":"integer","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"owner_id":{"type":"string","readOnly":true},"owner_username":{"type":["null","string"],"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["id","name"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/conversations":{"get":{"operationId":"xConversationsList","summary":"X: List Direct messages","tags":["Focus · X"],"description":"Conversations grouped from GET /2/dm_events. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-conversations-list","x-zernio":["GET /v1/inbox/conversations","GET /v1/inbox/conversations/{conversationId}/messages"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["one_to_one","group"],"readOnly":true},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"avatar_url":{"type":"string","format":"uri"}}},"readOnly":true},"last_message":{"type":["null","string"],"readOnly":true},"last_sender_id":{"type":["null","string"],"readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true},"unread_count":{"type":"integer","readOnly":true},"message_count":{"type":"integer","readOnly":true},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"],"readOnly":true},"sent_at":{"type":"string","format":"date-time","readOnly":true},"from_id":{"type":"string","readOnly":true},"sender_username":{"type":["null","string"],"readOnly":true},"sender_name":{"type":["null","string"],"readOnly":true},"conversation_id":{"type":"string","readOnly":true},"event_type":{"type":"string","enum":["MessageCreate","ParticipantsJoin","ParticipantsLeave"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"media_key":{"type":"string"},"url":{"type":["null","string"],"format":"uri"}}},"readOnly":true}}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xConversationsCreate","summary":"X: Create a Direct messages item","tags":["Focus · X"],"description":"Start a 1:1 conversation (participant id or @username) or a group (participant_ids). DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"participant_id":{"type":"string"},"participant_username":{"type":"string"},"participant_ids":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":49,"description":"Group conversation"},"text":{"type":"string","maxLength":10000},"media":{"type":"string"},"skip_dm_check":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-conversations-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/conversations","POST /v1/inbox/conversations/{conversationId}/messages"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["one_to_one","group"],"readOnly":true},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"avatar_url":{"type":"string","format":"uri"}}},"readOnly":true},"last_message":{"type":["null","string"],"readOnly":true},"last_sender_id":{"type":["null","string"],"readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true},"unread_count":{"type":"integer","readOnly":true},"message_count":{"type":"integer","readOnly":true},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"],"readOnly":true},"sent_at":{"type":"string","format":"date-time","readOnly":true},"from_id":{"type":"string","readOnly":true},"sender_username":{"type":["null","string"],"readOnly":true},"sender_name":{"type":["null","string"],"readOnly":true},"conversation_id":{"type":"string","readOnly":true},"event_type":{"type":"string","enum":["MessageCreate","ParticipantsJoin","ParticipantsLeave"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"media_key":{"type":"string"},"url":{"type":["null","string"],"format":"uri"}}},"readOnly":true}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/conversations/{itemId}":{"get":{"operationId":"xConversationsGet","summary":"X: Get a Direct messages item","tags":["Focus · X"],"description":"Messages in a conversation (GET /2/dm_conversations/:id/dm_events). DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: `/v1/accounts/{accountId}/focus/conversations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-conversations-get","x-zernio":["GET /v1/inbox/conversations/{conversationId}","GET /v1/inbox/conversations/{conversationId}/messages/{messageId}/attachments/{index}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["one_to_one","group"],"readOnly":true},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"avatar_url":{"type":"string","format":"uri"}}},"readOnly":true},"last_message":{"type":["null","string"],"readOnly":true},"last_sender_id":{"type":["null","string"],"readOnly":true},"updated_at":{"type":"string","format":"date-time","readOnly":true},"unread_count":{"type":"integer","readOnly":true},"message_count":{"type":"integer","readOnly":true},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"],"readOnly":true},"sent_at":{"type":"string","format":"date-time","readOnly":true},"from_id":{"type":"string","readOnly":true},"sender_username":{"type":["null","string"],"readOnly":true},"sender_name":{"type":["null","string"],"readOnly":true},"conversation_id":{"type":"string","readOnly":true},"event_type":{"type":"string","enum":["MessageCreate","ParticipantsJoin","ParticipantsLeave"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"media_key":{"type":"string"},"url":{"type":["null","string"],"format":"uri"}}},"readOnly":true}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/conversations/{itemId}/send":{"post":{"operationId":"xConversationsSend","summary":"X: Send message (Direct messages)","tags":["Focus · X"],"description":"Send message. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":10000},"media":{"type":"string","description":"One image, GIF or video"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-conversations-send","x-idempotent":true,"x-zernio":["DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/conversations/{itemId}/block-dms":{"post":{"operationId":"xConversationsBlockDms","summary":"X: Block DMs from participant (Direct messages)","tags":["Focus · X"],"description":"Block DMs from participant. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: `/v1/accounts/{accountId}/focus/conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-conversations-block-dms","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/dm-events":{"get":{"operationId":"xDmEventsList","summary":"X: List DM events","tags":["Focus · X"],"description":"GET /2/dm_events. Raw DM event log: messages, joins and leaves across conversations. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: dm.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/dm-events`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"array","items":{"type":"string","enum":["MessageCreate","ParticipantsJoin","ParticipantsLeave"]}},"in":"query","name":"event_types","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-dm-events-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"],"readOnly":true},"sent_at":{"type":"string","format":"date-time","readOnly":true},"from_id":{"type":"string","readOnly":true},"sender_username":{"type":["null","string"],"readOnly":true},"sender_name":{"type":["null","string"],"readOnly":true},"conversation_id":{"type":"string","readOnly":true},"event_type":{"type":"string","enum":["MessageCreate","ParticipantsJoin","ParticipantsLeave"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"media_key":{"type":"string"},"url":{"type":["null","string"],"format":"uri"}}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xDmEventsCreate","summary":"X: Create a DM events item","tags":["Focus · X"],"description":"Send a DM to a participant or conversation. Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read, dm.write. Generic route: `/v1/accounts/{accountId}/focus/dm-events`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"participant_id":{"type":"string"},"conversation_id":{"type":"string"},"text":{"type":"string","maxLength":10000},"media":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-dm-events-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"],"readOnly":true},"sent_at":{"type":"string","format":"date-time","readOnly":true},"from_id":{"type":"string","readOnly":true},"sender_username":{"type":["null","string"],"readOnly":true},"sender_name":{"type":["null","string"],"readOnly":true},"conversation_id":{"type":"string","readOnly":true},"event_type":{"type":"string","enum":["MessageCreate","ParticipantsJoin","ParticipantsLeave"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"media_key":{"type":"string"},"url":{"type":["null","string"],"format":"uri"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/dm-events/{itemId}":{"get":{"operationId":"xDmEventsGet","summary":"X: Get a DM events item","tags":["Focus · X"],"description":"GET /2/dm_events/:id. Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/dm-events`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-dm-events-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string"},"direction":{"type":"string","enum":["in","out"],"readOnly":true},"sent_at":{"type":"string","format":"date-time","readOnly":true},"from_id":{"type":"string","readOnly":true},"sender_username":{"type":["null","string"],"readOnly":true},"sender_name":{"type":["null","string"],"readOnly":true},"conversation_id":{"type":"string","readOnly":true},"event_type":{"type":"string","enum":["MessageCreate","ParticipantsJoin","ParticipantsLeave"],"readOnly":true},"attachments":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"media_key":{"type":"string"},"url":{"type":["null","string"],"format":"uri"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"xDmEventsDelete","summary":"X: Delete a DM events item","tags":["Focus · X"],"description":"DELETE /2/dm_events/:id (for you only). Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read, dm.write. Generic route: `/v1/accounts/{accountId}/focus/dm-events`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-dm-events-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/chat-conversations":{"get":{"operationId":"xChatConversationsList","summary":"X: List X Chat","tags":["Focus · X"],"description":"GET /2/chat/conversations (or message requests). Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: `/v1/accounts/{accountId}/focus/chat-conversations`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"boolean"},"in":"query","name":"unread_only","required":false},{"schema":{"type":"string","enum":["inbox","requests"],"default":"inbox"},"in":"query","name":"folder","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-chat-conversations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":["null","string"]},"group_name":{"type":["null","string"],"description":"Encrypted with the conversation key for groups"},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"name":{"type":"string"}}}},"unread":{"type":["null","boolean"]},"is_archived":{"type":"boolean"},"is_muted":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"newest_event_id":{"type":["null","string"]},"message_ttl_ms":{"type":["null","integer"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/chat-conversations/{itemId}":{"get":{"operationId":"xChatConversationsGet","summary":"X: Get a X Chat item","tags":["Focus · X"],"description":"GET /2/chat/conversations/:id. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: `/v1/accounts/{accountId}/focus/chat-conversations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-chat-conversations-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":["null","string"]},"group_name":{"type":["null","string"],"description":"Encrypted with the conversation key for groups"},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"name":{"type":"string"}}}},"unread":{"type":["null","boolean"]},"is_archived":{"type":"boolean"},"is_muted":{"type":"boolean"},"created_at":{"type":["null","string"],"format":"date-time"},"updated_at":{"type":["null","string"],"format":"date-time"},"newest_event_id":{"type":["null","string"]},"message_ttl_ms":{"type":["null","integer"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/chat-conversations/{itemId}/mark-read":{"post":{"operationId":"xChatConversationsMarkRead","summary":"X: Mark read (X Chat)","tags":["Focus · X"],"description":"Mark read. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: `/v1/accounts/{accountId}/focus/chat-conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-chat-conversations-mark-read","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/chat-conversations/{itemId}/mark-unread":{"post":{"operationId":"xChatConversationsMarkUnread","summary":"X: Mark unread (X Chat)","tags":["Focus · X"],"description":"Mark unread. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: `/v1/accounts/{accountId}/focus/chat-conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-chat-conversations-mark-unread","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/chat-conversations/{itemId}/archive":{"post":{"operationId":"xChatConversationsArchive","summary":"X: Archive (X Chat)","tags":["Focus · X"],"description":"Archive. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: `/v1/accounts/{accountId}/focus/chat-conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-chat-conversations-archive","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/chat-conversations/{itemId}/unarchive":{"post":{"operationId":"xChatConversationsUnarchive","summary":"X: Unarchive (X Chat)","tags":["Focus · X"],"description":"Unarchive. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: `/v1/accounts/{accountId}/focus/chat-conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-chat-conversations-unarchive","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/chat-conversations/{itemId}/mute":{"post":{"operationId":"xChatConversationsMute","summary":"X: Mute (X Chat)","tags":["Focus · X"],"description":"Mute. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: `/v1/accounts/{accountId}/focus/chat-conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-chat-conversations-mute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/chat-conversations/{itemId}/unmute":{"post":{"operationId":"xChatConversationsUnmute","summary":"X: Unmute (X Chat)","tags":["Focus · X"],"description":"Unmute. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: `/v1/accounts/{accountId}/focus/chat-conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-chat-conversations-unmute","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/chat-conversations/{itemId}/accept":{"post":{"operationId":"xChatConversationsAccept","summary":"X: Accept message request (X Chat)","tags":["Focus · X"],"description":"Accept message request. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: `/v1/accounts/{accountId}/focus/chat-conversations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-chat-conversations-accept","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/post-counts":{"get":{"operationId":"xPostCountsList","summary":"X: List Post volume","tags":["Focus · X"],"description":"GET /2/tweets/counts/recent ($0.005 per request). How many posts match a query over the last 7 days (per minute, hour or day). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read. Generic route: `/v1/accounts/{accountId}/focus/post-counts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"type":"string","enum":["minute","hour","day"],"default":"day"},"in":"query","name":"granularity","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start_time","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end_time","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-post-counts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"posts":{"type":"integer"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/trends":{"get":{"operationId":"xTrendsList","summary":"X: List Trends","tags":["Focus · X"],"description":"GET /2/users/personalized_trends | /2/trends/by/woeid/:woeid ($0.010 per request). Trends personalized for the account, or for a location (WOEID). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/trends`.","parameters":[{"schema":{"type":"integer"},"in":"query","name":"woeid","required":false,"description":"Yahoo WOEID (1 = worldwide). Omit for personalized trends."},{"schema":{"type":"integer","minimum":1,"maximum":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-trends-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"trend_name":{"type":"string"},"post_count":{"type":["null","string"],"description":"As reported by X, e.g. \"12.5K posts\""},"category":{"type":["null","string"]},"trending_since":{"type":["null","string"]},"search_url":{"type":"string","format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/news":{"get":{"operationId":"xNewsList","summary":"X: List News","tags":["Focus · X"],"description":"GET /2/news/search. X News stories (Grok-summarized clusters of posts). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/news`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"type":"integer","minimum":1,"maximum":720,"default":168},"in":"query","name":"max_age_hours","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-news-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"summary":{"type":"string"},"hook":{"type":["null","string"]},"category":{"type":["null","string"]},"keywords":{"type":"array","items":{"type":"string"}},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/news/{itemId}":{"get":{"operationId":"xNewsGet","summary":"X: Get a News item","tags":["Focus · X"],"description":"GET /2/news/:id. X News stories (Grok-summarized clusters of posts). Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/news`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-news-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"summary":{"type":"string"},"hook":{"type":["null","string"]},"category":{"type":["null","string"]},"keywords":{"type":"array","items":{"type":"string"}},"updated_at":{"type":["null","string"],"format":"date-time"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/communities":{"get":{"operationId":"xCommunitiesList","summary":"X: List Communities","tags":["Focus · X"],"description":"GET /2/communities/search. Find X Communities and post into them. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: `/v1/accounts/{accountId}/focus/communities`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":10,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-communities-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"description":{"type":["null","string"]},"access":{"type":["null","string"]},"join_policy":{"type":["null","string"]},"member_count":{"type":["null","integer"]},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":"string","format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/communities/{itemId}":{"get":{"operationId":"xCommunitiesGet","summary":"X: Get a Communities item","tags":["Focus · X"],"description":"GET /2/communities/:id. Find X Communities and post into them. Requires scopes: tweet.read, users.read, list.read. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: `/v1/accounts/{accountId}/focus/communities`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-communities-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"description":{"type":["null","string"]},"access":{"type":["null","string"]},"join_policy":{"type":["null","string"]},"member_count":{"type":["null","integer"]},"created_at":{"type":["null","string"],"format":"date-time"},"url":{"type":"string","format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/communities/{itemId}/post":{"post":{"operationId":"xCommunitiesPost","summary":"X: Post to community (Communities)","tags":["Focus · X"],"description":"Post to community. Find X Communities and post into them. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: `/v1/accounts/{accountId}/focus/communities`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"media":{"type":"array","items":{"type":"string"},"maxItems":4},"share_with_followers":{"type":"boolean"}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-communities-post","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/spaces":{"get":{"operationId":"xSpacesList","summary":"X: List Spaces","tags":["Focus · X"],"description":"GET /2/spaces/by/creator_ids (mine) | /2/spaces/search. Your live and scheduled Spaces, or search Spaces. Spaces cannot be created through the API. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: space.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/spaces/introduction Generic route: `/v1/accounts/{accountId}/focus/spaces`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"q","required":false,"description":"Search Spaces; omit for your own"},{"schema":{"type":"string","enum":["live","scheduled","all"],"default":"all"},"in":"query","name":"state","required":false},{"schema":{"type":"string"},"in":"query","name":"creator_ids","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-spaces-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"state":{"type":"string","enum":["live","scheduled","ended"]},"lang":{"type":["null","string"]},"is_ticketed":{"type":"boolean"},"participant_count":{"type":["null","integer"]},"subscriber_count":{"type":["null","integer"]},"scheduled_start":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"creator_id":{"type":"string"},"creator_username":{"type":["null","string"]},"url":{"type":"string","format":"uri"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/spaces/{itemId}":{"get":{"operationId":"xSpacesGet","summary":"X: Get a Spaces item","tags":["Focus · X"],"description":"GET /2/spaces/:id. Your live and scheduled Spaces, or search Spaces. Spaces cannot be created through the API. Requires scopes: space.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/spaces/introduction Generic route: `/v1/accounts/{accountId}/focus/spaces`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-spaces-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"state":{"type":"string","enum":["live","scheduled","ended"]},"lang":{"type":["null","string"]},"is_ticketed":{"type":"boolean"},"participant_count":{"type":["null","integer"]},"subscriber_count":{"type":["null","integer"]},"scheduled_start":{"type":["null","string"],"format":"date-time"},"started_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"creator_id":{"type":"string"},"creator_username":{"type":["null","string"]},"url":{"type":"string","format":"uri"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/space-posts":{"get":{"operationId":"xSpacePostsList","summary":"X: List Space posts","tags":["Focus · X"],"description":"GET /2/spaces/:id/tweets. Posts shared in a Space. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: space.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/space-posts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"space_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-space-posts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","title":"Text"},"created_at":{"type":"string","format":"date-time","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"kind":{"type":"string","enum":["post","reply","quote","repost"],"readOnly":true},"author_id":{"type":"string","readOnly":true},"author_username":{"type":"string","readOnly":true},"author_name":{"type":"string","readOnly":true},"author_avatar_url":{"type":"string","format":"uri","readOnly":true},"conversation_id":{"type":"string","readOnly":true},"in_reply_to_user_id":{"type":["null","string"],"readOnly":true},"reply_to_id":{"type":["null","string"],"readOnly":true},"quoted_id":{"type":["null","string"],"readOnly":true},"reposted_id":{"type":["null","string"],"readOnly":true},"lang":{"type":"string","readOnly":true},"reply_settings":{"type":"string","enum":["everyone","following","mentionedUsers","subscribers","verified"]},"community_id":{"type":["null","string"]},"possibly_sensitive":{"type":"boolean","readOnly":true},"paid_partnership":{"type":"boolean"},"editable_until":{"type":["null","string"],"format":"date-time","readOnly":true},"edits_remaining":{"type":["null","integer"],"readOnly":true},"media":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"type":{"type":"string","enum":["photo","video","animated_gif"]},"url":{"type":"string","format":"uri"},"preview_image_url":{"type":"string","format":"uri"},"width":{"type":"integer"},"height":{"type":"integer"},"duration_ms":{"type":"integer"},"alt_text":{"type":"string"},"view_count":{"type":"integer"}}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"id":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"label":{"type":"string"},"votes":{"type":"integer"}}}},"total_votes":{"type":"integer"},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"likes":{"type":"integer","readOnly":true},"reposts":{"type":"integer","readOnly":true},"replies":{"type":"integer","readOnly":true},"quotes":{"type":"integer","readOnly":true},"bookmarks":{"type":"integer","readOnly":true},"impressions":{"type":"integer","readOnly":true}},"required":["id","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/space-buyers":{"get":{"operationId":"xSpaceBuyersList","summary":"X: List Ticket buyers","tags":["Focus · X"],"description":"GET /2/spaces/:id/buyers. Accounts that bought a ticket to your ticketed Space. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: space.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/space-buyers`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"space_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-space-buyers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/broadcasts":{"get":{"operationId":"xBroadcastsList","summary":"X: List Broadcasts","tags":["Focus · X"],"description":"GET /2/broadcasts. Your X Live broadcasts: live, ended and replays with viewer counts. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: broadcast.read. Network docs: https://docs.x.com/x-api/broadcasts/introduction Generic route: `/v1/accounts/{accountId}/focus/broadcasts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"ids","required":false,"description":"Comma-separated broadcast ids"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-broadcasts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":["null","string"]},"state":{"type":["null","string"]},"share_url":{"type":["null","string"],"format":"uri"},"image_url":{"type":["null","string"],"format":"uri"},"post_id":{"type":["null","string"]},"chat_option":{"type":["null","integer"]},"available_for_replay":{"type":["null","boolean"]},"language":{"type":["null","string"]},"started_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"scheduled_start":{"type":["null","string"],"format":"date-time"},"scheduled_end":{"type":["null","string"],"format":"date-time"},"watching":{"type":["null","integer"]},"watched":{"type":["null","integer"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/broadcasts/{itemId}":{"get":{"operationId":"xBroadcastsGet","summary":"X: Get a Broadcasts item","tags":["Focus · X"],"description":"GET /2/broadcasts/:id. Your X Live broadcasts: live, ended and replays with viewer counts. Requires scopes: broadcast.read. Network docs: https://docs.x.com/x-api/broadcasts/introduction Generic route: `/v1/accounts/{accountId}/focus/broadcasts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-broadcasts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":["null","string"]},"state":{"type":["null","string"]},"share_url":{"type":["null","string"],"format":"uri"},"image_url":{"type":["null","string"],"format":"uri"},"post_id":{"type":["null","string"]},"chat_option":{"type":["null","integer"]},"available_for_replay":{"type":["null","boolean"]},"language":{"type":["null","string"]},"started_at":{"type":["null","string"],"format":"date-time"},"ended_at":{"type":["null","string"],"format":"date-time"},"scheduled_start":{"type":["null","string"],"format":"date-time"},"scheduled_end":{"type":["null","string"],"format":"date-time"},"watching":{"type":["null","integer"]},"watched":{"type":["null","integer"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/scheduled-broadcasts":{"get":{"operationId":"xScheduledBroadcastsList","summary":"X: List Scheduled broadcasts","tags":["Focus · X"],"description":"GET /2/broadcasts/scheduled. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: broadcast.read. Generic route: `/v1/accounts/{accountId}/focus/scheduled-broadcasts`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"oldest_start_time","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"newest_start_time","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-scheduled-broadcasts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"broadcast_id":{"type":["null","string"],"readOnly":true},"title":{"type":"string"},"description":{"type":["null","string"]},"state":{"type":["null","string"],"readOnly":true},"source_id":{"type":"string","description":"Ingest source id (RTMP stream key)"},"scheduled_start":{"type":"string","format":"date-time"},"scheduled_end":{"type":["null","string"],"format":"date-time"},"chat_option":{"type":["null","string"],"enum":["0","1","2","3","4","5","6",null],"description":"Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed"},"available_for_replay":{"type":["null","boolean"]},"manual_publish":{"type":["null","boolean"]},"locale":{"type":["null","string"]},"recurring_schedule_id":{"type":["null","string"],"readOnly":true},"thumbnail_media_id":{"type":["null","string"]}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xScheduledBroadcastsCreate","summary":"X: Create a Scheduled broadcasts item","tags":["Focus · X"],"description":"POST /2/broadcasts/scheduled. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/scheduled-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"source_id":{"type":"string","description":"Ingest source id (RTMP stream key)"},"scheduled_start":{"type":"string","format":"date-time"},"scheduled_end":{"type":"string","format":"date-time"},"chat_option":{"type":"string","enum":["0","1","2","3","4","5","6"],"description":"Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed"},"available_for_replay":{"type":"boolean"},"manual_publish":{"type":"boolean","description":"Do not auto-publish at start; call go-live"},"is_locked":{"type":"boolean"},"locale":{"type":"string"},"thumbnail_media_id":{"type":"string"},"recurrence":{"type":"object","properties":{"frequency":{"type":"string","enum":["Daily","Weekly"]},"repeats":{"type":"integer","minimum":1}}}},"required":["source_id","scheduled_start"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-scheduled-broadcasts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"broadcast_id":{"type":["null","string"],"readOnly":true},"title":{"type":"string"},"description":{"type":["null","string"]},"state":{"type":["null","string"],"readOnly":true},"source_id":{"type":"string","description":"Ingest source id (RTMP stream key)"},"scheduled_start":{"type":"string","format":"date-time"},"scheduled_end":{"type":["null","string"],"format":"date-time"},"chat_option":{"type":["null","string"],"enum":["0","1","2","3","4","5","6",null],"description":"Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed"},"available_for_replay":{"type":["null","boolean"]},"manual_publish":{"type":["null","boolean"]},"locale":{"type":["null","string"]},"recurring_schedule_id":{"type":["null","string"],"readOnly":true},"thumbnail_media_id":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/scheduled-broadcasts/{itemId}":{"get":{"operationId":"xScheduledBroadcastsGet","summary":"X: Get a Scheduled broadcasts item","tags":["Focus · X"],"description":"GET /2/broadcasts/scheduled/:id. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read. Generic route: `/v1/accounts/{accountId}/focus/scheduled-broadcasts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-scheduled-broadcasts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"broadcast_id":{"type":["null","string"],"readOnly":true},"title":{"type":"string"},"description":{"type":["null","string"]},"state":{"type":["null","string"],"readOnly":true},"source_id":{"type":"string","description":"Ingest source id (RTMP stream key)"},"scheduled_start":{"type":"string","format":"date-time"},"scheduled_end":{"type":["null","string"],"format":"date-time"},"chat_option":{"type":["null","string"],"enum":["0","1","2","3","4","5","6",null],"description":"Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed"},"available_for_replay":{"type":["null","boolean"]},"manual_publish":{"type":["null","boolean"]},"locale":{"type":["null","string"]},"recurring_schedule_id":{"type":["null","string"],"readOnly":true},"thumbnail_media_id":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"xScheduledBroadcastsUpdate","summary":"X: Update a Scheduled broadcasts item","tags":["Focus · X"],"description":"PUT /2/broadcasts/scheduled/:id (start and end are required by X; missing ones are read back first). Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/scheduled-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"source_id":{"type":"string","description":"Ingest source id (RTMP stream key)"},"scheduled_start":{"type":"string","format":"date-time"},"scheduled_end":{"type":"string","format":"date-time"},"chat_option":{"type":"string","enum":["0","1","2","3","4","5","6"],"description":"Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed"},"available_for_replay":{"type":"boolean"},"manual_publish":{"type":"boolean","description":"Do not auto-publish at start; call go-live"},"is_locked":{"type":"boolean"},"locale":{"type":"string"},"thumbnail_media_id":{"type":"string"},"recurrence":{"type":"object","properties":{"frequency":{"type":"string","enum":["Daily","Weekly"]},"repeats":{"type":"integer","minimum":1}}},"roll_forward":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_x","x-mcp-tool":"x-scheduled-broadcasts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"broadcast_id":{"type":["null","string"],"readOnly":true},"title":{"type":"string"},"description":{"type":["null","string"]},"state":{"type":["null","string"],"readOnly":true},"source_id":{"type":"string","description":"Ingest source id (RTMP stream key)"},"scheduled_start":{"type":"string","format":"date-time"},"scheduled_end":{"type":["null","string"],"format":"date-time"},"chat_option":{"type":["null","string"],"enum":["0","1","2","3","4","5","6",null],"description":"Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed"},"available_for_replay":{"type":["null","boolean"]},"manual_publish":{"type":["null","boolean"]},"locale":{"type":["null","string"]},"recurring_schedule_id":{"type":["null","string"],"readOnly":true},"thumbnail_media_id":{"type":["null","string"]}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"xScheduledBroadcastsDelete","summary":"X: Delete a Scheduled broadcasts item","tags":["Focus · X"],"description":"DELETE /2/broadcasts/scheduled/:id. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/scheduled-broadcasts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-scheduled-broadcasts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/scheduled-broadcasts/{itemId}/go-live":{"post":{"operationId":"xScheduledBroadcastsGoLive","summary":"X: Go live (Scheduled broadcasts)","tags":["Focus · X"],"description":"POST /2/broadcasts/scheduled/:id/live (for manual_publish broadcasts). Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/scheduled-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-scheduled-broadcasts-go-live","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/broadcast-chat":{"get":{"operationId":"xBroadcastChatList","summary":"X: List Live chat","tags":["Focus · X"],"description":"GET /2/broadcasts/:id/chat (item id = \"<broadcast_id>:<message_id>\"). Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: broadcast.read. Generic route: `/v1/accounts/{accountId}/focus/broadcast-chat`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Pagination cursor (next_cursor)"},{"schema":{"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"broadcast_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-broadcast-chat-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message_id":{"type":"string","readOnly":true},"broadcast_id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":140},"author_id":{"type":["null","string"],"readOnly":true},"author_username":{"type":["null","string"],"readOnly":true},"author_name":{"type":["null","string"],"readOnly":true},"reply_to":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xBroadcastChatCreate","summary":"X: Create a Live chat item","tags":["Focus · X"],"description":"POST /2/broadcasts/:id/chat. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/broadcast-chat`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"broadcast_id":{"type":"string"},"text":{"type":"string","maxLength":140},"reply_to":{"type":"string"}},"required":["broadcast_id","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-broadcast-chat-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"message_id":{"type":"string","readOnly":true},"broadcast_id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":140},"author_id":{"type":["null","string"],"readOnly":true},"author_username":{"type":["null","string"],"readOnly":true},"author_name":{"type":["null","string"],"readOnly":true},"reply_to":{"type":["null","string"]},"created_at":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/broadcast-chat/{itemId}":{"delete":{"operationId":"xBroadcastChatDelete","summary":"X: Delete a Live chat item","tags":["Focus · X"],"description":"DELETE /2/broadcasts/:id/chat/:message_id. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/broadcast-chat`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-broadcast-chat-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/broadcast-chat/{itemId}/mute-author":{"post":{"operationId":"xBroadcastChatMuteAuthor","summary":"X: Mute author (Live chat)","tags":["Focus · X"],"description":"Mute author. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/broadcast-chat`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"minutes":{"type":"integer","minimum":1,"description":"Omit to mute for the whole broadcast"},"remove_message":{"type":"boolean","default":true}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-broadcast-chat-mute-author","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/broadcast-chat/mute-user":{"post":{"operationId":"xBroadcastChatMuteUser","summary":"X: Mute user (Live chat)","tags":["Focus · X"],"description":"Mute user. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/broadcast-chat`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"broadcast_id":{"type":"string"},"user_id":{"type":"string"},"minutes":{"type":"integer","minimum":1}},"required":["broadcast_id","user_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-broadcast-chat-mute-user","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/broadcast-chat/unmute-user":{"post":{"operationId":"xBroadcastChatUnmuteUser","summary":"X: Unmute user (Live chat)","tags":["Focus · X"],"description":"Unmute user. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/broadcast-chat`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"broadcast_id":{"type":"string"},"user_id":{"type":"string"}},"required":["broadcast_id","user_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_x","x-mcp-tool":"x-broadcast-chat-unmute-user","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/broadcast-moderators":{"get":{"operationId":"xBroadcastModeratorsList","summary":"X: List Chat moderators","tags":["Focus · X"],"description":"GET /2/broadcasts/chat/moderators. Accounts allowed to moderate your live chats. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: broadcast.read, users.read, tweet.read. Generic route: `/v1/accounts/{accountId}/focus/broadcast-moderators`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-broadcast-moderators-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"xBroadcastModeratorsCreate","summary":"X: Create a Chat moderators item","tags":["Focus · X"],"description":"POST /2/broadcasts/chat/moderators. Accounts allowed to moderate your live chats. Requires scopes: broadcast.read, users.read, tweet.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/broadcast-moderators`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"}},"required":["user_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_x","x-mcp-tool":"x-broadcast-moderators-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"username":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"avatar_url":{"type":"string","format":"uri","readOnly":true},"description":{"type":"string","readOnly":true},"location":{"type":["null","string"],"readOnly":true},"website":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"protected":{"type":"boolean","readOnly":true},"verified":{"type":"boolean","readOnly":true},"verified_type":{"type":["null","string"],"enum":["blue","business","government","none",null],"readOnly":true},"followers":{"type":"integer","readOnly":true},"following":{"type":"integer","readOnly":true},"posts":{"type":"integer","readOnly":true},"listed":{"type":"integer","readOnly":true},"likes":{"type":["null","integer"],"readOnly":true},"media_count":{"type":["null","integer"],"readOnly":true}},"required":["id","username"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/broadcast-moderators/{itemId}":{"delete":{"operationId":"xBroadcastModeratorsDelete","summary":"X: Delete a Chat moderators item","tags":["Focus · X"],"description":"DELETE /2/broadcasts/chat/moderators/:user_id. Accounts allowed to moderate your live chats. Requires scopes: broadcast.read, users.read, tweet.read, broadcast.write. Generic route: `/v1/accounts/{accountId}/focus/broadcast-moderators`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_x","x-mcp-tool":"x-broadcast-moderators-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/account-overview":{"get":{"operationId":"xAccountOverviewGet","summary":"X: Get Overview","tags":["Focus · X"],"description":"GET /2/users/:id + GET /2/users/:id/tweets in the period. Followers and daily engagement aggregated from your posts in the period. Requires scopes: tweet.read, users.read. Generic route: `/v1/accounts/{accountId}/focus/account-overview`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-account-overview-get","x-zernio":["GET /v1/accounts/follower-stats"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"followers":{"type":"integer"},"following":{"type":"integer"},"posts_count":{"type":"integer"},"listed_count":{"type":"integer"},"likes_count":{"type":"integer"},"media_count":{"type":"integer"},"totals":{"type":"object","properties":{"impressions":{"type":"integer"},"likes":{"type":"integer"},"comments":{"type":"integer"},"shares":{"type":"integer"},"quotes":{"type":"integer"},"saves":{"type":"integer"},"clicks":{"type":"integer"},"profile_views":{"type":"integer"},"views":{"type":"integer"},"engagements":{"type":"integer"},"engagement_rate":{"type":"number"}}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"metrics":{"type":"object","properties":{"impressions":{"type":"integer"},"likes":{"type":"integer"},"comments":{"type":"integer"},"shares":{"type":"integer"},"quotes":{"type":"integer"},"saves":{"type":"integer"},"clicks":{"type":"integer"},"profile_views":{"type":"integer"},"views":{"type":"integer"},"engagements":{"type":"integer"},"engagement_rate":{"type":"number"}}}}}},"posts_analyzed":{"type":"integer"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/post-metrics":{"get":{"operationId":"xPostMetricsList","summary":"X: List Post performance","tags":["Focus · X"],"description":"Recent posts (or ids) with public + non-public metrics. Per-post impressions, engagements, link and profile clicks (non-public metrics for posts under 30 days). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/fundamentals/metrics Generic route: `/v1/accounts/{accountId}/focus/post-metrics`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"ids","required":false,"description":"Comma-separated post ids; omit for your recent posts"},{"schema":{"type":"integer","minimum":5,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-post-metrics-list","x-zernio":["GET /v1/analytics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri"},"metrics":{"type":"object","properties":{"impressions":{"type":"integer"},"likes":{"type":"integer"},"comments":{"type":"integer"},"shares":{"type":"integer"},"quotes":{"type":"integer"},"saves":{"type":"integer"},"clicks":{"type":"integer"},"profile_views":{"type":"integer"},"views":{"type":"integer"},"engagements":{"type":"integer"},"engagement_rate":{"type":"number"}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/post-analytics":{"get":{"operationId":"xPostAnalyticsList","summary":"X: List Post analytics (Enterprise)","tags":["Focus · X"],"description":"GET /2/tweets/analytics. Hourly/daily/weekly time series for up to 100 posts. Requires an X Enterprise contract. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/get-post-analytics Generic route: `/v1/accounts/{accountId}/focus/post-analytics`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"ids","required":true,"description":"Comma-separated post ids (≤100)"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string","enum":["hourly","daily","weekly","total"],"default":"daily"},"in":"query","name":"granularity","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-post-analytics-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"metrics":{"type":"object","properties":{"impressions":{"type":"integer"},"likes":{"type":"integer"},"comments":{"type":"integer"},"shares":{"type":"integer"},"quotes":{"type":"integer"},"saves":{"type":"integer"},"clicks":{"type":"integer"},"profile_views":{"type":"integer"},"views":{"type":"integer"},"engagements":{"type":"integer"},"engagement_rate":{"type":"number"}}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"metrics":{"type":"object","properties":{"impressions":{"type":"integer"},"likes":{"type":"integer"},"comments":{"type":"integer"},"shares":{"type":"integer"},"quotes":{"type":"integer"},"saves":{"type":"integer"},"clicks":{"type":"integer"},"profile_views":{"type":"integer"},"views":{"type":"integer"},"engagements":{"type":"integer"},"engagement_rate":{"type":"number"}}}}}}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/media-analytics":{"get":{"operationId":"xMediaAnalyticsList","summary":"X: List Video analytics (Enterprise)","tags":["Focus · X"],"description":"GET /2/media/analytics. Video views, playback quartiles and watch time. Requires an X Enterprise contract. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: tweet.read. Generic route: `/v1/accounts/{accountId}/focus/media-analytics`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"media_keys","required":true},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"until","required":false},{"schema":{"type":"string","enum":["hourly","daily","total"],"default":"daily"},"in":"query","name":"granularity","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-media-analytics-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"media_key":{"type":"string"},"video_views":{"type":"integer"},"playback_start":{"type":"integer"},"playback25":{"type":"integer"},"playback50":{"type":"integer"},"playback75":{"type":"integer"},"playback_complete":{"type":"integer"},"watch_time_ms":{"type":"integer"}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/x/usage":{"get":{"operationId":"xUsageGet","summary":"X: Get API usage","tags":["Focus · X"],"description":"GET /2/usage/credits + GET /2/usage/tweets (app bearer). X developer-account credit balance and daily post consumption against the monthly cap. Generic route: `/v1/accounts/{accountId}/focus/usage`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_x","x-mcp-tool":"x-usage-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"total_balance":{"type":["null","number"]},"prepaid_balance":{"type":["null","number"]},"free_balance":{"type":["null","number"]},"project_cap":{"type":["null","integer"]},"project_usage":{"type":["null","integer"]},"cap_reset_day":{"type":["null","integer"]},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"metrics":{"type":"object","properties":{"posts":{"type":"integer"}}}}}}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/channel-dashboard":{"get":{"operationId":"youtubeChannelDashboardGet","summary":"YouTube: Get Channel dashboard","tags":["Focus · YouTube"],"description":"Channel stats + 28-day totals + latest 5 uploads with analytics · quota: 3 units + 3 analytics queries (channels.list, playlistItems.list, videos.list, analytics.reports.query). Channel stats, last 28 days, latest uploads with their performance. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/list Generic route: `/v1/accounts/{accountId}/focus/channel-dashboard`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-dashboard-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"channel":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"thumbnail_url":{"type":"string","format":"uri"},"subscriber_count":{"type":["null","integer"]},"view_count":{"type":["null","integer"]},"video_count":{"type":["null","integer"]}},"readOnly":true},"period":{"type":"object","properties":{"since":{"type":"string"},"until":{"type":"string"}},"readOnly":true},"totals":{"type":"object","properties":{},"additionalProperties":{"type":"number"},"description":"YouTube Analytics totals for the period","readOnly":true},"latest_videos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"]},"readOnly":true},"top_videos":{"type":"array","items":{"type":"object","properties":{"video":{"type":"string"},"views":{"type":"number"},"estimatedMinutesWatched":{"type":"number"}}},"readOnly":true},"analytics_error":{"type":["null","string"],"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/quota":{"get":{"operationId":"youtubeQuotaGet","summary":"YouTube: Get API quota","tags":["Focus · YouTube"],"description":"Quota buckets and cost table (no API call) · quota: none (no API call). YouTube Data API quota: per-project daily buckets and per-operation costs. Usage comes from ctx.quota.usage() when the API meters it. Network docs: https://developers.google.com/youtube/v3/determine_quota_cost Generic route: `/v1/accounts/{accountId}/focus/quota`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-quota-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"resets_at":{"type":"string","description":"Midnight Pacific Time","readOnly":true},"buckets":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"limit":{"type":"integer"},"used":{"type":["null","integer"]},"remaining":{"type":["null","integer"]}}},"readOnly":true},"costs":{"type":"array","items":{"type":"object","properties":{"operation":{"type":"string"},"units":{"type":"integer"},"bucket":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/activities":{"get":{"operationId":"youtubeActivitiesList","summary":"YouTube: List Activity feed","tags":["Focus · YouTube"],"description":"Channel activities · quota: 1 unit (activities.list). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/activities/list Generic route: `/v1/accounts/{accountId}/focus/activities`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"published_after","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"published_before","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-activities-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","readOnly":true},"title":{"type":"string","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"video_id":{"type":["null","string"],"readOnly":true},"playlist_id":{"type":["null","string"],"readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/videos":{"get":{"operationId":"youtubeVideosList","summary":"YouTube: List Videos","tags":["Focus · YouTube"],"description":"List uploads (uploads playlist + videos.list per page; q= uses search.list) · quota: 2 units (playlistItems.list, videos.list). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["all","public","unlisted","private","scheduled","shorts","videos","live","processing","failed"],"default":"all"},"in":"query","name":"filter","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false,"description":"Search own videos (uses the 100/day search bucket)"},{"schema":{"type":"string","enum":["date","rating","relevance","title","viewCount"]},"in":"query","name":"order","required":false},{"schema":{"type":"integer","minimum":1,"maximum":10,"default":1},"in":"query","name":"scan_pages","required":false,"description":"Scan several pages for sparse filters"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeVideosCreate","summary":"YouTube: Create a Videos item","tags":["Focus · YouTube"],"description":"Upload a video (resumable) + optional thumbnail/playlists/captions/first comment · quota: 1 videos.insert bucket (videos.insert). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string","description":"Video file (≤256 GB / 12 h)"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"privacy_status":{"type":"string","enum":["public","unlisted","private"],"default":"private"},"publish_at":{"type":"string","format":"date-time","description":"Schedule: uploads as private, released publicly at this time"},"self_declared_made_for_kids":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string","maxLength":100}},"category_id":{"type":"string","default":"22"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean","default":true},"public_stats_viewable":{"type":"boolean","default":true},"notify_subscribers":{"type":"boolean","default":true},"recording_date":{"type":"string","format":"date-time"},"is_short":{"type":"boolean","description":"Override Shorts detection"},"add_shorts_hashtag":{"type":"boolean","default":false},"thumbnail":{"type":"string"},"playlist_ids":{"type":"array","items":{"type":"string"}},"captions":{"type":"array","items":{"type":"object","properties":{"media":{"type":"string"},"language":{"type":"string"},"name":{"type":"string","maxLength":150},"is_draft":{"type":"boolean"}}}},"first_comment":{"type":"string","maxLength":10000}},"required":["media","title","privacy_status","self_declared_made_for_kids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-create","x-idempotent":true,"x-zernio":["POST /v1/posts/{postId}/update-metadata","POST /v1/posts/{postId}/edit","POST /v1/posts/{postId}/unpublish","POST /v1/inbox/posts/{postId}/like"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/videos/{itemId}":{"get":{"operationId":"youtubeVideosGet","summary":"YouTube: Get a Videos item","tags":["Focus · YouTube"],"description":"Video details (all owner parts) · quota: 1 unit (videos.list). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"youtubeVideosUpdate","summary":"YouTube: Update a Videos item","tags":["Focus · YouTube"],"description":"Update metadata (read-modify-write) · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"tags":{"type":"array","items":{"type":"string","maxLength":100}},"category_id":{"type":"string"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["string","null"],"format":"date-time"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["string","null"],"format":"date-time"},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"},"brand_partner":{"type":"object","properties":{"channel_id":{"type":"string","pattern":"^UC"},"channel_handle":{"type":"string","pattern":"^@"}}},"thumbnail":{"type":"string","description":"New custom thumbnail (JPEG/PNG ≤50 MB)"},"playlist_id":{"type":"string","description":"Also add to this playlist"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeVideosDelete","summary":"YouTube: Delete a Videos item","tags":["Focus · YouTube"],"description":"Delete permanently · quota: 50 units (videos.delete). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-delete","x-zernio":["DELETE /v1/inbox/posts/{postId}/like"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/videos/{itemId}/rate":{"post":{"operationId":"youtubeVideosRate","summary":"YouTube: Rate (Videos)","tags":["Focus · YouTube"],"description":"Like, dislike or clear rating · quota: 50 units (videos.rate). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rating":{"type":"string","enum":["like","dislike","none"]}},"required":["rating"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-rate","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/videos/{itemId}/rating":{"post":{"operationId":"youtubeVideosRating","summary":"YouTube: My rating (Videos)","tags":["Focus · YouTube"],"description":"Read the channel’s rating · quota: 1 unit (videos.getRating). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-rating","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/videos/{itemId}/set-thumbnail":{"post":{"operationId":"youtubeVideosSetThumbnail","summary":"YouTube: Set thumbnail (Videos)","tags":["Focus · YouTube"],"description":"Upload a custom thumbnail (JPEG/PNG ≤50 MB) · quota: 50 units (thumbnails.set). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string"}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-set-thumbnail","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/videos/{itemId}/add-to-playlist":{"post":{"operationId":"youtubeVideosAddToPlaylist","summary":"YouTube: Add to playlist (Videos)","tags":["Focus · YouTube"],"description":"Insert into a playlist · quota: 50 units (playlistItems.insert). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"playlist_id":{"type":"string"},"position":{"type":"integer","minimum":0},"note":{"type":"string"}},"required":["playlist_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-add-to-playlist","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/videos/{itemId}/set-visibility":{"post":{"operationId":"youtubeVideosSetVisibility","summary":"YouTube: Change visibility (Videos)","tags":["Focus · YouTube"],"description":"Set privacy (clears schedule unless private) · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"privacy_status":{"type":"string","enum":["public","unlisted","private"]}},"required":["privacy_status"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-set-visibility","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/videos/{itemId}/publish-now":{"post":{"operationId":"youtubeVideosPublishNow","summary":"YouTube: Publish now (Videos)","tags":["Focus · YouTube"],"description":"Make public immediately · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-publish-now","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/videos/{itemId}/schedule":{"post":{"operationId":"youtubeVideosSchedule","summary":"YouTube: Schedule (Videos)","tags":["Focus · YouTube"],"description":"Set status.publishAt (video becomes private until then) · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"publish_at":{"type":"string","format":"date-time"}},"required":["publish_at"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-schedule","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/videos/{itemId}/processing-status":{"post":{"operationId":"youtubeVideosProcessingStatus","summary":"YouTube: Processing status (Videos)","tags":["Focus · YouTube"],"description":"Upload/processing state, failure and rejection reasons · quota: 1 unit (videos.list). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: `/v1/accounts/{accountId}/focus/videos`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-videos-processing-status","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/shorts":{"get":{"operationId":"youtubeShortsList","summary":"YouTube: List Shorts","tags":["Focus · YouTube"],"description":"List Shorts (scans 3 upload pages by default) · quota: 2 units (playlistItems.list, videos.list). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: `/v1/accounts/{accountId}/focus/shorts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":10,"default":3},"in":"query","name":"scan_pages","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-shorts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeShortsCreate","summary":"YouTube: Create a Shorts item","tags":["Focus · YouTube"],"description":"Upload a Short (vertical, ≤3 min) · quota: 1 videos.insert bucket (videos.insert). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: `/v1/accounts/{accountId}/focus/shorts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string","description":"Video file (≤256 GB / 12 h)"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"privacy_status":{"type":"string","enum":["public","unlisted","private"],"default":"private"},"publish_at":{"type":"string","format":"date-time","description":"Schedule: uploads as private, released publicly at this time"},"self_declared_made_for_kids":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string","maxLength":100}},"category_id":{"type":"string","default":"22"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean","default":true},"public_stats_viewable":{"type":"boolean","default":true},"notify_subscribers":{"type":"boolean","default":true},"recording_date":{"type":"string","format":"date-time"},"is_short":{"type":"boolean","description":"Override Shorts detection"},"add_shorts_hashtag":{"type":"boolean","default":false},"thumbnail":{"type":"string"},"playlist_ids":{"type":"array","items":{"type":"string"}},"captions":{"type":"array","items":{"type":"object","properties":{"media":{"type":"string"},"language":{"type":"string"},"name":{"type":"string","maxLength":150},"is_draft":{"type":"boolean"}}}},"first_comment":{"type":"string","maxLength":10000}},"required":["media","title","privacy_status","self_declared_made_for_kids"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-shorts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/shorts/{itemId}":{"get":{"operationId":"youtubeShortsGet","summary":"YouTube: Get a Shorts item","tags":["Focus · YouTube"],"description":"Video details (all owner parts) · quota: 1 unit (videos.list). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: `/v1/accounts/{accountId}/focus/shorts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-shorts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"youtubeShortsUpdate","summary":"YouTube: Update a Shorts item","tags":["Focus · YouTube"],"description":"Update metadata (read-modify-write) · quota: 51 units (videos.list, videos.update). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: `/v1/accounts/{accountId}/focus/shorts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"tags":{"type":"array","items":{"type":"string","maxLength":100}},"category_id":{"type":"string"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["string","null"],"format":"date-time"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["string","null"],"format":"date-time"},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"},"brand_partner":{"type":"object","properties":{"channel_id":{"type":"string","pattern":"^UC"},"channel_handle":{"type":"string","pattern":"^@"}}},"thumbnail":{"type":"string","description":"New custom thumbnail (JPEG/PNG ≤50 MB)"},"playlist_id":{"type":"string","description":"Also add to this playlist"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-shorts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeShortsDelete","summary":"YouTube: Delete a Shorts item","tags":["Focus · YouTube"],"description":"Delete permanently · quota: 50 units (videos.delete). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: `/v1/accounts/{accountId}/focus/shorts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-shorts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/shorts/{itemId}/rate":{"post":{"operationId":"youtubeShortsRate","summary":"YouTube: Rate (Shorts)","tags":["Focus · YouTube"],"description":"Like, dislike or clear rating · quota: 50 units (videos.rate). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: `/v1/accounts/{accountId}/focus/shorts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rating":{"type":"string","enum":["like","dislike","none"]}},"required":["rating"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-shorts-rate","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/shorts/{itemId}/add-to-playlist":{"post":{"operationId":"youtubeShortsAddToPlaylist","summary":"YouTube: Add to playlist (Shorts)","tags":["Focus · YouTube"],"description":"Insert into a playlist · quota: 50 units (playlistItems.insert). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: `/v1/accounts/{accountId}/focus/shorts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"playlist_id":{"type":"string"},"position":{"type":"integer","minimum":0},"note":{"type":"string"}},"required":["playlist_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-shorts-add-to-playlist","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/shorts/{itemId}/set-visibility":{"post":{"operationId":"youtubeShortsSetVisibility","summary":"YouTube: Change visibility (Shorts)","tags":["Focus · YouTube"],"description":"Set privacy (clears schedule unless private) · quota: 51 units (videos.list, videos.update). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: `/v1/accounts/{accountId}/focus/shorts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"privacy_status":{"type":"string","enum":["public","unlisted","private"]}},"required":["privacy_status"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-shorts-set-visibility","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/shorts/{itemId}/schedule":{"post":{"operationId":"youtubeShortsSchedule","summary":"YouTube: Schedule (Shorts)","tags":["Focus · YouTube"],"description":"Set status.publishAt (video becomes private until then) · quota: 51 units (videos.list, videos.update). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: `/v1/accounts/{accountId}/focus/shorts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"publish_at":{"type":"string","format":"date-time"}},"required":["publish_at"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-shorts-schedule","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/scheduled":{"get":{"operationId":"youtubeScheduledList","summary":"YouTube: List Scheduled","tags":["Focus · YouTube"],"description":"Scheduled videos (scans up to 4 upload pages) · quota: 2 units (playlistItems.list, videos.list). Private videos with status.publishAt — the native YouTube schedule. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":10,"default":4},"in":"query","name":"scan_pages","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-scheduled-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/scheduled/{itemId}":{"get":{"operationId":"youtubeScheduledGet","summary":"YouTube: Get a Scheduled item","tags":["Focus · YouTube"],"description":"Video details (all owner parts) · quota: 1 unit (videos.list). Private videos with status.publishAt — the native YouTube schedule. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-scheduled-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"youtubeScheduledUpdate","summary":"YouTube: Update a Scheduled item","tags":["Focus · YouTube"],"description":"Reschedule / edit · quota: 51 units (videos.list, videos.update). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"tags":{"type":"array","items":{"type":"string","maxLength":100}},"category_id":{"type":"string"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["string","null"],"format":"date-time"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["string","null"],"format":"date-time"},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"},"brand_partner":{"type":"object","properties":{"channel_id":{"type":"string","pattern":"^UC"},"channel_handle":{"type":"string","pattern":"^@"}}},"thumbnail":{"type":"string","description":"New custom thumbnail (JPEG/PNG ≤50 MB)"},"playlist_id":{"type":"string","description":"Also add to this playlist"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-scheduled-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000,"description":"≤5000 bytes"},"tags":{"type":"array","items":{"type":"string","maxLength":100},"description":"≤500 characters in total"},"category_id":{"type":"string","description":"See video-categories"},"default_language":{"type":"string"},"default_audio_language":{"type":"string"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"publish_at":{"type":["null","string"],"format":"date-time","description":"Scheduled release (video must be private and never published)"},"is_scheduled":{"type":"boolean","readOnly":true},"self_declared_made_for_kids":{"type":"boolean","description":"Made for kids (COPPA)"},"made_for_kids":{"type":"boolean","readOnly":true},"contains_synthetic_media":{"type":"boolean","description":"Altered or synthetic content"},"has_paid_product_placement":{"type":"boolean","description":"Includes paid promotion"},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"recording_date":{"type":["null","string"],"format":"date-time"},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"upload_status":{"type":"string","enum":["uploaded","processed","failed","rejected","deleted"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"rejection_reason":{"type":["null","string"],"readOnly":true},"processing_status":{"type":["null","string"],"readOnly":true},"duration_seconds":{"type":["null","integer"],"readOnly":true},"definition":{"type":["null","string"],"readOnly":true},"caption":{"type":["null","boolean"],"readOnly":true},"has_custom_thumbnail":{"type":["null","boolean"],"readOnly":true},"is_short":{"type":["null","boolean"],"description":"Heuristic: vertical/square and ≤180 s","readOnly":true},"is_live":{"type":"boolean","readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"like_count":{"type":["null","integer"],"readOnly":true},"comment_count":{"type":["null","integer"],"readOnly":true},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true},"studio_url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeScheduledDelete","summary":"YouTube: Delete a Scheduled item","tags":["Focus · YouTube"],"description":"Delete permanently · quota: 50 units (videos.delete). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-scheduled-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/scheduled/{itemId}/publish-now":{"post":{"operationId":"youtubeScheduledPublishNow","summary":"YouTube: Publish now (Scheduled)","tags":["Focus · YouTube"],"description":"Make public immediately · quota: 51 units (videos.list, videos.update). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-scheduled-publish-now","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/scheduled/{itemId}/unschedule":{"post":{"operationId":"youtubeScheduledUnschedule","summary":"YouTube: Unschedule (Scheduled)","tags":["Focus · YouTube"],"description":"Keep private, clear publishAt · quota: 51 units (videos.list, videos.update). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: `/v1/accounts/{accountId}/focus/scheduled`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-scheduled-unschedule","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/video-localizations":{"get":{"operationId":"youtubeVideoLocalizationsList","summary":"YouTube: List Translations","tags":["Focus · YouTube"],"description":"List translations of a video · quota: 1 unit (videos.list). Per-language video title & description (videos.localizations). Needs the video default language. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: `/v1/accounts/{accountId}/focus/video-localizations`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"video_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-video-localizations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"<videoId>~<language>","readOnly":true},"video_id":{"type":"string"},"language":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["video_id","language","title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeVideoLocalizationsCreate","summary":"YouTube: Create a Translations item","tags":["Focus · YouTube"],"description":"Add a translation · quota: 52 units (videos.list, videos.update). Per-language video title & description (videos.localizations). Needs the video default language. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: `/v1/accounts/{accountId}/focus/video-localizations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"language":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string"},"default_language":{"type":"string","description":"Set the video default language if missing"}},"required":["video_id","language","title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-video-localizations-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"<videoId>~<language>","readOnly":true},"video_id":{"type":"string"},"language":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["video_id","language","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/video-localizations/{itemId}":{"patch":{"operationId":"youtubeVideoLocalizationsUpdate","summary":"YouTube: Update a Translations item","tags":["Focus · YouTube"],"description":"Edit a translation · quota: 52 units (videos.list, videos.update). Per-language video title & description (videos.localizations). Needs the video default language. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: `/v1/accounts/{accountId}/focus/video-localizations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-video-localizations-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"<videoId>~<language>","readOnly":true},"video_id":{"type":"string"},"language":{"type":"string"},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["video_id","language","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeVideoLocalizationsDelete","summary":"YouTube: Delete a Translations item","tags":["Focus · YouTube"],"description":"Remove a translation · quota: 52 units (videos.list, videos.update). Per-language video title & description (videos.localizations). Needs the video default language. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: `/v1/accounts/{accountId}/focus/video-localizations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-video-localizations-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/captions":{"get":{"operationId":"youtubeCaptionsList","summary":"YouTube: List Subtitles","tags":["Focus · YouTube"],"description":"List tracks of a video · quota: 50 units (captions.list). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: `/v1/accounts/{accountId}/focus/captions`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"video_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-captions-list","x-zernio":["GET /v1/accounts/{accountId}/youtube-captions"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"video_id":{"type":"string"},"language":{"type":"string"},"name":{"type":"string","maxLength":150},"track_kind":{"type":"string","enum":["standard","asr","forced"],"readOnly":true},"audio_track_type":{"type":["null","string"],"readOnly":true},"is_draft":{"type":"boolean"},"is_cc":{"type":["null","boolean"],"readOnly":true},"is_auto_synced":{"type":["null","boolean"],"readOnly":true},"status":{"type":"string","enum":["serving","syncing","failed"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"last_updated":{"type":"string","format":"date-time","readOnly":true}},"required":["video_id","language"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeCaptionsCreate","summary":"YouTube: Create a Subtitles item","tags":["Focus · YouTube"],"description":"Upload a caption track · quota: 400 units (captions.insert). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: `/v1/accounts/{accountId}/focus/captions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"language":{"type":"string"},"name":{"type":"string","maxLength":150},"is_draft":{"type":"boolean","default":false},"media":{"type":"string"},"text":{"type":"string","description":"Or paste the caption file content"}},"required":["video_id","language"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-captions-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"video_id":{"type":"string"},"language":{"type":"string"},"name":{"type":"string","maxLength":150},"track_kind":{"type":"string","enum":["standard","asr","forced"],"readOnly":true},"audio_track_type":{"type":["null","string"],"readOnly":true},"is_draft":{"type":"boolean"},"is_cc":{"type":["null","boolean"],"readOnly":true},"is_auto_synced":{"type":["null","boolean"],"readOnly":true},"status":{"type":"string","enum":["serving","syncing","failed"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"last_updated":{"type":"string","format":"date-time","readOnly":true}},"required":["video_id","language"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/captions/{itemId}":{"patch":{"operationId":"youtubeCaptionsUpdate","summary":"YouTube: Update a Subtitles item","tags":["Focus · YouTube"],"description":"Toggle draft and/or replace the file · quota: 450 units (captions.update). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: `/v1/accounts/{accountId}/focus/captions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"is_draft":{"type":"boolean"},"media":{"type":"string"},"text":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-captions-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"video_id":{"type":"string"},"language":{"type":"string"},"name":{"type":"string","maxLength":150},"track_kind":{"type":"string","enum":["standard","asr","forced"],"readOnly":true},"audio_track_type":{"type":["null","string"],"readOnly":true},"is_draft":{"type":"boolean"},"is_cc":{"type":["null","boolean"],"readOnly":true},"is_auto_synced":{"type":["null","boolean"],"readOnly":true},"status":{"type":"string","enum":["serving","syncing","failed"],"readOnly":true},"failure_reason":{"type":["null","string"],"readOnly":true},"last_updated":{"type":"string","format":"date-time","readOnly":true}},"required":["video_id","language"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeCaptionsDelete","summary":"YouTube: Delete a Subtitles item","tags":["Focus · YouTube"],"description":"Delete a track · quota: 50 units (captions.delete). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: `/v1/accounts/{accountId}/focus/captions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-captions-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/captions/{itemId}/download":{"post":{"operationId":"youtubeCaptionsDownload","summary":"YouTube: Download (Subtitles)","tags":["Focus · YouTube"],"description":"Download (convert tfmt, machine-translate tlang) · quota: 200 units (captions.download). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: `/v1/accounts/{accountId}/focus/captions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tfmt":{"type":"string","enum":["sbv","scc","srt","ttml","vtt"]},"tlang":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-captions-download","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/captions/transcript":{"post":{"operationId":"youtubeCaptionsTranscript","summary":"YouTube: Transcript (Subtitles)","tags":["Focus · YouTube"],"description":"Zernio-style transcript: cues + text · quota: 250 units (captions.list, captions.download). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: `/v1/accounts/{accountId}/focus/captions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"language":{"type":"string"},"format":{"type":"string","enum":["json","srt","vtt"],"default":"json"},"track_id":{"type":"string"},"tlang":{"type":"string"}},"required":["video_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-captions-transcript","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/search":{"get":{"operationId":"youtubeSearchList","summary":"YouTube: List Search","tags":["Focus · YouTube"],"description":"Search · quota: 1 search.list bucket (search.list). search.list — own content (for_mine) or public. Uses the separate 100 calls/day bucket. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/search/list Generic route: `/v1/accounts/{accountId}/focus/search`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"q","required":false},{"schema":{"type":"boolean","default":true},"in":"query","name":"for_mine","required":false},{"schema":{"type":"string"},"in":"query","name":"channel_id","required":false},{"schema":{"type":"string","enum":["video","channel","playlist"],"default":"video"},"in":"query","name":"type","required":false},{"schema":{"type":"string","enum":["date","rating","relevance","title","videoCount","viewCount"]},"in":"query","name":"order","required":false},{"schema":{"type":"string","enum":["completed","live","upcoming"]},"in":"query","name":"event_type","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"published_after","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"published_before","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-search-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"kind":{"type":"string","readOnly":true},"title":{"type":"string","readOnly":true},"description":{"type":"string","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"channel_id":{"type":"string","readOnly":true},"channel_title":{"type":"string","readOnly":true},"thumbnail_url":{"type":"string","format":"uri","readOnly":true},"live_broadcast_content":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/playlists":{"get":{"operationId":"youtubePlaylistsList","summary":"YouTube: List Playlists","tags":["Focus · YouTube"],"description":"List playlists (+ default flag) · quota: 1 unit (playlists.list). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: `/v1/accounts/{accountId}/focus/playlists`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlists-list","x-zernio":["GET /v1/accounts/{accountId}/youtube-playlists"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":150},"description":{"type":"string","maxLength":5000},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"item_count":{"type":["null","integer"],"readOnly":true},"default_language":{"type":["null","string"]},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"podcast_status":{"type":["null","string"],"readOnly":true},"is_default":{"type":"boolean","description":"Socialit default playlist (UI prefill only)","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubePlaylistsCreate","summary":"YouTube: Create a Playlists item","tags":["Focus · YouTube"],"description":"Create playlist (not idempotent) · quota: 50 units (playlists.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: `/v1/accounts/{accountId}/focus/playlists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":150},"description":{"type":"string","maxLength":5000},"privacy_status":{"type":"string","enum":["public","unlisted","private"],"default":"private"},"default_language":{"type":"string"},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"}},"required":["title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlists-create","x-idempotent":true,"x-zernio":["POST /v1/accounts/{accountId}/youtube-playlists"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":150},"description":{"type":"string","maxLength":5000},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"item_count":{"type":["null","integer"],"readOnly":true},"default_language":{"type":["null","string"]},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"podcast_status":{"type":["null","string"],"readOnly":true},"is_default":{"type":"boolean","description":"Socialit default playlist (UI prefill only)","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/playlists/{itemId}":{"get":{"operationId":"youtubePlaylistsGet","summary":"YouTube: Get a Playlists item","tags":["Focus · YouTube"],"description":"Playlist details · quota: 1 unit (playlists.list). Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: `/v1/accounts/{accountId}/focus/playlists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlists-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":150},"description":{"type":"string","maxLength":5000},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"item_count":{"type":["null","integer"],"readOnly":true},"default_language":{"type":["null","string"]},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"podcast_status":{"type":["null","string"],"readOnly":true},"is_default":{"type":"boolean","description":"Socialit default playlist (UI prefill only)","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"youtubePlaylistsUpdate","summary":"YouTube: Update a Playlists item","tags":["Focus · YouTube"],"description":"Edit playlist · quota: 51 units (playlists.list, playlists.update). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: `/v1/accounts/{accountId}/focus/playlists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":150},"description":{"type":"string","maxLength":5000},"privacy_status":{"type":"string","enum":["public","unlisted","private"],"default":"private"},"default_language":{"type":"string"},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlists-update","x-zernio":["PUT /v1/accounts/{accountId}/youtube-playlists"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":150},"description":{"type":"string","maxLength":5000},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"item_count":{"type":["null","integer"],"readOnly":true},"default_language":{"type":["null","string"]},"localizations":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000}}},"description":"BCP-47 language → { title, description }"},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"podcast_status":{"type":["null","string"],"readOnly":true},"is_default":{"type":"boolean","description":"Socialit default playlist (UI prefill only)","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubePlaylistsDelete","summary":"YouTube: Delete a Playlists item","tags":["Focus · YouTube"],"description":"Delete playlist · quota: 50 units (playlists.delete). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: `/v1/accounts/{accountId}/focus/playlists`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlists-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/playlists/{itemId}/set-default":{"post":{"operationId":"youtubePlaylistsSetDefault","summary":"YouTube: Set as default (Playlists)","tags":["Focus · YouTube"],"description":"Default playlist for the composer (stored on the account; validated) · quota: 1 unit (playlists.list). Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: `/v1/accounts/{accountId}/focus/playlists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlists-set-default","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/playlists/{itemId}/add-video":{"post":{"operationId":"youtubePlaylistsAddVideo","summary":"YouTube: Add video (Playlists)","tags":["Focus · YouTube"],"description":"Insert a video · quota: 50 units (playlistItems.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: `/v1/accounts/{accountId}/focus/playlists`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"position":{"type":"integer","minimum":0},"note":{"type":"string","maxLength":280}},"required":["video_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlists-add-video","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/playlist-items":{"get":{"operationId":"youtubePlaylistItemsList","summary":"YouTube: List Playlist items","tags":["Focus · YouTube"],"description":"Items of a playlist · quota: 1 unit (playlistItems.list). Videos in a playlist: add, reorder (position), note, remove. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: `/v1/accounts/{accountId}/focus/playlist-items`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlist-items-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"playlist_id":{"type":"string"},"video_id":{"type":"string"},"title":{"type":"string","readOnly":true},"position":{"type":"integer","minimum":0},"note":{"type":["null","string"],"maxLength":280},"start_at":{"type":["null","string"]},"end_at":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"video_published_at":{"type":["null","string"],"format":"date-time","readOnly":true},"added_at":{"type":"string","format":"date-time","readOnly":true},"privacy_status":{"type":["null","string"],"readOnly":true},"video_owner_channel_title":{"type":["null","string"],"readOnly":true}},"required":["playlist_id","video_id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubePlaylistItemsCreate","summary":"YouTube: Create a Playlist items item","tags":["Focus · YouTube"],"description":"Add a video · quota: 50 units (playlistItems.insert). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: `/v1/accounts/{accountId}/focus/playlist-items`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"playlist_id":{"type":"string"},"video_id":{"type":"string"},"position":{"type":"integer","minimum":0},"note":{"type":"string","maxLength":280}},"required":["playlist_id","video_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlist-items-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"playlist_id":{"type":"string"},"video_id":{"type":"string"},"title":{"type":"string","readOnly":true},"position":{"type":"integer","minimum":0},"note":{"type":["null","string"],"maxLength":280},"start_at":{"type":["null","string"]},"end_at":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"video_published_at":{"type":["null","string"],"format":"date-time","readOnly":true},"added_at":{"type":"string","format":"date-time","readOnly":true},"privacy_status":{"type":["null","string"],"readOnly":true},"video_owner_channel_title":{"type":["null","string"],"readOnly":true}},"required":["playlist_id","video_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/playlist-items/{itemId}":{"patch":{"operationId":"youtubePlaylistItemsUpdate","summary":"YouTube: Update a Playlist items item","tags":["Focus · YouTube"],"description":"Reorder / edit note · quota: 51 units (playlistItems.list, playlistItems.update). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: `/v1/accounts/{accountId}/focus/playlist-items`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"position":{"type":"integer","minimum":0},"note":{"type":"string","maxLength":280},"playlist_id":{"type":"string"},"video_id":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlist-items-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"playlist_id":{"type":"string"},"video_id":{"type":"string"},"title":{"type":"string","readOnly":true},"position":{"type":"integer","minimum":0},"note":{"type":["null","string"],"maxLength":280},"start_at":{"type":["null","string"]},"end_at":{"type":["null","string"]},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"video_published_at":{"type":["null","string"],"format":"date-time","readOnly":true},"added_at":{"type":"string","format":"date-time","readOnly":true},"privacy_status":{"type":["null","string"],"readOnly":true},"video_owner_channel_title":{"type":["null","string"],"readOnly":true}},"required":["playlist_id","video_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubePlaylistItemsDelete","summary":"YouTube: Delete a Playlist items item","tags":["Focus · YouTube"],"description":"Remove from playlist · quota: 50 units (playlistItems.delete). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: `/v1/accounts/{accountId}/focus/playlist-items`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlist-items-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/playlist-items/{itemId}/move":{"post":{"operationId":"youtubePlaylistItemsMove","summary":"YouTube: Move (Playlist items)","tags":["Focus · YouTube"],"description":"Move to a position (0-based) · quota: 51 units (playlistItems.list, playlistItems.update). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: `/v1/accounts/{accountId}/focus/playlist-items`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"position":{"type":"integer","minimum":0}},"required":["position"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlist-items-move","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/playlist-images":{"get":{"operationId":"youtubePlaylistImagesList","summary":"YouTube: List Playlist images","tags":["Focus · YouTube"],"description":"Images of a playlist · quota: 1 unit (playlistImages.list). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: `/v1/accounts/{accountId}/focus/playlist-images`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlist-images-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"playlist_id":{"type":"string"},"type":{"type":"string","default":"hero"},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true}},"required":["playlist_id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubePlaylistImagesCreate","summary":"YouTube: Create a Playlist images item","tags":["Focus · YouTube"],"description":"Upload image · quota: 50 units (playlistImages.insert). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: `/v1/accounts/{accountId}/focus/playlist-images`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"playlist_id":{"type":"string"},"media":{"type":"string"},"type":{"type":"string","default":"hero"}},"required":["playlist_id","media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlist-images-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"playlist_id":{"type":"string"},"type":{"type":"string","default":"hero"},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true}},"required":["playlist_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/playlist-images/{itemId}":{"patch":{"operationId":"youtubePlaylistImagesUpdate","summary":"YouTube: Update a Playlist images item","tags":["Focus · YouTube"],"description":"Replace image · quota: 50 units (playlistImages.update). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: `/v1/accounts/{accountId}/focus/playlist-images`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"playlist_id":{"type":"string"},"media":{"type":"string"},"type":{"type":"string"}},"required":["playlist_id","media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlist-images-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"playlist_id":{"type":"string"},"type":{"type":"string","default":"hero"},"width":{"type":["null","integer"],"readOnly":true},"height":{"type":["null","integer"],"readOnly":true}},"required":["playlist_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubePlaylistImagesDelete","summary":"YouTube: Delete a Playlist images item","tags":["Focus · YouTube"],"description":"Delete image · quota: 50 units (playlistImages.delete). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: `/v1/accounts/{accountId}/focus/playlist-images`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-playlist-images-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-overview":{"get":{"operationId":"youtubeAnalyticsOverviewGet","summary":"YouTube: Get Overview","tags":["Focus · YouTube"],"description":"Overview (daily + totals + cards + content types + channel insights) · quota: 6 analytics queries (analytics.reports.query). Views, watch time, subscribers, engagement — daily series + period totals + Shorts/long-form split. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/reports/query Generic route: `/v1/accounts/{accountId}/focus/analytics-overview`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string","enum":["day","month"],"default":"day"},"in":"query","name":"granularity","required":false},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-overview-get","x-zernio":["GET /v1/analytics/youtube/channel-insights"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","readOnly":true},"until":{"type":"string","readOnly":true},"totals":{"type":"object","properties":{},"additionalProperties":{"type":"number"},"description":"Normalized metrics","readOnly":true},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}},"readOnly":true},"youtube_totals":{"type":"object","properties":{},"additionalProperties":true,"description":"YouTube-named totals","readOnly":true},"youtube_series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":true}}},"readOnly":true},"content_types":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"readOnly":true},"insights":{"type":"object","properties":{},"additionalProperties":true,"description":"Zernio channel-insights shape","readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":true,"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-reach":{"get":{"operationId":"youtubeAnalyticsReachGet","summary":"YouTube: Get Reach","tags":["Focus · YouTube"],"description":"Reach: traffic_sources, traffic_sources_daily, search_terms, external_sites, playback_locations, embedded_sites, impressions · quota: 7 analytics queries (analytics.reports.query). Traffic sources, YouTube search terms, external sites, playback locations; thumbnail impressions/CTR via the Reporting API reach job. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: `/v1/accounts/{accountId}/focus/analytics-reach`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false,"description":"Filter to one video"},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string"},"in":"query","name":"group_id","required":false,"description":"Analytics group"},{"schema":{"type":"string"},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2"},{"schema":{"type":"string","enum":["SHORTS","VIDEO_ON_DEMAND","LIVE_STREAM","STORY"]},"in":"query","name":"creator_content_type","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"include_impressions","required":false,"description":"Read channel_reach_basic_a1 bulk reports"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-reach-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","readOnly":true},"until":{"type":"string","format":"date","readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"report":{"type":"string"},"label":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["dimension","metric"]},"data_type":{"type":["null","string"]}}}},"rows":{"type":"array","items":{"type":"array","items":{}}},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}}}}},"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"code":{"type":["null","string"]},"message":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-engagement":{"get":{"operationId":"youtubeAnalyticsEngagementGet","summary":"YouTube: Get Engagement","tags":["Focus · YouTube"],"description":"Engagement: engagement, watch_time, top_videos, subscribers_by_video, sharing_services, cards, engaged_views · quota: 7 analytics queries (analytics.reports.query). Likes, comments, shares, playlist adds, subscribers per video, cards, sharing services, top videos. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: `/v1/accounts/{accountId}/focus/analytics-engagement`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false,"description":"Filter to one video"},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string"},"in":"query","name":"group_id","required":false,"description":"Analytics group"},{"schema":{"type":"string"},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2"},{"schema":{"type":"string","enum":["SHORTS","VIDEO_ON_DEMAND","LIVE_STREAM","STORY"]},"in":"query","name":"creator_content_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-engagement-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","readOnly":true},"until":{"type":"string","format":"date","readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"report":{"type":"string"},"label":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["dimension","metric"]},"data_type":{"type":["null","string"]}}}},"rows":{"type":"array","items":{"type":"array","items":{}}},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}}}}},"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"code":{"type":["null","string"]},"message":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-audience":{"get":{"operationId":"youtubeAnalyticsAudienceGet","summary":"YouTube: Get Audience","tags":["Focus · YouTube"],"description":"Audience: demographics, age, gender, subscribed_status, youtube_products, countries · quota: 6 analytics queries (analytics.reports.query). Age, gender, subscribed vs not, YouTube products, top countries. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: `/v1/accounts/{accountId}/focus/analytics-audience`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false,"description":"Filter to one video"},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string"},"in":"query","name":"group_id","required":false,"description":"Analytics group"},{"schema":{"type":"string"},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2"},{"schema":{"type":"string","enum":["SHORTS","VIDEO_ON_DEMAND","LIVE_STREAM","STORY"]},"in":"query","name":"creator_content_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-audience-get","x-zernio":["GET /v1/analytics/youtube/demographics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","readOnly":true},"until":{"type":"string","format":"date","readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"report":{"type":"string"},"label":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["dimension","metric"]},"data_type":{"type":["null","string"]}}}},"rows":{"type":"array","items":{"type":"array","items":{}}},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}}}}},"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"code":{"type":["null","string"]},"message":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-demographics":{"get":{"operationId":"youtubeAnalyticsDemographicsGet","summary":"YouTube: Get Demographics","tags":["Focus · YouTube"],"description":"Demographics · quota: 3 analytics queries (analytics.reports.query). Zernio-style age/gender (viewer %) and country (views), channel or per video. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: `/v1/accounts/{accountId}/focus/analytics-demographics`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false},{"schema":{"type":"string","default":"age,gender,country"},"in":"query","name":"breakdown","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-demographics-get","x-zernio":["GET /v1/analytics/youtube/demographics"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"demographics":{"type":"object","properties":{"age":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":"number"}}}},"gender":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":"number"}}}},"country":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string"},"value":{"type":"number"}}}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-geography":{"get":{"operationId":"youtubeAnalyticsGeographyGet","summary":"YouTube: Get Geography","tags":["Focus · YouTube"],"description":"Geography: countries, us_states, cities · quota: 3 analytics queries (analytics.reports.query). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: `/v1/accounts/{accountId}/focus/analytics-geography`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false,"description":"Filter to one video"},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string"},"in":"query","name":"group_id","required":false,"description":"Analytics group"},{"schema":{"type":"string"},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2"},{"schema":{"type":"string","enum":["SHORTS","VIDEO_ON_DEMAND","LIVE_STREAM","STORY"]},"in":"query","name":"creator_content_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-geography-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","readOnly":true},"until":{"type":"string","format":"date","readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"report":{"type":"string"},"label":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["dimension","metric"]},"data_type":{"type":["null","string"]}}}},"rows":{"type":"array","items":{"type":"array","items":{}}},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}}}}},"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"code":{"type":["null","string"]},"message":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-devices":{"get":{"operationId":"youtubeAnalyticsDevicesGet","summary":"YouTube: Get Devices","tags":["Focus · YouTube"],"description":"Devices: devices, operating_systems, device_os · quota: 3 analytics queries (analytics.reports.query). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: `/v1/accounts/{accountId}/focus/analytics-devices`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false,"description":"Filter to one video"},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string"},"in":"query","name":"group_id","required":false,"description":"Analytics group"},{"schema":{"type":"string"},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2"},{"schema":{"type":"string","enum":["SHORTS","VIDEO_ON_DEMAND","LIVE_STREAM","STORY"]},"in":"query","name":"creator_content_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-devices-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","readOnly":true},"until":{"type":"string","format":"date","readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"report":{"type":"string"},"label":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["dimension","metric"]},"data_type":{"type":["null","string"]}}}},"rows":{"type":"array","items":{"type":"array","items":{}}},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}}}}},"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"code":{"type":["null","string"]},"message":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-content-types":{"get":{"operationId":"youtubeAnalyticsContentTypesGet","summary":"YouTube: Get Shorts vs videos vs live","tags":["Focus · YouTube"],"description":"Shorts vs videos vs live: content_types, content_types_daily, top_shorts, premium · quota: 4 analytics queries (analytics.reports.query). creatorContentType split, daily, top Shorts, Premium views. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: `/v1/accounts/{accountId}/focus/analytics-content-types`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false,"description":"Filter to one video"},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string"},"in":"query","name":"group_id","required":false,"description":"Analytics group"},{"schema":{"type":"string"},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2"},{"schema":{"type":"string","enum":["SHORTS","VIDEO_ON_DEMAND","LIVE_STREAM","STORY"]},"in":"query","name":"creator_content_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-content-types-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","readOnly":true},"until":{"type":"string","format":"date","readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"report":{"type":"string"},"label":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["dimension","metric"]},"data_type":{"type":["null","string"]}}}},"rows":{"type":"array","items":{"type":"array","items":{}}},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}}}}},"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"code":{"type":["null","string"]},"message":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-video":{"get":{"operationId":"youtubeAnalyticsVideoGet","summary":"YouTube: Get Video analytics","tags":["Focus · YouTube"],"description":"Per-video analytics (Zernio daily-views + more) · quota: 2 units + 4 analytics queries (videos.list, analytics.reports.query). One video: daily views/watch time/engagement, traffic sources, retention, demographics. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/channel_reports#video-reports Generic route: `/v1/accounts/{accountId}/focus/analytics-video`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-video-get","x-zernio":["GET /v1/analytics/youtube/daily-views"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string","readOnly":true},"daily":{"type":"object","properties":{},"additionalProperties":true,"readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":true,"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":true,"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-retention":{"get":{"operationId":"youtubeAnalyticsRetentionGet","summary":"YouTube: Get Audience retention","tags":["Focus · YouTube"],"description":"Retention curve · quota: 1 unit + 1 analytics query (videos.list, analytics.reports.query). audienceWatchRatio by elapsedVideoTimeRatio (100 points), relative retention, started/stopped watching. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/channel_reports#audience-retention-reports Generic route: `/v1/accounts/{accountId}/focus/analytics-retention`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false},{"schema":{"type":"string","enum":["ORGANIC","AD_INSTREAM","AD_INDISPLAY"]},"in":"query","name":"audience_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-retention-get","x-zernio":["GET /v1/analytics/youtube/video-retention"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"videoId":{"type":"string","readOnly":true},"title":{"type":["null","string"],"readOnly":true},"durationSeconds":{"type":["null","integer"],"readOnly":true},"retentionCurve":{"type":"array","items":{"type":"object","properties":{"elapsedVideoTimeRatio":{"type":"number"},"audienceWatchRatio":{"type":["null","number"]},"relativeRetentionPerformance":{"type":["null","number"]},"startedWatching":{"type":["null","number"]},"stoppedWatching":{"type":["null","number"]},"totalSegmentImpressions":{"type":["null","number"]}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-playlists":{"get":{"operationId":"youtubeAnalyticsPlaylistsGet","summary":"YouTube: Get Playlist analytics","tags":["Focus · YouTube"],"description":"Playlist analytics: top_playlists, playlist_daily · quota: 2 analytics queries (analytics.reports.query). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: `/v1/accounts/{accountId}/focus/analytics-playlists`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false,"description":"Filter to one video"},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string"},"in":"query","name":"group_id","required":false,"description":"Analytics group"},{"schema":{"type":"string"},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2"},{"schema":{"type":"string","enum":["SHORTS","VIDEO_ON_DEMAND","LIVE_STREAM","STORY"]},"in":"query","name":"creator_content_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-playlists-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","readOnly":true},"until":{"type":"string","format":"date","readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"report":{"type":"string"},"label":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["dimension","metric"]},"data_type":{"type":["null","string"]}}}},"rows":{"type":"array","items":{"type":"array","items":{}}},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}}}}},"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"code":{"type":["null","string"]},"message":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-live":{"get":{"operationId":"youtubeAnalyticsLiveGet","summary":"YouTube: Get Live analytics","tags":["Focus · YouTube"],"description":"Live analytics: live_vs_on_demand, concurrent, summary · quota: 3 analytics queries (analytics.reports.query). Live vs on-demand; concurrent viewers for a stream (video_id). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: `/v1/accounts/{accountId}/focus/analytics-live`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false,"description":"Filter to one video"},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string"},"in":"query","name":"group_id","required":false,"description":"Analytics group"},{"schema":{"type":"string"},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2"},{"schema":{"type":"string","enum":["SHORTS","VIDEO_ON_DEMAND","LIVE_STREAM","STORY"]},"in":"query","name":"creator_content_type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-live-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","readOnly":true},"until":{"type":"string","format":"date","readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"report":{"type":"string"},"label":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["dimension","metric"]},"data_type":{"type":["null","string"]}}}},"rows":{"type":"array","items":{"type":"array","items":{}}},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}}}}},"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"code":{"type":["null","string"]},"message":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-report":{"get":{"operationId":"youtubeAnalyticsReportGet","summary":"YouTube: Get Report builder","tags":["Focus · YouTube"],"description":"Run a report · quota: 1 analytics query (analytics.reports.query). Any named report (54) or a custom reports.query (metrics/dimensions/filters/sort). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/reports/query Generic route: `/v1/accounts/{accountId}/focus/analytics-report`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false,"description":"Filter to one video"},{"schema":{"type":"string"},"in":"query","name":"playlist_id","required":false},{"schema":{"type":"string"},"in":"query","name":"group_id","required":false,"description":"Analytics group"},{"schema":{"type":"string"},"in":"query","name":"country","required":false,"description":"ISO 3166-1 alpha-2"},{"schema":{"type":"string","enum":["SHORTS","VIDEO_ON_DEMAND","LIVE_STREAM","STORY"]},"in":"query","name":"creator_content_type","required":false},{"schema":{"type":"string","enum":["overview","daily","monthly","engaged-views","engagement","watch-time","subscribers","subscribers-by-video","top-videos","traffic-sources","traffic-sources-daily","traffic-source-detail","search-terms","external-sites","playback-locations","playback-location-detail","devices","operating-systems","device-os","countries","provinces","cities","subscribed-status","sharing-services","demographics","age","gender","retention","content-types","content-types-daily","top-shorts","live-vs-on-demand","live-concurrent","live-summary","youtube-products","top-playlists","playlist-daily","cards","annotations","premium","revenue","revenue-totals","revenue-monthly","revenue-by-video","revenue-by-country","revenue-by-content-type","ad-types","memberships-cancellations","custom","reach","end-screens","bulk","super-chats","realtime"],"default":"daily"},"in":"query","name":"report","required":false},{"schema":{"type":"string"},"in":"query","name":"metrics","required":false,"description":"custom: comma-separated metrics"},{"schema":{"type":"string"},"in":"query","name":"dimensions","required":false},{"schema":{"type":"string"},"in":"query","name":"filters","required":false,"description":"dim==value;dim2==a,b"},{"schema":{"type":"string"},"in":"query","name":"sort","required":false},{"schema":{"type":"integer","minimum":1,"maximum":250},"in":"query","name":"max_results","required":false},{"schema":{"type":"string"},"in":"query","name":"currency","required":false,"description":"ISO 4217 for revenue reports"},{"schema":{"type":"string"},"in":"query","name":"source_type","required":false,"description":"traffic-source-detail: insightTrafficSourceType"},{"schema":{"type":"string"},"in":"query","name":"report_type_id","required":false,"description":"bulk: Reporting API report type"},{"schema":{"type":"boolean"},"in":"query","name":"create_job","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-report-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"report":{"type":"string","readOnly":true},"label":{"type":"string","readOnly":true},"since":{"type":"string","readOnly":true},"until":{"type":"string","readOnly":true},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"},"data_type":{"type":["null","string"]}}},"readOnly":true},"rows":{"type":"array","items":{"type":"array","items":{}},"readOnly":true},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-groups":{"get":{"operationId":"youtubeAnalyticsGroupsList","summary":"YouTube: List Analytics groups","tags":["Focus · YouTube"],"description":"Groups · quota: 1 analytics query (analytics.groups.list). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: `/v1/accounts/{accountId}/focus/analytics-groups`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-groups-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"item_type":{"type":"string","enum":["youtube#video","youtube#playlist","youtube#channel","youtubePartner#asset"]},"item_count":{"type":["null","integer"],"readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true}},"required":["title","item_type"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeAnalyticsGroupsCreate","summary":"YouTube: Create a Analytics groups item","tags":["Focus · YouTube"],"description":"Create group · quota: 1 analytics query (analytics.groups.insert). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: `/v1/accounts/{accountId}/focus/analytics-groups`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"item_type":{"type":"string","enum":["youtube#video","youtube#playlist","youtube#channel","youtubePartner#asset"],"default":"youtube#video"}},"required":["title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-groups-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"item_type":{"type":"string","enum":["youtube#video","youtube#playlist","youtube#channel","youtubePartner#asset"]},"item_count":{"type":["null","integer"],"readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true}},"required":["title","item_type"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-groups/{itemId}":{"get":{"operationId":"youtubeAnalyticsGroupsGet","summary":"YouTube: Get a Analytics groups item","tags":["Focus · YouTube"],"description":"Group · quota: 1 analytics query (analytics.groups.list). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: `/v1/accounts/{accountId}/focus/analytics-groups`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-groups-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"item_type":{"type":"string","enum":["youtube#video","youtube#playlist","youtube#channel","youtubePartner#asset"]},"item_count":{"type":["null","integer"],"readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true}},"required":["title","item_type"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"youtubeAnalyticsGroupsUpdate","summary":"YouTube: Update a Analytics groups item","tags":["Focus · YouTube"],"description":"Rename group · quota: 1 analytics query (analytics.groups.update). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: `/v1/accounts/{accountId}/focus/analytics-groups`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"}},"required":["title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-groups-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string"},"item_type":{"type":"string","enum":["youtube#video","youtube#playlist","youtube#channel","youtubePartner#asset"]},"item_count":{"type":["null","integer"],"readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true}},"required":["title","item_type"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeAnalyticsGroupsDelete","summary":"YouTube: Delete a Analytics groups item","tags":["Focus · YouTube"],"description":"Delete group · quota: 1 analytics query (analytics.groups.delete). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: `/v1/accounts/{accountId}/focus/analytics-groups`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-groups-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-groups/{itemId}/add-item":{"post":{"operationId":"youtubeAnalyticsGroupsAddItem","summary":"YouTube: Add item (Analytics groups)","tags":["Focus · YouTube"],"description":"Add a video/playlist/channel · quota: 1 analytics query (analytics.groupItems.insert). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: `/v1/accounts/{accountId}/focus/analytics-groups`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resource_id":{"type":"string"},"kind":{"type":"string","enum":["youtube#video","youtube#playlist","youtube#channel","youtubePartner#asset"],"default":"youtube#video"}},"required":["resource_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-groups-add-item","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-group-items":{"get":{"operationId":"youtubeAnalyticsGroupItemsList","summary":"YouTube: List Group items","tags":["Focus · YouTube"],"description":"Items in a group · quota: 1 analytics query (analytics.groupItems.list). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groupItems Generic route: `/v1/accounts/{accountId}/focus/analytics-group-items`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"group_id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-group-items-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"group_id":{"type":"string"},"kind":{"type":"string","enum":["youtube#video","youtube#playlist","youtube#channel","youtubePartner#asset"]},"resource_id":{"type":"string"}},"required":["group_id","resource_id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeAnalyticsGroupItemsCreate","summary":"YouTube: Create a Group items item","tags":["Focus · YouTube"],"description":"Add item · quota: 1 analytics query (analytics.groupItems.insert). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groupItems Generic route: `/v1/accounts/{accountId}/focus/analytics-group-items`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"group_id":{"type":"string"},"resource_id":{"type":"string"},"kind":{"type":"string","enum":["youtube#video","youtube#playlist","youtube#channel","youtubePartner#asset"],"default":"youtube#video"}},"required":["group_id","resource_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-group-items-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"group_id":{"type":"string"},"kind":{"type":"string","enum":["youtube#video","youtube#playlist","youtube#channel","youtubePartner#asset"]},"resource_id":{"type":"string"}},"required":["group_id","resource_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/analytics-group-items/{itemId}":{"delete":{"operationId":"youtubeAnalyticsGroupItemsDelete","summary":"YouTube: Delete a Group items item","tags":["Focus · YouTube"],"description":"Remove item · quota: 1 analytics query (analytics.groupItems.delete). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groupItems Generic route: `/v1/accounts/{accountId}/focus/analytics-group-items`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-analytics-group-items-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/report-types":{"get":{"operationId":"youtubeReportTypesList","summary":"YouTube: List Bulk report types","tags":["Focus · YouTube"],"description":"Reporting API report types · quota: 1 reporting query (reporting.reportTypes.list). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: `/v1/accounts/{accountId}/focus/report-types`.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"include_system_managed","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-report-types-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true},"system_managed":{"type":"boolean","readOnly":true},"deprecate_time":{"type":["null","string"],"format":"date-time","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/reporting-jobs":{"get":{"operationId":"youtubeReportingJobsList","summary":"YouTube: List Bulk report jobs","tags":["Focus · YouTube"],"description":"Jobs · quota: 1 reporting query (reporting.jobs.list). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: `/v1/accounts/{accountId}/focus/reporting-jobs`.","parameters":[{"schema":{"type":"boolean"},"in":"query","name":"include_system_managed","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-reporting-jobs-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"report_type_id":{"type":"string"},"name":{"type":"string"},"create_time":{"type":"string","format":"date-time","readOnly":true},"expire_time":{"type":["null","string"],"format":"date-time","readOnly":true},"system_managed":{"type":"boolean","readOnly":true}},"required":["report_type_id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeReportingJobsCreate","summary":"YouTube: Create a Bulk report jobs item","tags":["Focus · YouTube"],"description":"Create job · quota: 1 reporting query (reporting.jobs.create). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: `/v1/accounts/{accountId}/focus/reporting-jobs`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"report_type_id":{"type":"string","description":"e.g. channel_reach_basic_a1, channel_basic_a3"},"name":{"type":"string"}},"required":["report_type_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-reporting-jobs-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"report_type_id":{"type":"string"},"name":{"type":"string"},"create_time":{"type":"string","format":"date-time","readOnly":true},"expire_time":{"type":["null","string"],"format":"date-time","readOnly":true},"system_managed":{"type":"boolean","readOnly":true}},"required":["report_type_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/reporting-jobs/{itemId}":{"delete":{"operationId":"youtubeReportingJobsDelete","summary":"YouTube: Delete a Bulk report jobs item","tags":["Focus · YouTube"],"description":"Delete job · quota: 1 reporting query (reporting.jobs.delete). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: `/v1/accounts/{accountId}/focus/reporting-jobs`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-reporting-jobs-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/reporting-jobs/{itemId}/reports":{"post":{"operationId":"youtubeReportingJobsReports","summary":"YouTube: List reports (Bulk report jobs)","tags":["Focus · YouTube"],"description":"Generated daily reports · quota: 1 reporting query (reporting.jobs.reports.list). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: `/v1/accounts/{accountId}/focus/reporting-jobs`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-reporting-jobs-reports","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/reporting-reports":{"get":{"operationId":"youtubeReportingReportsList","summary":"YouTube: List Bulk reports","tags":["Focus · YouTube"],"description":"Reports of a job · quota: 1 reporting query (reporting.jobs.reports.list). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: `/v1/accounts/{accountId}/focus/reporting-reports`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"job_id","required":true},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"created_after","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-reporting-reports-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"job_id":{"type":"string","readOnly":true},"start_time":{"type":"string","format":"date-time","readOnly":true},"end_time":{"type":"string","format":"date-time","readOnly":true},"create_time":{"type":"string","format":"date-time","readOnly":true},"download_url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/reporting-reports/{itemId}/download":{"post":{"operationId":"youtubeReportingReportsDownload","summary":"YouTube: Download CSV (Bulk reports)","tags":["Focus · YouTube"],"description":"Download and parse the report · quota: 2 reporting queries (reporting.jobs.reports.get, reporting.media.download). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: `/v1/accounts/{accountId}/focus/reporting-reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"parse":{"type":"boolean","default":true}},"required":["job_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-reporting-reports-download","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comments":{"get":{"operationId":"youtubeCommentsList","summary":"YouTube: List Comments","tags":["Focus · YouTube"],"description":"Comment threads (5 replies inline; channel-wide by default) · quota: 1 unit (commentThreads.list). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false},{"schema":{"type":"string","enum":["published","heldForReview","likelySpam"],"default":"published"},"in":"query","name":"moderation_status","required":false},{"schema":{"type":"string","enum":["time","relevance"],"default":"time"},"in":"query","name":"order","required":false},{"schema":{"type":"string"},"in":"query","name":"search_terms","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comments-list","x-zernio":["GET /v1/inbox/comments"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true},"replies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true}}},"readOnly":true}},"required":["text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeCommentsCreate","summary":"YouTube: Create a Comments item","tags":["Focus · YouTube"],"description":"Post a top-level comment on a video · quota: 50 units (commentThreads.insert). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"text":{"type":"string","maxLength":10000}},"required":["video_id","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comments-create","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}","POST /v1/inbox/comments/{postId}/{commentId}/moderation"],"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true},"replies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true}}},"readOnly":true}},"required":["text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comments/{itemId}":{"get":{"operationId":"youtubeCommentsGet","summary":"YouTube: Get a Comments item","tags":["Focus · YouTube"],"description":"A comment · quota: 1 unit (comments.list). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comments-get","x-zernio":["GET /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true},"replies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true}}},"readOnly":true}},"required":["text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"youtubeCommentsUpdate","summary":"YouTube: Update a Comments item","tags":["Focus · YouTube"],"description":"Edit own comment · quota: 50 units (comments.update). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":10000}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comments-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true},"replies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true}}},"readOnly":true}},"required":["text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeCommentsDelete","summary":"YouTube: Delete a Comments item","tags":["Focus · YouTube"],"description":"Delete own comment (use reject for others) · quota: 50 units (comments.delete). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: `/v1/accounts/{accountId}/focus/comments`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comments-delete","x-zernio":["DELETE /v1/inbox/comments/{postId}"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comments/{itemId}/reply":{"post":{"operationId":"youtubeCommentsReply","summary":"YouTube: Reply (Comments)","tags":["Focus · YouTube"],"description":"Reply as the channel · quota: 50 units (comments.insert). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":10000}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comments-reply","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comments/{itemId}/approve":{"post":{"operationId":"youtubeCommentsApprove","summary":"YouTube: Approve (Comments)","tags":["Focus · YouTube"],"description":"Publish a held / likely-spam comment · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comments-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comments/{itemId}/hold":{"post":{"operationId":"youtubeCommentsHold","summary":"YouTube: Hold for review (Comments)","tags":["Focus · YouTube"],"description":"Move to the held-for-review queue · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comments-hold","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comments/{itemId}/reject":{"post":{"operationId":"youtubeCommentsReject","summary":"YouTube: Hide (reject) (Comments)","tags":["Focus · YouTube"],"description":"Reject = hide from the channel; cannot be republished. Optionally ban the author. · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ban_author":{"type":"boolean","default":false}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comments-reject","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comments/{itemId}/ban-author":{"post":{"operationId":"youtubeCommentsBanAuthor","summary":"YouTube: Hide & ban author (Comments)","tags":["Focus · YouTube"],"description":"Reject and ban the author from commenting on the channel · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: `/v1/accounts/{accountId}/focus/comments`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comments-ban-author","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comment-replies":{"get":{"operationId":"youtubeCommentRepliesList","summary":"YouTube: List Replies","tags":["Focus · YouTube"],"description":"Replies to a comment · quota: 1 unit (comments.list). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: `/v1/accounts/{accountId}/focus/comment-replies`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"parent_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comment-replies-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":"string"},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true}},"required":["parent_id","text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeCommentRepliesCreate","summary":"YouTube: Create a Replies item","tags":["Focus · YouTube"],"description":"Reply · quota: 50 units (comments.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: `/v1/accounts/{accountId}/focus/comment-replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"parent_id":{"type":"string"},"text":{"type":"string","maxLength":10000}},"required":["parent_id","text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comment-replies-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":"string"},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true}},"required":["parent_id","text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comment-replies/{itemId}":{"patch":{"operationId":"youtubeCommentRepliesUpdate","summary":"YouTube: Update a Replies item","tags":["Focus · YouTube"],"description":"Edit own comment · quota: 50 units (comments.update). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: `/v1/accounts/{accountId}/focus/comment-replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":10000}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comment-replies-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":"string"},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true}},"required":["parent_id","text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeCommentRepliesDelete","summary":"YouTube: Delete a Replies item","tags":["Focus · YouTube"],"description":"Delete own comment (use reject for others) · quota: 50 units (comments.delete). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: `/v1/accounts/{accountId}/focus/comment-replies`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comment-replies-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comment-replies/{itemId}/approve":{"post":{"operationId":"youtubeCommentRepliesApprove","summary":"YouTube: Approve (Replies)","tags":["Focus · YouTube"],"description":"Publish a held / likely-spam comment · quota: 50 units (comments.setModerationStatus). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: `/v1/accounts/{accountId}/focus/comment-replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comment-replies-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comment-replies/{itemId}/hold":{"post":{"operationId":"youtubeCommentRepliesHold","summary":"YouTube: Hold for review (Replies)","tags":["Focus · YouTube"],"description":"Move to the held-for-review queue · quota: 50 units (comments.setModerationStatus). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: `/v1/accounts/{accountId}/focus/comment-replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comment-replies-hold","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comment-replies/{itemId}/reject":{"post":{"operationId":"youtubeCommentRepliesReject","summary":"YouTube: Hide (reject) (Replies)","tags":["Focus · YouTube"],"description":"Reject = hide from the channel; cannot be republished. Optionally ban the author. · quota: 50 units (comments.setModerationStatus). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: `/v1/accounts/{accountId}/focus/comment-replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ban_author":{"type":"boolean","default":false}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comment-replies-reject","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/comment-replies/{itemId}/ban-author":{"post":{"operationId":"youtubeCommentRepliesBanAuthor","summary":"YouTube: Hide & ban author (Replies)","tags":["Focus · YouTube"],"description":"Reject and ban the author from commenting on the channel · quota: 50 units (comments.setModerationStatus). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: `/v1/accounts/{accountId}/focus/comment-replies`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_youtube","x-mcp-tool":"youtube-comment-replies-ban-author","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/held-for-review":{"get":{"operationId":"youtubeHeldForReviewList","summary":"YouTube: List Held for review","tags":["Focus · YouTube"],"description":"Moderation queue · quota: 1 unit (commentThreads.list). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: `/v1/accounts/{accountId}/focus/held-for-review`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["heldForReview","likelySpam"],"default":"heldForReview"},"in":"query","name":"queue","required":false},{"schema":{"type":"string"},"in":"query","name":"video_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-held-for-review-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true},"replies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":10000},"text_html":{"type":["null","string"],"readOnly":true},"author":{"type":"string","readOnly":true},"author_id":{"type":["null","string"],"readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_url":{"type":["null","string"],"format":"uri","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"updated_at":{"type":["null","string"],"format":"date-time","readOnly":true},"like_count":{"type":"integer","readOnly":true},"post_id":{"type":["null","string"],"description":"Video id","readOnly":true},"thread_id":{"type":["null","string"],"readOnly":true},"parent_id":{"type":["null","string"],"readOnly":true},"is_reply":{"type":"boolean","readOnly":true},"reply_count":{"type":"integer","readOnly":true},"can_reply":{"type":["null","boolean"],"readOnly":true},"moderation_status":{"type":"string","enum":["published","heldForReview","likelySpam","rejected"],"readOnly":true},"image_url":{"type":["null","string"],"format":"uri","readOnly":true},"is_own":{"type":"boolean","readOnly":true}}},"readOnly":true}},"required":["text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/held-for-review/{itemId}/reply":{"post":{"operationId":"youtubeHeldForReviewReply","summary":"YouTube: Reply (Held for review)","tags":["Focus · YouTube"],"description":"Reply as the channel · quota: 50 units (comments.insert). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: `/v1/accounts/{accountId}/focus/held-for-review`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":10000}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-held-for-review-reply","x-idempotent":true,"x-zernio":["POST /v1/inbox/comments/{postId}/{commentId}/moderation"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/held-for-review/{itemId}/approve":{"post":{"operationId":"youtubeHeldForReviewApprove","summary":"YouTube: Approve (Held for review)","tags":["Focus · YouTube"],"description":"Publish a held / likely-spam comment · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: `/v1/accounts/{accountId}/focus/held-for-review`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-held-for-review-approve","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/held-for-review/{itemId}/hold":{"post":{"operationId":"youtubeHeldForReviewHold","summary":"YouTube: Hold for review (Held for review)","tags":["Focus · YouTube"],"description":"Move to the held-for-review queue · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: `/v1/accounts/{accountId}/focus/held-for-review`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-held-for-review-hold","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/held-for-review/{itemId}/reject":{"post":{"operationId":"youtubeHeldForReviewReject","summary":"YouTube: Hide (reject) (Held for review)","tags":["Focus · YouTube"],"description":"Reject = hide from the channel; cannot be republished. Optionally ban the author. · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: `/v1/accounts/{accountId}/focus/held-for-review`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ban_author":{"type":"boolean","default":false}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_youtube","x-mcp-tool":"youtube-held-for-review-reject","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/held-for-review/{itemId}/ban-author":{"post":{"operationId":"youtubeHeldForReviewBanAuthor","summary":"YouTube: Hide & ban author (Held for review)","tags":["Focus · YouTube"],"description":"Reject and ban the author from commenting on the channel · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: `/v1/accounts/{accountId}/focus/held-for-review`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_youtube","x-mcp-tool":"youtube-held-for-review-ban-author","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/held-for-review/bulk-moderate":{"post":{"operationId":"youtubeHeldForReviewBulkModerate","summary":"YouTube: Bulk moderate (Held for review)","tags":["Focus · YouTube"],"description":"Approve/hold/reject up to 50 comments per call · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: `/v1/accounts/{accountId}/focus/held-for-review`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"},"minItems":1},"moderation_status":{"type":"string","enum":["published","heldForReview","rejected"]},"ban_author":{"type":"boolean","default":false}},"required":["ids","moderation_status"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-held-for-review-bulk-moderate","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-broadcasts":{"get":{"operationId":"youtubeLiveBroadcastsList","summary":"YouTube: List Live broadcasts","tags":["Focus · YouTube"],"description":"Broadcasts · quota: 1 unit (liveBroadcasts.list). Schedule, bind to a stream, test → go live → end, insert ad breaks. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["all","active","completed","upcoming"]},"in":"query","name":"status","required":false},{"schema":{"type":"string","enum":["all","event","persistent"],"default":"all"},"in":"query","name":"type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"scheduled_start_time":{"type":"string","format":"date-time"},"scheduled_end_time":{"type":["null","string"],"format":"date-time"},"actual_start_time":{"type":["null","string"],"format":"date-time","readOnly":true},"actual_end_time":{"type":["null","string"],"format":"date-time","readOnly":true},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"self_declared_made_for_kids":{"type":"boolean"},"life_cycle_status":{"type":"string","enum":["complete","created","live","liveStarting","ready","revoked","testStarting","testing"],"readOnly":true},"recording_status":{"type":["null","string"],"readOnly":true},"bound_stream_id":{"type":["null","string"],"readOnly":true},"live_chat_id":{"type":["null","string"],"readOnly":true},"enable_auto_start":{"type":"boolean"},"enable_auto_stop":{"type":"boolean"},"enable_dvr":{"type":"boolean"},"enable_embed":{"type":"boolean"},"record_from_start":{"type":"boolean"},"enable_closed_captions":{"type":"boolean"},"closed_captions_type":{"type":"string","enum":["closedCaptionsDisabled","closedCaptionsHttpPost","closedCaptionsEmbedded"]},"latency_preference":{"type":"string","enum":["normal","low","ultraLow"]},"projection":{"type":"string","enum":["rectangular","360"]},"enable_monitor_stream":{"type":"boolean"},"broadcast_stream_delay_ms":{"type":"integer","minimum":0},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["title","scheduled_start_time"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeLiveBroadcastsCreate","summary":"YouTube: Create a Live broadcasts item","tags":["Focus · YouTube"],"description":"Create / schedule · quota: 1 unit (liveBroadcasts.insert). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"scheduled_start_time":{"type":"string","format":"date-time"},"scheduled_end_time":{"type":["string","null"],"format":"date-time"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"self_declared_made_for_kids":{"type":"boolean"},"enable_auto_start":{"type":"boolean"},"enable_auto_stop":{"type":"boolean"},"enable_dvr":{"type":"boolean"},"enable_embed":{"type":"boolean"},"record_from_start":{"type":"boolean"},"enable_closed_captions":{"type":"boolean"},"closed_captions_type":{"type":"string","enum":["closedCaptionsDisabled","closedCaptionsHttpPost","closedCaptionsEmbedded"]},"latency_preference":{"type":"string","enum":["normal","low","ultraLow"]},"projection":{"type":"string","enum":["rectangular","360"]},"enable_monitor_stream":{"type":"boolean"},"broadcast_stream_delay_ms":{"type":"integer","minimum":0}},"required":["title","scheduled_start_time"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"scheduled_start_time":{"type":"string","format":"date-time"},"scheduled_end_time":{"type":["null","string"],"format":"date-time"},"actual_start_time":{"type":["null","string"],"format":"date-time","readOnly":true},"actual_end_time":{"type":["null","string"],"format":"date-time","readOnly":true},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"self_declared_made_for_kids":{"type":"boolean"},"life_cycle_status":{"type":"string","enum":["complete","created","live","liveStarting","ready","revoked","testStarting","testing"],"readOnly":true},"recording_status":{"type":["null","string"],"readOnly":true},"bound_stream_id":{"type":["null","string"],"readOnly":true},"live_chat_id":{"type":["null","string"],"readOnly":true},"enable_auto_start":{"type":"boolean"},"enable_auto_stop":{"type":"boolean"},"enable_dvr":{"type":"boolean"},"enable_embed":{"type":"boolean"},"record_from_start":{"type":"boolean"},"enable_closed_captions":{"type":"boolean"},"closed_captions_type":{"type":"string","enum":["closedCaptionsDisabled","closedCaptionsHttpPost","closedCaptionsEmbedded"]},"latency_preference":{"type":"string","enum":["normal","low","ultraLow"]},"projection":{"type":"string","enum":["rectangular","360"]},"enable_monitor_stream":{"type":"boolean"},"broadcast_stream_delay_ms":{"type":"integer","minimum":0},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["title","scheduled_start_time"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-broadcasts/{itemId}":{"get":{"operationId":"youtubeLiveBroadcastsGet","summary":"YouTube: Get a Live broadcasts item","tags":["Focus · YouTube"],"description":"Broadcast · quota: 1 unit (liveBroadcasts.list). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"scheduled_start_time":{"type":"string","format":"date-time"},"scheduled_end_time":{"type":["null","string"],"format":"date-time"},"actual_start_time":{"type":["null","string"],"format":"date-time","readOnly":true},"actual_end_time":{"type":["null","string"],"format":"date-time","readOnly":true},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"self_declared_made_for_kids":{"type":"boolean"},"life_cycle_status":{"type":"string","enum":["complete","created","live","liveStarting","ready","revoked","testStarting","testing"],"readOnly":true},"recording_status":{"type":["null","string"],"readOnly":true},"bound_stream_id":{"type":["null","string"],"readOnly":true},"live_chat_id":{"type":["null","string"],"readOnly":true},"enable_auto_start":{"type":"boolean"},"enable_auto_stop":{"type":"boolean"},"enable_dvr":{"type":"boolean"},"enable_embed":{"type":"boolean"},"record_from_start":{"type":"boolean"},"enable_closed_captions":{"type":"boolean"},"closed_captions_type":{"type":"string","enum":["closedCaptionsDisabled","closedCaptionsHttpPost","closedCaptionsEmbedded"]},"latency_preference":{"type":"string","enum":["normal","low","ultraLow"]},"projection":{"type":"string","enum":["rectangular","360"]},"enable_monitor_stream":{"type":"boolean"},"broadcast_stream_delay_ms":{"type":"integer","minimum":0},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["title","scheduled_start_time"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"youtubeLiveBroadcastsUpdate","summary":"YouTube: Update a Live broadcasts item","tags":["Focus · YouTube"],"description":"Edit · quota: 2 units (liveBroadcasts.list, liveBroadcasts.update). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"scheduled_start_time":{"type":"string","format":"date-time"},"scheduled_end_time":{"type":["string","null"],"format":"date-time"},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"self_declared_made_for_kids":{"type":"boolean"},"enable_auto_start":{"type":"boolean"},"enable_auto_stop":{"type":"boolean"},"enable_dvr":{"type":"boolean"},"enable_embed":{"type":"boolean"},"record_from_start":{"type":"boolean"},"enable_closed_captions":{"type":"boolean"},"closed_captions_type":{"type":"string","enum":["closedCaptionsDisabled","closedCaptionsHttpPost","closedCaptionsEmbedded"]},"latency_preference":{"type":"string","enum":["normal","low","ultraLow"]},"projection":{"type":"string","enum":["rectangular","360"]},"enable_monitor_stream":{"type":"boolean"},"broadcast_stream_delay_ms":{"type":"integer","minimum":0}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":100},"description":{"type":"string","maxLength":5000},"scheduled_start_time":{"type":"string","format":"date-time"},"scheduled_end_time":{"type":["null","string"],"format":"date-time"},"actual_start_time":{"type":["null","string"],"format":"date-time","readOnly":true},"actual_end_time":{"type":["null","string"],"format":"date-time","readOnly":true},"privacy_status":{"type":"string","enum":["public","unlisted","private"]},"self_declared_made_for_kids":{"type":"boolean"},"life_cycle_status":{"type":"string","enum":["complete","created","live","liveStarting","ready","revoked","testStarting","testing"],"readOnly":true},"recording_status":{"type":["null","string"],"readOnly":true},"bound_stream_id":{"type":["null","string"],"readOnly":true},"live_chat_id":{"type":["null","string"],"readOnly":true},"enable_auto_start":{"type":"boolean"},"enable_auto_stop":{"type":"boolean"},"enable_dvr":{"type":"boolean"},"enable_embed":{"type":"boolean"},"record_from_start":{"type":"boolean"},"enable_closed_captions":{"type":"boolean"},"closed_captions_type":{"type":"string","enum":["closedCaptionsDisabled","closedCaptionsHttpPost","closedCaptionsEmbedded"]},"latency_preference":{"type":"string","enum":["normal","low","ultraLow"]},"projection":{"type":"string","enum":["rectangular","360"]},"enable_monitor_stream":{"type":"boolean"},"broadcast_stream_delay_ms":{"type":"integer","minimum":0},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"required":["title","scheduled_start_time"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeLiveBroadcastsDelete","summary":"YouTube: Delete a Live broadcasts item","tags":["Focus · YouTube"],"description":"Delete · quota: 1 unit (liveBroadcasts.delete). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-broadcasts/{itemId}/bind":{"post":{"operationId":"youtubeLiveBroadcastsBind","summary":"YouTube: Bind stream (Live broadcasts)","tags":["Focus · YouTube"],"description":"Attach an ingestion stream · quota: 1 unit (liveBroadcasts.bind). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stream_id":{"type":"string"}},"required":["stream_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-bind","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-broadcasts/{itemId}/unbind":{"post":{"operationId":"youtubeLiveBroadcastsUnbind","summary":"YouTube: Unbind stream (Live broadcasts)","tags":["Focus · YouTube"],"description":"Detach the stream · quota: 1 unit (liveBroadcasts.bind). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-unbind","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-broadcasts/{itemId}/test":{"post":{"operationId":"youtubeLiveBroadcastsTest","summary":"YouTube: Start test (Live broadcasts)","tags":["Focus · YouTube"],"description":"Transition to testing (monitor stream must be enabled) · quota: 1 unit (liveBroadcasts.transition). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-test","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-broadcasts/{itemId}/go-live":{"post":{"operationId":"youtubeLiveBroadcastsGoLive","summary":"YouTube: Go live (Live broadcasts)","tags":["Focus · YouTube"],"description":"Transition to live · quota: 1 unit (liveBroadcasts.transition). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-go-live","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-broadcasts/{itemId}/end":{"post":{"operationId":"youtubeLiveBroadcastsEnd","summary":"YouTube: End broadcast (Live broadcasts)","tags":["Focus · YouTube"],"description":"Transition to complete · quota: 1 unit (liveBroadcasts.transition). Schedule, bind to a stream, test → go live → end, insert ad breaks. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-end","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-broadcasts/{itemId}/insert-cuepoint":{"post":{"operationId":"youtubeLiveBroadcastsInsertCuepoint","summary":"YouTube: Insert ad break (Live broadcasts)","tags":["Focus · YouTube"],"description":"Cuepoint (monetised live streams) · quota: 1 unit (liveBroadcasts.cuepoint). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: `/v1/accounts/{accountId}/focus/live-broadcasts`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"duration_secs":{"type":"integer","minimum":1,"default":30},"insertion_offset_time_ms":{"type":"integer","minimum":0},"walltime_ms":{"type":"integer"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-broadcasts-insert-cuepoint","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-streams":{"get":{"operationId":"youtubeLiveStreamsList","summary":"YouTube: List Streams (ingest)","tags":["Focus · YouTube"],"description":"Streams · quota: 1 unit (liveStreams.list). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: `/v1/accounts/{accountId}/focus/live-streams`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-streams-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":128},"description":{"type":"string","maxLength":10000},"ingestion_type":{"type":"string","enum":["rtmp","dash","webrtc","hls"]},"resolution":{"type":"string","enum":["variable","240p","360p","480p","720p","1080p","1440p","2160p"]},"frame_rate":{"type":"string","enum":["variable","30fps","60fps"]},"is_reusable":{"type":"boolean","default":true},"stream_name":{"type":["null","string"],"description":"Stream key — keep secret","readOnly":true},"ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"backup_ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"rtmps_ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"stream_status":{"type":["null","string"],"readOnly":true},"health_status":{"type":["null","string"],"readOnly":true},"health_issues":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"readOnly":true}},"required":["title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeLiveStreamsCreate","summary":"YouTube: Create a Streams (ingest) item","tags":["Focus · YouTube"],"description":"Create stream · quota: 1 unit (liveStreams.insert). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: `/v1/accounts/{accountId}/focus/live-streams`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"ingestion_type":{"type":"string","enum":["rtmp","dash","webrtc","hls"]},"resolution":{"type":"string","enum":["variable","240p","360p","480p","720p","1080p","1440p","2160p"]},"frame_rate":{"type":"string","enum":["variable","30fps","60fps"]},"is_reusable":{"type":"boolean"}},"required":["title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-streams-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":128},"description":{"type":"string","maxLength":10000},"ingestion_type":{"type":"string","enum":["rtmp","dash","webrtc","hls"]},"resolution":{"type":"string","enum":["variable","240p","360p","480p","720p","1080p","1440p","2160p"]},"frame_rate":{"type":"string","enum":["variable","30fps","60fps"]},"is_reusable":{"type":"boolean","default":true},"stream_name":{"type":["null","string"],"description":"Stream key — keep secret","readOnly":true},"ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"backup_ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"rtmps_ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"stream_status":{"type":["null","string"],"readOnly":true},"health_status":{"type":["null","string"],"readOnly":true},"health_issues":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-streams/{itemId}":{"get":{"operationId":"youtubeLiveStreamsGet","summary":"YouTube: Get a Streams (ingest) item","tags":["Focus · YouTube"],"description":"Stream · quota: 1 unit (liveStreams.list). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: `/v1/accounts/{accountId}/focus/live-streams`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-streams-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":128},"description":{"type":"string","maxLength":10000},"ingestion_type":{"type":"string","enum":["rtmp","dash","webrtc","hls"]},"resolution":{"type":"string","enum":["variable","240p","360p","480p","720p","1080p","1440p","2160p"]},"frame_rate":{"type":"string","enum":["variable","30fps","60fps"]},"is_reusable":{"type":"boolean","default":true},"stream_name":{"type":["null","string"],"description":"Stream key — keep secret","readOnly":true},"ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"backup_ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"rtmps_ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"stream_status":{"type":["null","string"],"readOnly":true},"health_status":{"type":["null","string"],"readOnly":true},"health_issues":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"youtubeLiveStreamsUpdate","summary":"YouTube: Update a Streams (ingest) item","tags":["Focus · YouTube"],"description":"Edit stream · quota: 2 units (liveStreams.list, liveStreams.update). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: `/v1/accounts/{accountId}/focus/live-streams`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"resolution":{"type":"string","enum":["variable","240p","360p","480p","720p","1080p","1440p","2160p"]},"frame_rate":{"type":"string","enum":["variable","30fps","60fps"]},"is_reusable":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-streams-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","maxLength":128},"description":{"type":"string","maxLength":10000},"ingestion_type":{"type":"string","enum":["rtmp","dash","webrtc","hls"]},"resolution":{"type":"string","enum":["variable","240p","360p","480p","720p","1080p","1440p","2160p"]},"frame_rate":{"type":"string","enum":["variable","30fps","60fps"]},"is_reusable":{"type":"boolean","default":true},"stream_name":{"type":["null","string"],"description":"Stream key — keep secret","readOnly":true},"ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"backup_ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"rtmps_ingestion_address":{"type":["null","string"],"format":"uri","readOnly":true},"stream_status":{"type":["null","string"],"readOnly":true},"health_status":{"type":["null","string"],"readOnly":true},"health_issues":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true},"readOnly":true}},"required":["title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeLiveStreamsDelete","summary":"YouTube: Delete a Streams (ingest) item","tags":["Focus · YouTube"],"description":"Delete stream · quota: 1 unit (liveStreams.delete). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: `/v1/accounts/{accountId}/focus/live-streams`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-streams-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-chat":{"get":{"operationId":"youtubeLiveChatList","summary":"YouTube: List Live chat","tags":["Focus · YouTube"],"description":"Chat messages (active broadcast by default) · quota: 5 units (liveChatMessages.list). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: `/v1/accounts/{accountId}/focus/live-chat`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"broadcast_id","required":false},{"schema":{"type":"string"},"in":"query","name":"live_chat_id","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":200,"maximum":2000,"default":500},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":200},"published_at":{"type":"string","format":"date-time","readOnly":true},"author":{"type":"string","readOnly":true},"author_channel_id":{"type":"string","readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_is_owner":{"type":["null","boolean"],"readOnly":true},"author_is_moderator":{"type":["null","boolean"],"readOnly":true},"author_is_sponsor":{"type":["null","boolean"],"readOnly":true},"super_chat":{"type":["null","object"],"properties":{"amount_micros":{"type":"integer"},"currency":{"type":"string"},"display":{"type":"string"},"comment":{"type":["null","string"]},"tier":{"type":["null","integer"]}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"question":{"type":"string"},"status":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"tally":{"type":["null","integer"]}}}}},"readOnly":true}},"required":["text"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeLiveChatCreate","summary":"YouTube: Create a Live chat item","tags":["Focus · YouTube"],"description":"Send message as the channel · quota: 20 units (liveChatMessages.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: `/v1/accounts/{accountId}/focus/live-chat`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"broadcast_id":{"type":"string"},"live_chat_id":{"type":"string"},"text":{"type":"string","maxLength":200}},"required":["text"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","readOnly":true},"text":{"type":"string","maxLength":200},"published_at":{"type":"string","format":"date-time","readOnly":true},"author":{"type":"string","readOnly":true},"author_channel_id":{"type":"string","readOnly":true},"author_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"author_is_owner":{"type":["null","boolean"],"readOnly":true},"author_is_moderator":{"type":["null","boolean"],"readOnly":true},"author_is_sponsor":{"type":["null","boolean"],"readOnly":true},"super_chat":{"type":["null","object"],"properties":{"amount_micros":{"type":"integer"},"currency":{"type":"string"},"display":{"type":"string"},"comment":{"type":["null","string"]},"tier":{"type":["null","integer"]}},"readOnly":true},"poll":{"type":["null","object"],"properties":{"question":{"type":"string"},"status":{"type":"string"},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"tally":{"type":["null","integer"]}}}}},"readOnly":true}},"required":["text"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-chat/{itemId}":{"delete":{"operationId":"youtubeLiveChatDelete","summary":"YouTube: Delete a Live chat item","tags":["Focus · YouTube"],"description":"Delete message · quota: 20 units (liveChatMessages.delete). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: `/v1/accounts/{accountId}/focus/live-chat`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-chat/create-poll":{"post":{"operationId":"youtubeLiveChatCreatePoll","summary":"YouTube: Start poll (Live chat)","tags":["Focus · YouTube"],"description":"Post a poll in chat · quota: 20 units (liveChatMessages.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: `/v1/accounts/{accountId}/focus/live-chat`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"broadcast_id":{"type":"string"},"live_chat_id":{"type":"string"},"question":{"type":"string","maxLength":100},"options":{"type":"array","items":{"type":"string","maxLength":35},"minItems":2,"maxItems":4}},"required":["question","options"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-create-poll","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-chat/{itemId}/close-poll":{"post":{"operationId":"youtubeLiveChatClosePoll","summary":"YouTube: Close poll (Live chat)","tags":["Focus · YouTube"],"description":"End an active poll · quota: 20 units (liveChatMessages.transition). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: `/v1/accounts/{accountId}/focus/live-chat`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-close-poll","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-chat/{itemId}/ban-author":{"post":{"operationId":"youtubeLiveChatBanAuthor","summary":"YouTube: Ban / timeout author (Live chat)","tags":["Focus · YouTube"],"description":"Ban permanently or for N seconds · quota: 200 units (liveChatBans.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: `/v1/accounts/{accountId}/focus/live-chat`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"broadcast_id":{"type":"string"},"live_chat_id":{"type":"string"},"author_channel_id":{"type":"string"},"type":{"type":"string","enum":["permanent","temporary"],"default":"permanent"},"ban_duration_seconds":{"type":"integer","minimum":1}},"required":["author_channel_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-ban-author","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-chat/{itemId}/make-moderator":{"post":{"operationId":"youtubeLiveChatMakeModerator","summary":"YouTube: Make moderator (Live chat)","tags":["Focus · YouTube"],"description":"Promote the author to chat moderator · quota: 200 units (liveChatModerators.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: `/v1/accounts/{accountId}/focus/live-chat`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"broadcast_id":{"type":"string"},"live_chat_id":{"type":"string"},"author_channel_id":{"type":"string"}},"required":["author_channel_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-make-moderator","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-chat-moderators":{"get":{"operationId":"youtubeLiveChatModeratorsList","summary":"YouTube: List Chat moderators","tags":["Focus · YouTube"],"description":"Moderators · quota: 50 units (liveChatModerators.list). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatModerators Generic route: `/v1/accounts/{accountId}/focus/live-chat-moderators`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"broadcast_id","required":false},{"schema":{"type":"string"},"in":"query","name":"live_chat_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-moderators-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"display_name":{"type":["null","string"],"readOnly":true},"channel_url":{"type":["null","string"],"format":"uri","readOnly":true},"profile_image_url":{"type":["null","string"],"format":"uri","readOnly":true},"live_chat_id":{"type":"string","readOnly":true}},"required":["channel_id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeLiveChatModeratorsCreate","summary":"YouTube: Create a Chat moderators item","tags":["Focus · YouTube"],"description":"Add moderator · quota: 200 units (liveChatModerators.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatModerators Generic route: `/v1/accounts/{accountId}/focus/live-chat-moderators`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"broadcast_id":{"type":"string"},"live_chat_id":{"type":"string"},"channel_id":{"type":"string"}},"required":["channel_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-moderators-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"display_name":{"type":["null","string"],"readOnly":true},"channel_url":{"type":["null","string"],"format":"uri","readOnly":true},"profile_image_url":{"type":["null","string"],"format":"uri","readOnly":true},"live_chat_id":{"type":"string","readOnly":true}},"required":["channel_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-chat-moderators/{itemId}":{"delete":{"operationId":"youtubeLiveChatModeratorsDelete","summary":"YouTube: Delete a Chat moderators item","tags":["Focus · YouTube"],"description":"Remove moderator · quota: 200 units (liveChatModerators.delete). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatModerators Generic route: `/v1/accounts/{accountId}/focus/live-chat-moderators`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-moderators-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-chat-bans":{"post":{"operationId":"youtubeLiveChatBansCreate","summary":"YouTube: Create a Chat bans item","tags":["Focus · YouTube"],"description":"Ban / timeout · quota: 200 units (liveChatBans.insert). Ban or time out users. The API has no list endpoint — keep the returned ban id to lift it. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatBans Generic route: `/v1/accounts/{accountId}/focus/live-chat-bans`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"broadcast_id":{"type":"string"},"live_chat_id":{"type":"string"},"channel_id":{"type":"string"},"type":{"type":"string","enum":["permanent","temporary"],"default":"permanent"},"ban_duration_seconds":{"type":"integer","minimum":1}},"required":["channel_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-bans-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"display_name":{"type":["null","string"],"readOnly":true},"type":{"type":"string","enum":["permanent","temporary"]},"ban_duration_seconds":{"type":["null","integer"],"minimum":1},"live_chat_id":{"type":"string","readOnly":true}},"required":["channel_id","type"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/live-chat-bans/{itemId}":{"delete":{"operationId":"youtubeLiveChatBansDelete","summary":"YouTube: Delete a Chat bans item","tags":["Focus · YouTube"],"description":"Lift ban · quota: 200 units (liveChatBans.delete). Ban or time out users. The API has no list endpoint — keep the returned ban id to lift it. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatBans Generic route: `/v1/accounts/{accountId}/focus/live-chat-bans`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-live-chat-bans-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/super-chats":{"get":{"operationId":"youtubeSuperChatsList","summary":"YouTube: List Super Chats","tags":["Focus · YouTube"],"description":"Super Chat events · quota: 1 unit (superChatEvents.list). Super Chat & Super Sticker purchases from the last 30 days. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/superChatEvents Generic route: `/v1/accounts/{accountId}/focus/super-chats`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"hl","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-super-chats-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"supporter_name":{"type":"string","readOnly":true},"supporter_channel_id":{"type":"string","readOnly":true},"supporter_avatar_url":{"type":["null","string"],"format":"uri","readOnly":true},"comment":{"type":["null","string"],"readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"amount_micros":{"type":"integer","readOnly":true},"currency":{"type":"string","readOnly":true},"display_amount":{"type":"string","readOnly":true},"message_type":{"type":["null","integer"],"readOnly":true},"is_super_sticker":{"type":"boolean","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/revenue":{"get":{"operationId":"youtubeRevenueGet","summary":"YouTube: Get Revenue","tags":["Focus · YouTube"],"description":"Revenue dashboard · quota: 6 analytics queries (analytics.reports.query). YPP channels: estimated revenue, ad revenue, Premium revenue, CPM, RPM-like playback CPM, ad impressions, by day/video/country/ad type/content type. Requires scopes: https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/metrics#Revenue-Metrics Generic route: `/v1/accounts/{accountId}/focus/revenue`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string","default":"USD"},"in":"query","name":"currency","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-revenue-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","readOnly":true},"until":{"type":"string","format":"date","readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"report":{"type":"string"},"label":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["dimension","metric"]},"data_type":{"type":["null","string"]}}}},"rows":{"type":"array","items":{"type":"array","items":{}}},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}}}}},"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"code":{"type":["null","string"]},"message":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/members":{"get":{"operationId":"youtubeMembersList","summary":"YouTube: List Members","tags":["Focus · YouTube"],"description":"Members · quota: 2 units (members.list). Channel members with level and tenure; mode=updates streams new/upgraded members. Access is allowlisted by YouTube. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/youtube.channel-memberships.creator. Network docs: https://developers.google.com/youtube/v3/docs/members Generic route: `/v1/accounts/{accountId}/focus/members`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":1000,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["all_current","updates"],"default":"all_current"},"in":"query","name":"mode","required":false},{"schema":{"type":"string"},"in":"query","name":"level_id","required":false},{"schema":{"type":"string"},"in":"query","name":"channel_ids","required":false,"description":"Comma-separated, ≤100"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-members-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"channel_id":{"type":"string","readOnly":true},"display_name":{"type":"string","readOnly":true},"channel_url":{"type":"string","format":"uri","readOnly":true},"profile_image_url":{"type":["null","string"],"format":"uri","readOnly":true},"highest_level_id":{"type":["null","string"],"readOnly":true},"highest_level_name":{"type":["null","string"],"readOnly":true},"accessible_levels":{"type":"array","items":{"type":"string"},"readOnly":true},"member_since":{"type":["null","string"],"format":"date-time","readOnly":true},"total_months":{"type":["null","integer"],"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/membership-levels":{"get":{"operationId":"youtubeMembershipLevelsList","summary":"YouTube: List Membership levels","tags":["Focus · YouTube"],"description":"Levels · quota: 1 unit (membershipsLevels.list). Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/youtube.channel-memberships.creator. Network docs: https://developers.google.com/youtube/v3/docs/membershipsLevels Generic route: `/v1/accounts/{accountId}/focus/membership-levels`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-membership-levels-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"display_name":{"type":"string","readOnly":true},"creator_channel_id":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/membership-analytics":{"get":{"operationId":"youtubeMembershipAnalyticsGet","summary":"YouTube: Get Membership churn","tags":["Focus · YouTube"],"description":"Membership churn: cancellations · quota: 1 analytics query (analytics.reports.query). Cancellation survey reasons. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: `/v1/accounts/{accountId}/focus/membership-analytics`.","parameters":[{"schema":{"type":"string","format":"date"},"in":"query","name":"since","required":false,"description":"YYYY-MM-DD (default: 28 days ago)"},{"schema":{"type":"string","format":"date"},"in":"query","name":"until","required":false,"description":"YYYY-MM-DD (default: today)"},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-membership-analytics-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"since":{"type":"string","format":"date","readOnly":true},"until":{"type":"string","format":"date","readOnly":true},"sections":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"report":{"type":"string"},"label":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["dimension","metric"]},"data_type":{"type":["null","string"]}}}},"rows":{"type":"array","items":{"type":"array","items":{}}},"items":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":true}},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"metrics":{"type":"object","properties":{},"additionalProperties":{"type":"number"}}}}}}},"readOnly":true},"errors":{"type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"code":{"type":["null","string"]},"message":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/channel":{"get":{"operationId":"youtubeChannelGet","summary":"YouTube: Get Basic info","tags":["Focus · YouTube"],"description":"Channel · quota: 1 unit (channels.list). Description, keywords, country, default language, trailer, made-for-kids. Title/handle/avatar are Studio-only. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/update Generic route: `/v1/accounts/{accountId}/focus/channel`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","description":"Not editable via the API","readOnly":true},"handle":{"type":["null","string"],"readOnly":true},"custom_url":{"type":["null","string"],"readOnly":true},"description":{"type":"string","maxLength":1000},"keywords":{"type":"array","items":{"type":"string"},"description":"Channel tags"},"country":{"type":["null","string"],"description":"ISO 3166-1 alpha-2"},"default_language":{"type":["null","string"]},"unsubscribed_trailer":{"type":["null","string"],"description":"Video id shown to non-subscribers (public/unlisted, owned)"},"tracking_analytics_account_id":{"type":["null","string"],"description":"Google Analytics property id"},"self_declared_made_for_kids":{"type":["null","boolean"],"description":"Channel-level made for kids"},"made_for_kids":{"type":["null","boolean"],"readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"banner_url":{"type":["null","string"],"format":"uri","readOnly":true},"subscriber_count":{"type":["null","integer"],"readOnly":true},"hidden_subscriber_count":{"type":["null","boolean"],"readOnly":true},"video_count":{"type":["null","integer"],"readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"uploads_playlist_id":{"type":["null","string"],"readOnly":true},"privacy_status":{"type":["null","string"],"readOnly":true},"long_uploads_status":{"type":["null","string"],"readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"topic_categories":{"type":"array","items":{"type":"string","format":"uri"},"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"youtubeChannelUpdate","summary":"YouTube: Update Basic info","tags":["Focus · YouTube"],"description":"Update branding (+ status when made-for-kids changes) · quota: 51 units (channels.list, channels.update). Description, keywords, country, default language, trailer, made-for-kids. Title/handle/avatar are Studio-only. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/update Generic route: `/v1/accounts/{accountId}/focus/channel`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","maxLength":1000},"keywords":{"type":"array","items":{"type":"string"},"description":"Channel tags"},"country":{"type":"string"},"default_language":{"type":"string"},"unsubscribed_trailer":{"type":"string"},"tracking_analytics_account_id":{"type":"string"},"self_declared_made_for_kids":{"type":"boolean"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","description":"Not editable via the API","readOnly":true},"handle":{"type":["null","string"],"readOnly":true},"custom_url":{"type":["null","string"],"readOnly":true},"description":{"type":"string","maxLength":1000},"keywords":{"type":"array","items":{"type":"string"},"description":"Channel tags"},"country":{"type":["null","string"],"description":"ISO 3166-1 alpha-2"},"default_language":{"type":["null","string"]},"unsubscribed_trailer":{"type":["null","string"],"description":"Video id shown to non-subscribers (public/unlisted, owned)"},"tracking_analytics_account_id":{"type":["null","string"],"description":"Google Analytics property id"},"self_declared_made_for_kids":{"type":["null","boolean"],"description":"Channel-level made for kids"},"made_for_kids":{"type":["null","boolean"],"readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"banner_url":{"type":["null","string"],"format":"uri","readOnly":true},"subscriber_count":{"type":["null","integer"],"readOnly":true},"hidden_subscriber_count":{"type":["null","boolean"],"readOnly":true},"video_count":{"type":["null","integer"],"readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"uploads_playlist_id":{"type":["null","string"],"readOnly":true},"privacy_status":{"type":["null","string"],"readOnly":true},"long_uploads_status":{"type":["null","string"],"readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"topic_categories":{"type":"array","items":{"type":"string","format":"uri"},"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/channel-localizations":{"get":{"operationId":"youtubeChannelLocalizationsList","summary":"YouTube: List Channel translations","tags":["Focus · YouTube"],"description":"Translations · quota: 1 unit (channels.list). Channel title/description per language (requires a default language). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: `/v1/accounts/{accountId}/focus/channel-localizations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-localizations-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","maxLength":1000}},"required":["language","title"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeChannelLocalizationsCreate","summary":"YouTube: Create a Channel translations item","tags":["Focus · YouTube"],"description":"Add translation · quota: 52 units (channels.list, channels.update). Channel title/description per language (requires a default language). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: `/v1/accounts/{accountId}/focus/channel-localizations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"language":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}},"required":["language","title"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-localizations-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"language":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","maxLength":1000}},"required":["language","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/channel-localizations/{itemId}":{"patch":{"operationId":"youtubeChannelLocalizationsUpdate","summary":"YouTube: Update a Channel translations item","tags":["Focus · YouTube"],"description":"Edit translation · quota: 52 units (channels.list, channels.update). Channel title/description per language (requires a default language). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: `/v1/accounts/{accountId}/focus/channel-localizations`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-localizations-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"language":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","maxLength":1000}},"required":["language","title"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeChannelLocalizationsDelete","summary":"YouTube: Delete a Channel translations item","tags":["Focus · YouTube"],"description":"Remove translation · quota: 52 units (channels.list, channels.update). Channel title/description per language (requires a default language). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: `/v1/accounts/{accountId}/focus/channel-localizations`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-localizations-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/channel-banner":{"get":{"operationId":"youtubeChannelBannerGet","summary":"YouTube: Get Banner","tags":["Focus · YouTube"],"description":"Current banner · quota: 1 unit (channels.list). 16:9, ≥2048×1152 (2560×1440 recommended), ≤6 MB JPEG/PNG. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelBanners/insert Generic route: `/v1/accounts/{accountId}/focus/channel-banner`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-banner-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"banner_url":{"type":["null","string"],"format":"uri"},"media":{"type":"string","writeOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"operationId":"youtubeChannelBannerUpdate","summary":"YouTube: Update Banner","tags":["Focus · YouTube"],"description":"Upload and apply banner · quota: 101 units (channelBanners.insert, channels.list, channels.update). 16:9, ≥2048×1152 (2560×1440 recommended), ≤6 MB JPEG/PNG. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelBanners/insert Generic route: `/v1/accounts/{accountId}/focus/channel-banner`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string"},"apply":{"type":"boolean","default":true}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-banner-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"banner_url":{"type":["null","string"],"format":"uri"},"media":{"type":"string","writeOnly":true}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/watermark":{"get":{"operationId":"youtubeWatermarkGet","summary":"YouTube: Get Video watermark","tags":["Focus · YouTube"],"description":"Watermark settings form (not readable via API) · quota: none (no API call). Branding watermark shown on all videos (the API cannot read the current one). Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/watermarks Generic route: `/v1/accounts/{accountId}/focus/watermark`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-watermark-get","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string","description":"JPEG/PNG ≤10 MB, square (~150×150)"},"timing_type":{"type":"string","enum":["offsetFromStart","offsetFromEnd"],"default":"offsetFromStart"},"offset_ms":{"type":"integer","minimum":0,"default":0},"duration_ms":{"type":["null","integer"],"minimum":0},"corner_position":{"type":"string","enum":["topLeft","topRight","bottomLeft","bottomRight"],"default":"bottomRight"}},"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/watermark/set":{"post":{"operationId":"youtubeWatermarkSet","summary":"YouTube: Set watermark (Video watermark)","tags":["Focus · YouTube"],"description":"Upload and apply · quota: 50 units (watermarks.set). Branding watermark shown on all videos (the API cannot read the current one). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/watermarks Generic route: `/v1/accounts/{accountId}/focus/watermark`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"string"},"timing_type":{"type":"string","enum":["offsetFromStart","offsetFromEnd"]},"offset_ms":{"type":"integer","minimum":0},"duration_ms":{"type":"integer","minimum":0},"corner_position":{"type":"string","enum":["topLeft","topRight","bottomLeft","bottomRight"]}},"required":["media"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"action","x-toolset":"focus_youtube","x-mcp-tool":"youtube-watermark-set","x-idempotent":true,"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/watermark/unset":{"post":{"operationId":"youtubeWatermarkUnset","summary":"YouTube: Remove watermark (Video watermark)","tags":["Focus · YouTube"],"description":"Unset · quota: 50 units (watermarks.unset). Branding watermark shown on all videos (the API cannot read the current one). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/watermarks Generic route: `/v1/accounts/{accountId}/focus/watermark`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_youtube","x-mcp-tool":"youtube-watermark-unset","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/channel-sections":{"get":{"operationId":"youtubeChannelSectionsList","summary":"YouTube: List Home tab sections","tags":["Focus · YouTube"],"description":"Sections · quota: 1 unit (channelSections.list). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: `/v1/accounts/{accountId}/focus/channel-sections`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-sections-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["allPlaylists","completedEvents","liveEvents","multipleChannels","multiplePlaylists","popularUploads","recentUploads","singlePlaylist","subscriptions","upcomingEvents"]},"title":{"type":["null","string"],"description":"Required for multiplePlaylists / multipleChannels"},"position":{"type":"integer","minimum":0},"playlists":{"type":"array","items":{"type":"string"},"description":"singlePlaylist (1) / multiplePlaylists"},"channels":{"type":"array","items":{"type":"string"},"description":"multipleChannels"}},"required":["type"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeChannelSectionsCreate","summary":"YouTube: Create a Home tab sections item","tags":["Focus · YouTube"],"description":"Add section · quota: 50 units (channelSections.insert). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: `/v1/accounts/{accountId}/focus/channel-sections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["allPlaylists","completedEvents","liveEvents","multipleChannels","multiplePlaylists","popularUploads","recentUploads","singlePlaylist","subscriptions","upcomingEvents"]},"title":{"type":["string","null"],"description":"Required for multiplePlaylists / multipleChannels"},"position":{"type":"integer","minimum":0},"playlists":{"type":"array","items":{"type":"string"},"description":"singlePlaylist (1) / multiplePlaylists"},"channels":{"type":"array","items":{"type":"string"},"description":"multipleChannels"}},"required":["type"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-sections-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["allPlaylists","completedEvents","liveEvents","multipleChannels","multiplePlaylists","popularUploads","recentUploads","singlePlaylist","subscriptions","upcomingEvents"]},"title":{"type":["null","string"],"description":"Required for multiplePlaylists / multipleChannels"},"position":{"type":"integer","minimum":0},"playlists":{"type":"array","items":{"type":"string"},"description":"singlePlaylist (1) / multiplePlaylists"},"channels":{"type":"array","items":{"type":"string"},"description":"multipleChannels"}},"required":["type"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/channel-sections/{itemId}":{"patch":{"operationId":"youtubeChannelSectionsUpdate","summary":"YouTube: Update a Home tab sections item","tags":["Focus · YouTube"],"description":"Edit / move section · quota: 51 units (channelSections.list, channelSections.update). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: `/v1/accounts/{accountId}/focus/channel-sections`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["allPlaylists","completedEvents","liveEvents","multipleChannels","multiplePlaylists","popularUploads","recentUploads","singlePlaylist","subscriptions","upcomingEvents"]},"title":{"type":["string","null"],"description":"Required for multiplePlaylists / multipleChannels"},"position":{"type":"integer","minimum":0},"playlists":{"type":"array","items":{"type":"string"},"description":"singlePlaylist (1) / multiplePlaylists"},"channels":{"type":"array","items":{"type":"string"},"description":"multipleChannels"}}}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"update","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-sections-update","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"type":{"type":"string","enum":["allPlaylists","completedEvents","liveEvents","multipleChannels","multiplePlaylists","popularUploads","recentUploads","singlePlaylist","subscriptions","upcomingEvents"]},"title":{"type":["null","string"],"description":"Required for multiplePlaylists / multipleChannels"},"position":{"type":"integer","minimum":0},"playlists":{"type":"array","items":{"type":"string"},"description":"singlePlaylist (1) / multiplePlaylists"},"channels":{"type":"array","items":{"type":"string"},"description":"multipleChannels"}},"required":["type"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"operationId":"youtubeChannelSectionsDelete","summary":"YouTube: Delete a Home tab sections item","tags":["Focus · YouTube"],"description":"Remove section · quota: 50 units (channelSections.delete). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: `/v1/accounts/{accountId}/focus/channel-sections`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-channel-sections-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/subscriptions":{"get":{"operationId":"youtubeSubscriptionsList","summary":"YouTube: List Subscriptions","tags":["Focus · YouTube"],"description":"My subscriptions · quota: 1 unit (subscriptions.list). Channels this channel subscribes to; subscribe / unsubscribe. Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions Generic route: `/v1/accounts/{accountId}/focus/subscriptions`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","enum":["alphabetical","relevance","unread"]},"in":"query","name":"order","required":false},{"schema":{"type":"string"},"in":"query","name":"for_channel_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-subscriptions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"title":{"type":"string","readOnly":true},"description":{"type":["null","string"],"readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"subscribed_at":{"type":"string","format":"date-time","readOnly":true},"subscriber_channel_id":{"type":["null","string"],"readOnly":true},"subscriber_title":{"type":["null","string"],"readOnly":true},"subscriber_thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"total_item_count":{"type":["null","integer"],"readOnly":true},"new_item_count":{"type":["null","integer"],"readOnly":true}},"required":["channel_id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"operationId":"youtubeSubscriptionsCreate","summary":"YouTube: Create a Subscriptions item","tags":["Focus · YouTube"],"description":"Subscribe · quota: 50 units (subscriptions.insert). Channels this channel subscribes to; subscribe / unsubscribe. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions Generic route: `/v1/accounts/{accountId}/focus/subscriptions`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel_id":{"type":"string"}},"required":["channel_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"$ref":"#/components/parameters/IdempotencyKey"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"create","x-toolset":"focus_youtube","x-mcp-tool":"youtube-subscriptions-create","x-idempotent":true,"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"title":{"type":"string","readOnly":true},"description":{"type":["null","string"],"readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"subscribed_at":{"type":"string","format":"date-time","readOnly":true},"subscriber_channel_id":{"type":["null","string"],"readOnly":true},"subscriber_title":{"type":["null","string"],"readOnly":true},"subscriber_thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"total_item_count":{"type":["null","integer"],"readOnly":true},"new_item_count":{"type":["null","integer"],"readOnly":true}},"required":["channel_id"],"additionalProperties":true}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/subscriptions/{itemId}":{"delete":{"operationId":"youtubeSubscriptionsDelete","summary":"YouTube: Delete a Subscriptions item","tags":["Focus · YouTube"],"description":"Unsubscribe · quota: 50 units (subscriptions.delete). Channels this channel subscribes to; subscribe / unsubscribe. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions Generic route: `/v1/accounts/{accountId}/focus/subscriptions`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"},{"schema":{"type":"string","minLength":1,"maxLength":512},"in":"path","name":"itemId","required":true,"description":"The network's id of the item"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"delete","x-toolset":"focus_youtube","x-mcp-tool":"youtube-subscriptions-delete","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_item"]},"platform":{"type":"string"},"resource":{"type":"string"},"id":{"type":["null","string"]},"deleted":{"type":"boolean"},"result":{}},"required":["object","platform","resource","id","deleted"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/subscribers":{"get":{"operationId":"youtubeSubscribersList","summary":"YouTube: List Subscribers","tags":["Focus · YouTube"],"description":"Subscribers · quota: 1 unit (subscriptions.list). Subscribers with public subscriptions (all or recent). Cursor pagination: pass `next_cursor` back as `cursor`. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions/list Generic route: `/v1/accounts/{accountId}/focus/subscribers`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"boolean","default":false},"in":"query","name":"recent","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-subscribers-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"channel_id":{"type":"string"},"title":{"type":"string","readOnly":true},"description":{"type":["null","string"],"readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"subscribed_at":{"type":"string","format":"date-time","readOnly":true},"subscriber_channel_id":{"type":["null","string"],"readOnly":true},"subscriber_title":{"type":["null","string"],"readOnly":true},"subscriber_thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"total_item_count":{"type":["null","integer"],"readOnly":true},"new_item_count":{"type":["null","integer"],"readOnly":true}},"required":["channel_id"],"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/video-categories":{"get":{"operationId":"youtubeVideoCategoriesList","summary":"YouTube: List Video categories","tags":["Focus · YouTube"],"description":"Categories for a region · quota: 1 unit (videoCategories.list). Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://developers.google.com/youtube/v3/docs/videoCategories Generic route: `/v1/accounts/{accountId}/focus/video-categories`.","parameters":[{"schema":{"type":"string","default":"US"},"in":"query","name":"region_code","required":false},{"schema":{"type":"string"},"in":"query","name":"hl","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-video-categories-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","readOnly":true},"assignable":{"type":"boolean","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/languages":{"get":{"operationId":"youtubeLanguagesList","summary":"YouTube: List Languages","tags":["Focus · YouTube"],"description":"i18n languages · quota: 1 unit (i18nLanguages.list). Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://developers.google.com/youtube/v3/docs/i18nLanguages Generic route: `/v1/accounts/{accountId}/focus/languages`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"hl","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-languages-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"code":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/regions":{"get":{"operationId":"youtubeRegionsList","summary":"YouTube: List Regions","tags":["Focus · YouTube"],"description":"i18n regions · quota: 1 unit (i18nRegions.list). Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://developers.google.com/youtube/v3/docs/i18nRegions Generic route: `/v1/accounts/{accountId}/focus/regions`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"hl","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-regions-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"code":{"type":"string","readOnly":true},"name":{"type":"string","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/abuse-reports":{"get":{"operationId":"youtubeAbuseReportsList","summary":"YouTube: List Report abuse","tags":["Focus · YouTube"],"description":"Abuse report reasons · quota: 1 unit (videoAbuseReportReasons.list). Abuse report reasons; report a video. Cursor pagination: pass `next_cursor` back as `cursor`. Network docs: https://developers.google.com/youtube/v3/docs/videos/reportAbuse Generic route: `/v1/accounts/{accountId}/focus/abuse-reports`.","parameters":[{"schema":{"type":"string"},"in":"query","name":"hl","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-abuse-reports-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"label":{"type":"string","readOnly":true},"secondary_reasons":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}}},"readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/abuse-reports/report":{"post":{"operationId":"youtubeAbuseReportsReport","summary":"YouTube: Report a video (Report abuse)","tags":["Focus · YouTube"],"description":"videos.reportAbuse · quota: 50 units (videos.reportAbuse). Abuse report reasons; report a video. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/videos/reportAbuse Generic route: `/v1/accounts/{accountId}/focus/abuse-reports`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"video_id":{"type":"string"},"reason_id":{"type":"string"},"secondary_reason_id":{"type":"string"},"comments":{"type":"string"},"language":{"type":"string"}},"required":["video_id","reason_id"]}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["write"]}],"x-access":"write","x-kind":"destructive","x-toolset":"focus_youtube","x-mcp-tool":"youtube-abuse-reports-report","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["focus_action_result"]},"platform":{"type":"string"},"resource":{"type":"string"},"action":{"type":"string"},"id":{"type":["null","string"]},"result":{"description":"The action's return value (object, array, scalar or null)"}},"required":["object","platform","resource","action","id"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/accounts/{accountId}/youtube/managed-channels":{"get":{"operationId":"youtubeManagedChannelsList","summary":"YouTube: List Managed channels","tags":["Focus · YouTube"],"description":"Managed channels · quota: 1 unit (channels.list). YouTube CMS content owners: channels managed by this content owner. Cursor pagination: pass `next_cursor` back as `cursor`. Requires scopes: https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/list Generic route: `/v1/accounts/{accountId}/focus/managed-channels`.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1,"maxLength":80},"example":"sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd","in":"path","name":"accountId","required":true,"description":"Social account id (sa_…)"}],"security":[{"ApiKey":[]},{"OAuth2":["read"]}],"x-access":"read","x-kind":"read","x-toolset":"focus_youtube","x-mcp-tool":"youtube-managed-channels-list","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true},"title":{"type":"string","description":"Not editable via the API","readOnly":true},"handle":{"type":["null","string"],"readOnly":true},"custom_url":{"type":["null","string"],"readOnly":true},"description":{"type":"string","maxLength":1000},"keywords":{"type":"array","items":{"type":"string"},"description":"Channel tags"},"country":{"type":["null","string"],"description":"ISO 3166-1 alpha-2"},"default_language":{"type":["null","string"]},"unsubscribed_trailer":{"type":["null","string"],"description":"Video id shown to non-subscribers (public/unlisted, owned)"},"tracking_analytics_account_id":{"type":["null","string"],"description":"Google Analytics property id"},"self_declared_made_for_kids":{"type":["null","boolean"],"description":"Channel-level made for kids"},"made_for_kids":{"type":["null","boolean"],"readOnly":true},"thumbnail_url":{"type":["null","string"],"format":"uri","readOnly":true},"banner_url":{"type":["null","string"],"format":"uri","readOnly":true},"subscriber_count":{"type":["null","integer"],"readOnly":true},"hidden_subscriber_count":{"type":["null","boolean"],"readOnly":true},"video_count":{"type":["null","integer"],"readOnly":true},"view_count":{"type":["null","integer"],"readOnly":true},"uploads_playlist_id":{"type":["null","string"],"readOnly":true},"privacy_status":{"type":["null","string"],"readOnly":true},"long_uploads_status":{"type":["null","string"],"readOnly":true},"published_at":{"type":"string","format":"date-time","readOnly":true},"topic_categories":{"type":"array","items":{"type":"string","format":"uri"},"readOnly":true},"url":{"type":"string","format":"uri","readOnly":true}},"additionalProperties":true}},"limit":{"type":["null","integer"]},"total":{"type":["null","integer"]},"has_more":{"type":"boolean"},"next_cursor":{"type":["null","string"]},"next_page_url":{"type":["null","string"]},"previous_page_url":{"type":["null","string"]}},"required":["object","data","has_more","next_cursor"]}}}},"4XX":{"description":"Client error (`invalid_request_error`, `authentication_error`, `permission_error`, `not_found_error`, `conflict_error`, `plan_limit_error`, `rate_limit_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Server or upstream network error (`api_error`, `platform_error`)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"servers":[{"url":"https://api.socialit.com","description":"Production"}],"security":[{"ApiKey":[]},{"OAuth2":[]}],"externalDocs":{"description":"Socialit developer docs","url":"https://socialit.com/docs/"},"tags":[{"name":"Accounts","description":"Profiles, account groups, connected social accounts and connect flows.","x-toolset":"accounts","x-tag-group":"Core"},{"name":"API Keys","description":"Workspace API keys. Keys are stored hashed; the secret is shown once.","x-toolset":"api_keys","x-tag-group":"Core"},{"name":"Webhooks","description":"Signed HTTPS callbacks for workspace events. Each delivery carries `X-Socialit-Signature` (hex HMAC-SHA256 of `${timestamp}.${body}` with the webhook secret) and `X-Socialit-Timestamp`. Failed deliveries retry after 5m, 30m, 2h, 5h, then every 12h (11 attempts); a webhook failing for 3 days is disabled.","x-toolset":"webhooks","x-tag-group":"Core"},{"name":"Events","description":"The workspace event log (the payloads webhooks receive) and the event type catalog.","x-toolset":"webhooks","x-tag-group":"Core"},{"name":"Logs","description":"API request logs (public API + MCP) and the workspace activity log.","x-toolset":"logs","x-tag-group":"Core"},{"name":"Invitations","description":"Email invitations, invite codes and invite links.","x-toolset":"team","x-tag-group":"Core"},{"name":"Users","description":"People with access to the workspace.","x-toolset":"team","x-tag-group":"Core"},{"name":"Posts","description":"Create, schedule and publish posts to connected accounts; track per-account results.","x-toolset":"posts","x-tag-group":"Publishing"},{"name":"Queues","description":"Recurring posting schedules. Posts created with `queue: true` take the next free slot.","x-toolset":"queues","x-tag-group":"Publishing"},{"name":"Media","description":"Upload images, videos and documents for posts (and inbox attachments).","x-toolset":"media","x-tag-group":"Publishing"},{"name":"Templates","description":"Reusable post content with media and network options.","x-toolset":"templates","x-tag-group":"Publishing"},{"name":"Tools","description":"Validate posts and media before publishing; feedback and changelog.","x-toolset":"tools","x-tag-group":"Publishing"},{"name":"Inbox","description":"Unified inbox: direct messages, comments, reviews and mentions across networks, plus messaging settings, X engagement and Reddit discovery.","x-toolset":"inbox","x-tag-group":"Inbox"},{"name":"Analytics","description":"Post and account analytics, platform-native insights and inbox analytics. Dates are UTC days (YYYY-MM-DD). History is limited by the plan (free 30 d, pro 365 d, business 730 d).","x-toolset":"analytics","x-tag-group":"Analytics"},{"name":"Contacts","description":"CRM contacts: one person across platforms, linked to channels (per-account platform identities such as an Instagram or Messenger user ID). Contacts are created automatically from inbound messages; tags and custom fields feed broadcasts, sequences and workflows.","x-toolset":"contacts","x-tag-group":"Automation & CRM"},{"name":"Custom Fields","description":"Contact custom field definitions (text, number, date, boolean, select). Slugs are unique per workspace.","x-toolset":"custom_fields","x-tag-group":"Automation & CRM"},{"name":"Broadcasts","description":"Bulk sends to contacts on one account (Messenger / Instagram within the 24 h window or with HUMAN_AGENT, X, Bluesky…), rate limited per channel with per-recipient delivery status. Each recipient is one message.","x-toolset":"broadcasts","x-tag-group":"Automation & CRM"},{"name":"Sequences","description":"Time-based drips: ordered steps (delay, message, optional condition) sent to enrolled contacts on one account; contacts exit on reply or unsubscribe.","x-toolset":"sequences","x-tag-group":"Automation & CRM"},{"name":"Workflows","description":"Event-driven automation graphs: a trigger (message, keyword, comment, referral, reaction, contact change, API call, schedule) and nodes (send message, reply / private reply, wait, condition, HTTP request, AI reply with Claude, tags, fields, sequences, assignment). Every graph change records a version; runs are durable and have a timeline.","x-toolset":"workflows","x-tag-group":"Automation & CRM"},{"name":"Comment Automations","description":"Comment-to-DM (ManyChat-style): keyword rules per account or post answer comments with a private DM (Instagram, Facebook) and / or a public reply (also TikTok, Threads, LinkedIn, YouTube, Bluesky, Reddit), with audience filters, follow gates, repeat policies and tracked links. Each comment is answered at most once.","x-toolset":"comment_automations","x-tag-group":"Automation & CRM"},{"name":"Telephony","description":"Phone numbers, SMS / MMS, voice, RCS, iMessage, Branded Calling and Verify.","x-toolset":"telephony","x-tag-group":"Messaging"},{"name":"Ads","description":"Unified ads across Meta, Google, LinkedIn, TikTok, Pinterest, X, Reddit and OpenAI (ChatGPT) Ads: connections, campaigns, ad sets, ads, creatives, insights, targeting, audiences, Google Ads specifics, Ad Library, Reach & Frequency.","x-toolset":"ads","x-tag-group":"Ads"},{"name":"Ads: accounts & measurement","description":"Ad accounts, account-level ad management, tracking tags, lead gen, product catalogs and conversions.","x-toolset":"ads_measurement","x-tag-group":"Ads"},{"name":"Platform tools","description":"Network-specific tools on a connected account: Google Business Profile listing, reviews, media and verification; Facebook Pages; LinkedIn organizations and mentions; Instagram stories, audio and discovery; Pinterest boards; YouTube playlists and transcripts; Reddit subreddits, flairs and votes; TikTok creator info; Discord server management; Bluesky settings.","x-toolset":"platform_tools","x-tag-group":"Platform tools"},{"name":"Focus","description":"Focus mode: everything a network's API allows for one connected account. The manifest lists the resources (with JSON schemas for tables and forms); the generic operations run them. Typed per-network aliases live under the \"Focus · <Network>\" tags.","x-toolset":"focus","x-tag-group":"Focus mode"},{"name":"Focus · Bluesky","description":"Typed Focus mode operations for Bluesky accounts, generated from the Bluesky focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_bluesky","x-tag-group":"Focus mode"},{"name":"Focus · Discord","description":"Typed Focus mode operations for Discord accounts, generated from the Discord focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_discord","x-tag-group":"Focus mode"},{"name":"Focus · Facebook Page","description":"Typed Focus mode operations for Facebook Page accounts, generated from the Facebook Page focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_facebook","x-tag-group":"Focus mode"},{"name":"Focus · Google Business Profile","description":"Typed Focus mode operations for Google Business Profile accounts, generated from the Google Business Profile focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_google_business","x-tag-group":"Focus mode"},{"name":"Focus · Instagram","description":"Typed Focus mode operations for Instagram accounts, generated from the Instagram focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_instagram","x-tag-group":"Focus mode"},{"name":"Focus · LinkedIn","description":"Typed Focus mode operations for LinkedIn accounts, generated from the LinkedIn focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_linkedin","x-tag-group":"Focus mode"},{"name":"Focus · Mastodon","description":"Typed Focus mode operations for Mastodon accounts, generated from the Mastodon focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_mastodon","x-tag-group":"Focus mode"},{"name":"Focus · Pinterest","description":"Typed Focus mode operations for Pinterest accounts, generated from the Pinterest focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_pinterest","x-tag-group":"Focus mode"},{"name":"Focus · Reddit","description":"Typed Focus mode operations for Reddit accounts, generated from the Reddit focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_reddit","x-tag-group":"Focus mode"},{"name":"Focus · Snapchat","description":"Typed Focus mode operations for Snapchat accounts, generated from the Snapchat focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_snapchat","x-tag-group":"Focus mode"},{"name":"Focus · Threads","description":"Typed Focus mode operations for Threads accounts, generated from the Threads focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_threads","x-tag-group":"Focus mode"},{"name":"Focus · TikTok","description":"Typed Focus mode operations for TikTok accounts, generated from the TikTok focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_tiktok","x-tag-group":"Focus mode"},{"name":"Focus · X","description":"Typed Focus mode operations for X accounts, generated from the X focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_x","x-tag-group":"Focus mode"},{"name":"Focus · YouTube","description":"Typed Focus mode operations for YouTube accounts, generated from the YouTube focus module (same behaviour as the generic /accounts/{accountId}/focus routes).","x-toolset":"focus_youtube","x-tag-group":"Focus mode"},{"name":"Billing","description":"Plans, subscriptions, payment methods, invoices, usage and prepaid credits.","x-toolset":"billing","x-tag-group":"Account & billing"},{"name":"Connected Apps","description":"Third-party apps and AI agents connected with OAuth.","x-toolset":"account","x-tag-group":"Account & billing"},{"name":"Support Assistant","description":"Ask Socialit support questions (failed posts, account connection, API usage). Answers are generated with Claude, grounded on the Socialit documentation and on the context you pass (post, account, failed request). Runs are asynchronous: poll the run or listen to support_run.completed.","x-toolset":"support","x-tag-group":"Account & billing"}],"x-tagGroups":[{"name":"Core","description":"Profiles, connected social accounts and connect flows, API keys, webhooks, events, logs and the team.","tags":["Accounts","API Keys","Webhooks","Events","Logs","Invitations","Users"]},{"name":"Publishing","description":"Posts, queues, media, templates and validation tools.","tags":["Posts","Queues","Media","Templates","Tools"]},{"name":"Inbox","description":"Direct messages, comments, reviews and mentions across networks.","tags":["Inbox"]},{"name":"Analytics","description":"Post, account, platform-native and inbox analytics.","tags":["Analytics"]},{"name":"Automation & CRM","description":"Contacts, custom fields, broadcasts, sequences, workflows and comment-to-DM automations.","tags":["Contacts","Custom Fields","Broadcasts","Sequences","Workflows","Comment Automations"]},{"name":"Messaging","description":"Phone numbers, SMS, voice, RCS and iMessage.","tags":["Telephony"]},{"name":"Ads","description":"Ads connections, campaigns, ad sets, ads, audiences, insights, lead gen and conversions.","tags":["Ads","Ads: accounts & measurement"]},{"name":"Platform tools","description":"Network-specific helpers on one connected account.","tags":["Platform tools"]},{"name":"Focus mode","description":"Everything a network API allows for one connected account: the generic manifest operations and the typed per-network operations (Focus · <Network>).","tags":["Focus","Focus · Bluesky","Focus · Discord","Focus · Facebook Page","Focus · Google Business Profile","Focus · Instagram","Focus · LinkedIn","Focus · Mastodon","Focus · Pinterest","Focus · Reddit","Focus · Snapchat","Focus · Threads","Focus · TikTok","Focus · X","Focus · YouTube"]},{"name":"Account & billing","description":"Plans, subscriptions, usage, connected apps and the support assistant.","tags":["Billing","Connected Apps","Support Assistant"]}],"x-mcp":{"url":"https://api.socialit.com/mcp","transport":"streamable-http","toolsets":["accounts","api_keys","webhooks","logs","team","posts","queues","media","templates","tools","inbox","analytics","contacts","custom_fields","broadcasts","sequences","workflows","comment_automations","telephony","ads","ads_measurement","platform_tools","focus","focus_bluesky","focus_discord","focus_facebook","focus_google_business","focus_instagram","focus_linkedin","focus_mastodon","focus_pinterest","focus_reddit","focus_snapchat","focus_threads","focus_tiktok","focus_x","focus_youtube","billing","account","support"]}}