[{"name":"sosoapi_get_user_profile","title":"Get user profile","description":"Read the signed-in user's own profile (display name, timezone, avatar, theme); profile is null until one exists.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"include_version":{"description":"Optional. true adds the resource version to the answer.","type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"action":{"type":"string","const":"get"},"profile":{"anyOf":[{"type":"object","properties":{"user_id":{"type":"string","format":"uuid"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"avatar_preview_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"avatar_preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"theme":{"anyOf":[{"type":"string","enum":["light","dark","system"]},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deletion_scheduled_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"hard_delete_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["user_id","display_name","timezone","avatar_url","theme","created_at","updated_at","deletion_scheduled_at","hard_delete_at"],"additionalProperties":false},{"type":"null"}]}},"required":["action","profile"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/user/profile/get"],"slug":"get-user-profile"},{"name":"sosoapi_update_user_profile","title":"Update user profile","description":"Change the signed-in user's own profile (display_name, timezone, avatar_url, theme). Send only the fields to change.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"display_name":{"type":"string","minLength":0,"maxLength":120},"timezone":{"type":"string","minLength":1,"maxLength":64},"avatar_url":{"type":"string","minLength":0,"maxLength":2048},"theme":{"type":"string","enum":["light","dark","system"]},"expected_version":{"description":"Optional. The version you read. If it changed since, the update fails with 409 VERSION_CONFLICT instead of overwriting.","type":"integer","exclusiveMinimum":0,"maximum":2147483647},"include_version":{"description":"Optional. true adds the resource version to the answer.","type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"action":{"type":"string","const":"update"},"profile":{"type":"object","properties":{"user_id":{"type":"string","format":"uuid"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"avatar_preview_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"avatar_preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"theme":{"anyOf":[{"type":"string","enum":["light","dark","system"]},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deletion_scheduled_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"hard_delete_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["user_id","display_name","timezone","avatar_url","theme","created_at","updated_at","deletion_scheduled_at","hard_delete_at"],"additionalProperties":false}},"required":["action","profile"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/user/profile/update"],"slug":"update-user-profile"},{"name":"sosoapi_sign_avatar_upload","title":"Sign avatar upload","description":"Get a signed URL for uploading a new avatar image for the signed-in user (filename and content_type required). Does not change the profile by itself.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":256},"content_type":{"type":"string","pattern":"^image\\/(png|jpeg|jpg|gif|webp)$"},"byte_size":{"description":"Exact avatar size in bytes (max 5 MiB); signed into the upload URL","type":"integer","minimum":1,"maximum":5242880}},"required":["filename","content_type"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"action":{"type":"string","const":"sign-avatar-url"},"path":{"type":"string"},"signed_url":{"type":"string","format":"uri"},"token":{"type":"string"}},"required":["action","path","signed_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/user/profile/sign-avatar-url"],"slug":"sign-avatar-upload"},{"name":"sosoapi_list_api_keys","title":"List API keys","description":"List the user's API keys (name, last 4 characters, status, expiry, lineage); set include_authority to also get each key's capabilities and Workspace limit. Secrets are never returned. Needs the Manage API keys grant; a PAT cannot use it.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"include_revoked":{"type":"boolean"},"include_authority":{"description":"Also return each key's capabilities, Workspace limit (null = every Workspace) and the delegated grant that created it.","type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"apiKeys":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"last_used_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"status":{"type":"string","enum":["active","expired","revoked"]},"replaces":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"status":{"type":"string","enum":["active","expired","revoked"]}},"required":["id","name","last_4","status"],"additionalProperties":false},{"type":"null"}]},"replaced_by":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"status":{"type":"string","enum":["active","expired","revoked"]}},"required":["id","name","last_4","status"],"additionalProperties":false}},"capabilities":{"type":"array","items":{"type":"string","enum":["agent:operate","agent:publish","agent:engage"]}},"workspace_ids":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}]},"created_by_delegated_grant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}},"required":["id","name","last_4","scopes","created_at","expires_at","last_used_at","revoked_at","status","replaces","replaced_by"],"additionalProperties":false}}},"required":["apiKeys"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/api-keys/list"],"slug":"list-api-keys"},{"name":"sosoapi_create_api_key","title":"Create API key","description":"Create a personal access key with chosen capabilities (agent:operate, agent:publish, agent:engage), an optional workspace_ids limit and a lifetime of up to 365 days; the secret is returned once and cannot be read again. An agent can grant only what its own authorization holds, for at most 30 days, and the key stops working when that grant ends. Needs the Manage API keys grant; a PAT cannot use it.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"lifetime_days":{"description":"Days until the key expires (1-365, default 365). A key created by a delegated agent never lives longer than 30 days.","type":"integer","minimum":1,"maximum":365},"capabilities":{"description":"What the key may do. Defaults to operate, publish and engage for a signed-in user. A delegated agent can only grant what its own authorization holds (never key management).","minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["agent:operate","agent:publish","agent:engage"]}},"workspace_ids":{"description":"Limit the key to these Workspaces. Omit it for every Workspace the user can access. A limited key must name its Workspace (workspace_id) on routes that would otherwise use the active Workspace, and cannot call organization-wide reads.","minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid"}},"scopes":{"description":"Deprecated alias of capabilities. It is honoured exactly; an empty list is ignored.","maxItems":3,"type":"array","items":{"type":"string","enum":["agent:operate","agent:publish","agent:engage"]}},"idempotency_key":{"description":"Optional. Reuse the same key to retry safely. The secret is shown once: a retry that finds the key already created answers 409 IDEMPOTENT_REPLAY (details.existing_key names it) instead of showing it again. Revoke that key and create a new one with a new idempotency_key.","type":"string","minLength":8,"maxLength":160,"pattern":"^[!-~]+$"}},"required":["name"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"last_used_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"status":{"type":"string","enum":["active","expired","revoked"]},"replaces":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"status":{"type":"string","enum":["active","expired","revoked"]}},"required":["id","name","last_4","status"],"additionalProperties":false},{"type":"null"}]},"replaced_by":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"status":{"type":"string","enum":["active","expired","revoked"]}},"required":["id","name","last_4","status"],"additionalProperties":false}},"capabilities":{"type":"array","items":{"type":"string","enum":["agent:operate","agent:publish","agent:engage"]}},"workspace_ids":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}]},"created_by_delegated_grant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}},"required":["id","name","last_4","scopes","created_at","expires_at","last_used_at","revoked_at","status","replaces","replaced_by"],"additionalProperties":false},"secret":{"type":"string","minLength":1}},"required":["apiKey","secret"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/api-keys/create"],"slug":"create-api-key"},{"name":"sosoapi_extend_api_key","title":"Extend API key","description":"Set a later expiry (expires_at) on an API key identified by id: at most 365 days from now, or 30 for a key an agent created. An agent can extend only keys its own grant created. Needs the Manage API keys grant.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"Requested new absolute expiry. The longest lifetime is 365 days from now, or 30 days for a key created by a delegated agent. A signed-in person extending their own key is granted that longest lifetime when they ask for a later time (up to 3,650 days from now); in every other case a later time is refused with API_KEY_LIFETIME_EXCEEDS_CAP. The response carries the expiry actually applied."}},"required":["id","expires_at"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"last_used_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"status":{"type":"string","enum":["active","expired","revoked"]},"replaces":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"status":{"type":"string","enum":["active","expired","revoked"]}},"required":["id","name","last_4","status"],"additionalProperties":false},{"type":"null"}]},"replaced_by":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"status":{"type":"string","enum":["active","expired","revoked"]}},"required":["id","name","last_4","status"],"additionalProperties":false}},"capabilities":{"type":"array","items":{"type":"string","enum":["agent:operate","agent:publish","agent:engage"]}},"workspace_ids":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}]},"created_by_delegated_grant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}},"required":["id","name","last_4","scopes","created_at","expires_at","last_used_at","revoked_at","status","replaces","replaced_by"],"additionalProperties":false},"idempotent":{"type":"boolean"}},"required":["apiKey","idempotent"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/api-keys/extend"],"slug":"extend-api-key"},{"name":"sosoapi_renew_api_key","title":"Renew API key","description":"Create a successor for an API key (id) with a new secret returned once and the same capabilities and Workspace limit, optionally a new name or lifetime (365 days at most, 30 for an agent-created key). The original key is not revoked. Needs the Manage API keys grant.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":80},"lifetime_days":{"description":"Days until the successor expires (1-365, default 365; 30 at most for a key created by a delegated agent). The successor keeps the predecessor's capabilities and Workspace limit.","type":"integer","minimum":1,"maximum":365},"idempotency_key":{"description":"Optional. Reuse the same key to retry safely. The new secret is shown once: a retry that finds the successor already created answers 409 IDEMPOTENT_REPLAY (details.existing_key names it). Revoke it and renew again with a new idempotency_key.","type":"string","minLength":8,"maxLength":160,"pattern":"^[!-~]+$"}},"required":["id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"last_used_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"status":{"type":"string","enum":["active","expired","revoked"]},"replaces":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"status":{"type":"string","enum":["active","expired","revoked"]}},"required":["id","name","last_4","status"],"additionalProperties":false},{"type":"null"}]},"replaced_by":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"last_4":{"type":"string"},"status":{"type":"string","enum":["active","expired","revoked"]}},"required":["id","name","last_4","status"],"additionalProperties":false}},"capabilities":{"type":"array","items":{"type":"string","enum":["agent:operate","agent:publish","agent:engage"]}},"workspace_ids":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}]},"created_by_delegated_grant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}},"required":["id","name","last_4","scopes","created_at","expires_at","last_used_at","revoked_at","status","replaces","replaced_by"],"additionalProperties":false},"secret":{"type":"string","minLength":1}},"required":["apiKey","secret"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/api-keys/renew"],"slug":"renew-api-key"},{"name":"sosoapi_revoke_api_key","title":"Revoke API key","description":"Revoke an API key by id so it stops working immediately; an already-revoked key reports already_revoked. An agent can revoke only keys its own grant created. Needs the Manage API keys grant.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"already_revoked":{"type":"boolean"}},"required":["ok","already_revoked"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/api-keys/revoke"],"slug":"revoke-api-key"},{"name":"sosoapi_get_billing_status","title":"Get billing status","description":"Read the user's billing plan, payment state, current cycle dates and quota usage (successful publishes, pending scheduled posts, connected accounts). Check it before large scheduling runs.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"billing_account_id":{"type":"string","format":"uuid"},"plan_key":{"type":"string","enum":["free","founding_pro"]},"plan_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"payment_state":{"type":"string","minLength":1,"maxLength":64},"entitlement_source":{"type":"string","enum":["default","stripe","internal_test","reconciliation","manual"]},"has_stripe_customer":{"type":"boolean"},"checkout_enabled":{"type":"boolean"},"cycle":{"type":"object","properties":{"period_start":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"period_end":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"reset_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["period_start","period_end","reset_at"],"additionalProperties":false},"quota":{"type":"object","properties":{"successful_destination_publishes":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"reserved":{"type":"integer","minimum":0,"maximum":9007199254740991},"consumed":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["limit","reserved","consumed","remaining"],"additionalProperties":false},"pending_scheduled_posts":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"active":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["limit","active","remaining"],"additionalProperties":false},"connected_social_accounts":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"active":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["limit","active","remaining"],"additionalProperties":false}},"required":["successful_destination_publishes","pending_scheduled_posts","connected_social_accounts"],"additionalProperties":false},"history_days":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"capabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["billing_account_id","plan_key","plan_version","payment_state","entitlement_source","has_stripe_customer","checkout_enabled","cycle","quota","history_days","capabilities"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/billing/status"],"slug":"get-billing-status"},{"name":"sosoapi_get_commercial_access","title":"Get commercial access","description":"Read plan and quota facts for one Workspace's billing account, plus its commercial_access_mode (off, shadow or enforce).","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"billing_account_id":{"type":"string","format":"uuid"},"plan_key":{"type":"string","enum":["free","founding_pro"]},"plan_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"payment_state":{"type":"string","minLength":1,"maxLength":64},"entitlement_source":{"type":"string","enum":["default","stripe","internal_test","reconciliation","manual"]},"has_stripe_customer":{"type":"boolean"},"cycle":{"type":"object","properties":{"period_start":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"period_end":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"reset_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["period_start","period_end","reset_at"],"additionalProperties":false},"quota":{"type":"object","properties":{"successful_destination_publishes":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"reserved":{"type":"integer","minimum":0,"maximum":9007199254740991},"consumed":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["limit","reserved","consumed","remaining"],"additionalProperties":false},"pending_scheduled_posts":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"active":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["limit","active","remaining"],"additionalProperties":false},"connected_social_accounts":{"type":"object","properties":{"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"active":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["limit","active","remaining"],"additionalProperties":false}},"required":["successful_destination_publishes","pending_scheduled_posts","connected_social_accounts"],"additionalProperties":false},"history_days":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"capabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"actor_user_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"billing_account_kind":{"type":"string","const":"personal"},"commercial_access_mode":{"type":"string","enum":["off","shadow","enforce"]}},"required":["billing_account_id","plan_key","plan_version","payment_state","entitlement_source","has_stripe_customer","cycle","quota","history_days","capabilities","actor_user_id","workspace_id","billing_account_kind","commercial_access_mode"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/commercial-access/status"],"slug":"get-commercial-access"},{"name":"sosoapi_get_organization_context","title":"Get Organization context","description":"Read the live map of your Organizations, their Workspaces and Channels with ids and roles. Use it when Organization or Channel ids are needed. For Workspace posting, reuse a returned Workspace id; do not also read workspace context.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"organization_id":{"type":"string","format":"uuid"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"organization-agent-context/v1"},"organizations":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"role":{"type":"string","enum":["owner","admin","member"]},"status":{"type":"string","enum":["active","deletion_pending","deleted"]},"workspaces":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"role":{"anyOf":[{"type":"string","enum":["owner","editor","reviewer","viewer"]},{"type":"null"}]},"channels":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organization_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"status":{"type":"string","enum":["setup_incomplete","attached","action_required","disconnected"]}},"required":["id","organization_id","workspace_id","platform","status"],"additionalProperties":false}}},"required":["id","name","role","channels"],"additionalProperties":false}}},"required":["id","name","role","status","workspaces"],"additionalProperties":false}}},"required":["contract_version","organizations"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/agent/organization-context"],"slug":"get-organization-context"},{"name":"sosoapi_create_workspace","title":"Create Workspace","description":"Create a Workspace in an Organization you own or administer. Pass organization_id when you belong to multiple Organizations. Use the returned id for your next calls: do not assume the new Workspace becomes the active one.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"organization_id":{"type":"string","format":"uuid"},"idempotency_key":{"description":"Optional. Reuse the same key to retry safely: a retry returns the original result instead of acting twice.","type":"string","minLength":8,"maxLength":160,"pattern":"^[!-~]+$"}},"required":["name"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organization_id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"created_at":{"type":"string"}},"required":["id","organization_id","slug","name","created_at"],"additionalProperties":false}},"required":["workspace"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/workspace/create"],"slug":"create-workspace"},{"name":"sosoapi_get_workspace_context","title":"Get Workspace context","description":"List the Workspaces the signed-in user belongs to and which one is active. Use this when workspace_id is unknown; reuse live context instead of repeating both context reads. The active Workspace it reports is the selection a person made in the web app, not a default for your calls: pass workspace_id explicitly. It is not purely a read: for an account with no Workspace it creates the first one.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"include_version":{"description":"Optional. true adds the resource version to the answer.","type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"active_workspace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"workspaces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["owner","editor","reviewer","viewer"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","slug","name","role"],"additionalProperties":false}}},"required":["active_workspace_id","workspaces"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/workspace/list"],"slug":"get-workspace-context"},{"name":"sosoapi_update_workspace","title":"Update Workspace","description":"Rename a Workspace or change its slug. Workspace owner only.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"expected_version":{"description":"Optional. The version you read. If it changed since, the update fails with 409 VERSION_CONFLICT instead of overwriting.","type":"integer","exclusiveMinimum":0,"maximum":2147483647},"include_version":{"description":"Optional. true adds the resource version to the answer.","type":"boolean"}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","slug","name"],"additionalProperties":false}},"required":["workspace"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/workspace/update"],"slug":"update-workspace"},{"name":"sosoapi_list_organizations","title":"List organizations","description":"List the Organizations the signed-in user belongs to, with the ids that Organization-scoped tools take as organization_id.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"organizations":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1},"role":{"type":"string","enum":["owner","admin","member"]},"status":{"type":"string","enum":["active","deletion_pending","deleted"]},"workspace_ids":{"maxItems":100,"type":"array","items":{"type":"string","format":"uuid"}}},"required":["id","name","role","status","workspace_ids"],"additionalProperties":false}}},"required":["organizations"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/organization/list"],"slug":"list-organizations"},{"name":"sosoapi_list_organization_connections","title":"List organization connections","description":"List an Organization's provider connections (Meta, Instagram, Threads, YouTube) and their status. Needs organization_id.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"organization_id":{"type":"string","format":"uuid"}},"required":["organization_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"connections":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organization_id":{"type":"string","format":"uuid"},"provider":{"type":"string","enum":["meta","instagram","threads","google_youtube","x"]},"provider_principal":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["active","action_required","unlinked"]},"provider_revoke_state":{"type":"string","enum":["not_requested","pending","succeeded","failed","unknown"]},"granted_scopes":{"type":"array","items":{"type":"string"}},"source":{"type":"string","enum":["oauth_v1","legacy_imported"]},"authorized_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"last_discovered_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","organization_id","provider","provider_principal","state","provider_revoke_state","granted_scopes","source","authorized_at","last_discovered_at"],"additionalProperties":false}}},"required":["connections"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/organization/connections/list"],"slug":"list-organization-connections"},{"name":"sosoapi_review_organization_connection","title":"Review organization connection","description":"Read the provider accounts and pages discovered by one pending connection operation (operation_id) so they can be reviewed. Read-only: a human confirms the connection in the web app.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"organization_id":{"type":"string","format":"uuid"},"operation_id":{"type":"string","format":"uuid"}},"required":["organization_id","operation_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"operation_id":{"type":"string","format":"uuid"},"organization_id":{"type":"string","format":"uuid"},"provider":{"type":"string","enum":["meta","instagram","threads","google_youtube","x"]},"status":{"type":"string","enum":["review_required","confirming","partially_confirmed","confirmed","failed","expired"]},"resources":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"resource_type":{"type":"string","minLength":1},"provider_resource_id":{"type":"string","minLength":1},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"display_username":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_tasks":{"type":"array","items":{"type":"string"}},"provider_permissions":{"type":"array","items":{"type":"string"}},"capability_facts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"discovery_status":{"type":"string","enum":["discovered","action_required","unavailable","unknown"]},"selection_state":{"type":"string","enum":["unselected","selected","attached","superseded"]}},"required":["id","resource_type","provider_resource_id","display_name","display_username","provider_tasks","provider_permissions","capability_facts","discovery_status","selection_state"],"additionalProperties":false}}},"required":["operation_id","organization_id","provider","status","resources"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/organization/connections/review"],"slug":"review-organization-connection"},{"name":"sosoapi_list_organization_channels","title":"List organization channels","description":"List an Organization's channels (connected provider accounts) and which Workspace each is attached to.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"organization_id":{"type":"string","format":"uuid"}},"required":["organization_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"channels":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organization_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"resource_type":{"type":"string","minLength":1},"provider_resource_id":{"type":"string","minLength":1},"home_workspace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"attachment_state":{"type":"string","enum":["setup_incomplete","attached","action_required","disconnected"]},"legacy_review_state":{"type":"string","enum":["not_required","workspace_duplicate_required","completed"]},"transition_state":{"type":"string","enum":["stable","moving","disconnecting"]},"operation_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"account_ids":{"maxItems":100,"type":"array","items":{"type":"string","format":"uuid"}}},"required":["id","organization_id","platform","resource_type","provider_resource_id","home_workspace_id","attachment_state","legacy_review_state","transition_state","operation_revision","account_ids"],"additionalProperties":false}}},"required":["channels"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/organization/channels/list"],"slug":"list-organization-channels"},{"name":"sosoapi_preview_organization_channel_move","title":"Preview channel move","description":"Dry run: check whether a channel can move to another Workspace and list what blocks it. Changes nothing.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"organization_id":{"type":"string","format":"uuid"},"channel_id":{"type":"string","format":"uuid"},"target_workspace_id":{"type":"string","format":"uuid"}},"required":["organization_id","channel_id","target_workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"channel_id":{"type":"string","format":"uuid"},"source_workspace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"target_workspace_id":{"type":"string","format":"uuid"},"operation_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"can_move":{"type":"boolean"},"blockers":{"maxItems":50,"type":"array","items":{"type":"string"}},"dependency_hash":{"type":"string","minLength":1}},"required":["channel_id","source_workspace_id","target_workspace_id","operation_revision","can_move","blockers","dependency_hash"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/organization/channels/move/preview"],"slug":"preview-organization-channel-move"},{"name":"sosoapi_list_workspace_members","title":"List Workspace members","description":"List a Workspace's members and its pending invitations.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string","format":"uuid"},"email":{"anyOf":[{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"role":{"type":"string","enum":["owner","editor","reviewer","viewer"]},"joined_at":{"type":"string"}},"required":["user_id","email","role","joined_at"],"additionalProperties":false}},"pending_invites":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"expires_at":{"type":"string"}},"required":["id","email","expires_at"],"additionalProperties":false}}},"required":["members","pending_invites"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/member/list"],"slug":"list-workspace-members"},{"name":"sosoapi_submit_feedback","title":"Submit feedback","description":"Send product feedback (type bug, feature or general; up to 4,000 characters) to the SosoAPI team on the user's behalf. Use only when the user asks.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"type":{"type":"string","enum":["bug","feature","general"]},"message":{"type":"string","minLength":1,"maxLength":4000},"idempotency_key":{"description":"Optional. Reuse the same key to retry safely: a retry returns the original result instead of acting twice.","type":"string","minLength":8,"maxLength":160,"pattern":"^[!-~]+$"}},"required":["type","message"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"id":{"type":"string","format":"uuid"},"created_at":{"type":"string"}},"required":["ok","id","created_at"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/feedback/submit"],"slug":"submit-feedback"},{"name":"sosoapi_get_notification_preferences","title":"Get notification preferences","description":"Read the user's notification settings (currently whether an email is sent when a post fails).","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"prefs":{"type":"object","properties":{"email_post_failed":{"type":"boolean"}},"required":["email_post_failed"],"additionalProperties":false}},"required":["prefs"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/user/notifications/get"],"slug":"get-notification-preferences"},{"name":"sosoapi_update_notification_preferences","title":"Update notification preferences","description":"Change the user's notification settings (email_post_failed on or off).","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"email_post_failed":{"type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"prefs":{"type":"object","properties":{"email_post_failed":{"type":"boolean"}},"required":["email_post_failed"],"additionalProperties":false}},"required":["prefs"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/user/notifications/update"],"slug":"update-notification-preferences"},{"name":"sosoapi_list_inbox_notifications","title":"List inbox notifications","description":"Read the user's in-app inbox, newest first (up to 50), optionally only unread or of one kind.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"kind":{"type":"string","minLength":1,"maxLength":64},"unread_only":{"type":"boolean"},"limit":{"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"notifications":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"kind":{"type":"string"},"title":{"type":"string"},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"link_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"payload":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"read_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","workspace_id","kind","title","body","link_url","payload","read_at","created_at"],"additionalProperties":false}}},"required":["notifications"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/user/inbox/list"],"slug":"list-inbox-notifications"},{"name":"sosoapi_list_connected_accounts","title":"List connected accounts","description":"List the social accounts (Instagram, Threads, Facebook, YouTube) connected to a Workspace, with connection health and capability facts. Use their ids as social_account_id when scheduling or commenting. Pass workspace_id: a request without it is refused once explicit targeting is enforced.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"include_authorization_grant":{"type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["instagram","threads","facebook","tiktok","linkedin","youtube","x"]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["valid","expiring_soon","expired","disconnected"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"follower_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"post_count":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"auto_sync_enabled":{"type":"boolean"},"last_synced_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"workspace_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform_user_id":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"instagram_login_mode":{"anyOf":[{"type":"string","enum":["instagram_login","facebook_login"]},{"type":"null"}]},"facebook_page_id":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"blocked_until":{"anyOf":[{"type":"string"},{"type":"null"}]},"block_reason":{"anyOf":[{"type":"string","enum":["transient","account_block","auth_invalid","permanent"]},{"type":"null"}]},"block_subcode":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"block_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"last_block_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"health_state":{"type":"string","enum":["ready","action_required","temporarily_unavailable","publishing_restricted","disconnected","unknown"]},"health_message":{"type":"string","minLength":1,"maxLength":500},"health_observed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorization_grant":{"oneOf":[{"type":"object","properties":{"granted_permissions":{"type":"array","items":{"type":"string","minLength":1}},"inventory_source":{"type":"string","enum":["oauth_token_response","provider_token_debug","provider_permissions_endpoint"]},"inventory_exact":{"type":"boolean","const":true},"observed_at":{"type":"string","minLength":1},"provider_api_version":{"type":"string","minLength":1,"maxLength":40},"oauth_provider":{"type":"string","enum":["instagram","threads","meta","google"]},"oauth_subject_id":{"type":"string","minLength":1}},"required":["granted_permissions","inventory_source","inventory_exact","observed_at","provider_api_version","oauth_provider","oauth_subject_id"],"additionalProperties":false},{"type":"object","properties":{"granted_permissions":{"minItems":0,"maxItems":0,"type":"array","items":{"not":{}}},"inventory_source":{"type":"string","const":"unavailable"},"inventory_exact":{"type":"boolean","const":false},"observed_at":{"type":"null"},"provider_api_version":{"type":"null"},"oauth_provider":{"anyOf":[{"type":"string","enum":["instagram","threads","meta","google"]},{"type":"null"}]},"oauth_subject_id":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["granted_permissions","inventory_source","inventory_exact","observed_at","provider_api_version","oauth_provider","oauth_subject_id"],"additionalProperties":false}]},"current_capability_snapshot_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"capability_facts":{"type":"array","items":{"type":"object","properties":{"capability":{"type":"string","enum":["can_publish_text","can_publish_image","can_publish_video","can_publish_reel","can_publish_carousel","can_publish_first_comment","can_publish_topic_tag","can_publish_link","can_upload_video","can_set_title","can_set_description","can_set_thumbnail","can_set_privacy_status","can_publish_story","can_invite_collaborators","can_tag_products","can_publish_trial_reel","can_publish_partnership","can_delete_media","can_publish_reply","can_quote_post","can_repost","can_publish_poll","can_publish_gif","can_publish_text_attachment","can_publish_ghost_post","can_tag_location","can_crossshare_to_instagram","can_auto_publish_text","can_delete_post","can_publish_multi_image","can_target_post","can_backdate_post","can_manage_native_schedule","can_update_video","can_delete_video","can_set_brand_partner"]},"observed_allowed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"availability":{"type":"string","enum":["available","unavailable","unknown","documented_ambiguous"]},"reason_code":{"type":"string","pattern":"^[a-z0-9_]+$"},"observed_at":{"type":"string"},"valid_until":{"type":"string"},"provider_api_version":{"type":"string","minLength":1,"maxLength":40},"required_permissions":{"type":"array","items":{"type":"string","minLength":1}},"granted_permissions":{"type":"array","items":{"type":"string","minLength":1}},"account_eligibility":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["capability","observed_allowed","availability","reason_code","observed_at","valid_until","provider_api_version","required_permissions","granted_permissions","account_eligibility"],"additionalProperties":false}}},"required":["id","platform","handle","status","expires_at","created_at","health_state","health_message","health_observed_at","current_capability_snapshot_id","capability_facts"],"additionalProperties":false}}},"required":["accounts"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/user/social-accounts/list"],"slug":"list-connected-accounts"},{"name":"sosoapi_disconnect_social_account","title":"Disconnect social account","description":"Disconnect a social account from its Workspace (Workspace owner only). Publishing to it stops until a human reconnects it with `sosoapi connect`.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"account_id":{"type":"string","format":"uuid"}},"required":["account_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/user/social-accounts/disconnect"],"slug":"disconnect-social-account"},{"name":"sosoapi_set_social_account_auto_sync","title":"Set social account auto-sync","description":"Turn automatic sync on or off for one connected social account (editor role). Publishes nothing.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"account_id":{"type":"string","format":"uuid"},"enabled":{"type":"boolean"}},"required":["account_id","enabled"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"enabled":{"type":"boolean"}},"required":["ok","enabled"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/user/social-accounts/set-auto-sync"],"slug":"set-social-account-auto-sync"},{"name":"sosoapi_clear_social_account_block","title":"Clear social account block","description":"Clear a provider cooldown on an account so publishing can resume. It does not retry any failed post; use sosoapi_retry_scheduled_post for that.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"account_id":{"type":"string","format":"uuid"}},"required":["account_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/identity-api/user/social-accounts/clear-block"],"slug":"clear-social-account-block"},{"name":"sosoapi_query_assets","title":"Query assets","description":"Find a Workspace's assets by asset_type, source or tag; returns a page (limit up to 100, plus offset) and the total. Pass workspace_id explicitly.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"asset_type":{"anyOf":[{"type":"string","enum":["text","image","video","audio"]},{"type":"array","items":{"type":"string","enum":["text","image","video","audio"]}}]},"source":{"type":"string","maxLength":64},"tag":{"type":"string","maxLength":64},"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"description":"Rows to skip. Served up to 100000; beyond it 400 OFFSET_TOO_LARGE. Prefer filters to paging deep.","type":"integer","minimum":0,"maximum":9007199254740991},"include_version":{"description":"Optional. true adds the resource version to the answer.","type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"assets":{"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]},"workspace_id":{"type":"string","format":"uuid"},"user_id":{"type":"string","format":"uuid"},"asset_type":{"type":"string","enum":["text","image","video","audio"]},"asset_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"preview_url":{"description":"Workspace-authorized temporary read URL. Refresh through Asset read/list after preview_expires_at; keep asset_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"created_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","user_id","asset_type","asset_url","title","description","tags","metadata","created_at"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["assets","total"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/list"],"slug":"query-assets"},{"name":"sosoapi_get_asset","title":"Get asset","description":"Read one asset by id: metadata and a short-lived preview URL.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]},"include_version":{"description":"Optional. true adds the resource version to the answer.","type":"boolean"}},"required":["id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"asset":{"type":"object","properties":{"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]},"workspace_id":{"type":"string","format":"uuid"},"user_id":{"type":"string","format":"uuid"},"asset_type":{"type":"string","enum":["text","image","video","audio"]},"asset_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"preview_url":{"description":"Workspace-authorized temporary read URL. Refresh through Asset read/list after preview_expires_at; keep asset_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"created_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","user_id","asset_type","asset_url","title","description","tags","metadata","created_at"],"additionalProperties":false}},"required":["asset"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/get"],"slug":"get-asset"},{"name":"sosoapi_create_asset","title":"Create asset","description":"Register an asset record for media or text you already host (asset_url, asset_type). It uploads nothing: use sosoapi_upload_asset for a local file or sosoapi_import_asset_url to have SosoAPI fetch a public URL. Pass workspace_id (refused without it once explicit targeting is enforced). Optional idempotency_key.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"asset_type":{"type":"string","enum":["text","image","video"]},"asset_url":{"type":"string","minLength":1,"maxLength":2048},"title":{"type":"string","maxLength":200},"description":{"type":"string","maxLength":2000},"tags":{"maxItems":50,"type":"array","items":{"type":"string","maxLength":64}},"metadata":{"type":"object","additionalProperties":{},"description":"Free-form JSON object; its serialized UTF-8 size must not exceed 16384 bytes."},"source":{"type":"string","maxLength":64},"source_metadata":{"type":"object","additionalProperties":{},"description":"Free-form JSON object; its serialized UTF-8 size must not exceed 16384 bytes."},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["asset_type","asset_url"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"asset":{"type":"object","properties":{"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]},"workspace_id":{"type":"string","format":"uuid"},"user_id":{"type":"string","format":"uuid"},"asset_type":{"type":"string","enum":["text","image","video","audio"]},"asset_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"preview_url":{"description":"Workspace-authorized temporary read URL. Refresh through Asset read/list after preview_expires_at; keep asset_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"created_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","user_id","asset_type","asset_url","title","description","tags","metadata","created_at"],"additionalProperties":false},"deduped":{"type":"boolean"}},"required":["asset","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/create"],"slug":"create-asset"},{"name":"sosoapi_update_asset","title":"Update asset","description":"Change an asset's title, description or tags (editor role).","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]},"title":{"type":"string","maxLength":200},"description":{"type":"string","maxLength":2000},"tags":{"maxItems":50,"type":"array","items":{"type":"string","maxLength":64}},"expected_version":{"description":"Optional. The version you read. If it changed since, the update fails with 409 VERSION_CONFLICT instead of overwriting.","type":"integer","exclusiveMinimum":0,"maximum":2147483647},"include_version":{"description":"Optional. true adds the resource version to the answer.","type":"boolean"}},"required":["id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"asset":{"type":"object","properties":{"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]},"workspace_id":{"type":"string","format":"uuid"},"user_id":{"type":"string","format":"uuid"},"asset_type":{"type":"string","enum":["text","image","video","audio"]},"asset_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"preview_url":{"description":"Workspace-authorized temporary read URL. Refresh through Asset read/list after preview_expires_at; keep asset_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"created_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","user_id","asset_type","asset_url","title","description","tags","metadata","created_at"],"additionalProperties":false}},"required":["asset"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/update"],"slug":"update-asset"},{"name":"sosoapi_delete_asset","title":"Delete asset","description":"Delete one asset from the Workspace library by id. Workspace owner only.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]}},"required":["id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/delete"],"slug":"delete-asset"},{"name":"sosoapi_list_assets","title":"List assets","description":"List a Workspace's assets filtered by kind (video, image, audio, cover, thumbnail, frame, video-source, branding) or customer_ready_only, with next_offset paging. workspace_id is required.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["video","image","audio","cover","thumbnail","frame","video-source","branding"]},"customer_ready_only":{"type":"boolean"},"limit":{"type":"integer","minimum":1,"maximum":100},"offset":{"description":"Rows to skip. Served up to 100000; beyond it 400 OFFSET_TOO_LARGE.","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["workspace_id"]},"outputSchema":{"type":"object","properties":{"assets":{"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]},"asset_type":{"type":"string","enum":["text","image","video","audio"]},"asset_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_url":{"description":"Workspace-authorized temporary read URL. Refresh through Asset read/list after preview_expires_at; keep asset_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"readiness":{"type":"object","properties":{"status":{"type":"string","enum":["ready","not_ready"]},"reason_code":{"type":"string","enum":["ready","unsupported_kind","missing_registered_media","untrusted_workspace_object","media_probe_missing_or_invalid"]},"message":{"type":"string","minLength":1,"maxLength":500}},"required":["status","reason_code","message"],"additionalProperties":false}},"required":["id","asset_type","asset_url","title","description","tags","created_at","readiness"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"next_offset":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["assets","total","next_offset"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/list-workspace"],"slug":"list-assets"},{"name":"sosoapi_import_asset_url","title":"Import asset URL","description":"Ask SosoAPI to download a public http(s) image or video URL into private Workspace storage as a new asset. Returns an import_id; poll sosoapi_get_asset_import_status. Needs an idempotency_key and the editor role.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"source_url":{"type":"string","maxLength":2048,"format":"uri"},"idempotency_key":{"type":"string","minLength":1,"maxLength":128},"expected_kind":{"type":"string","enum":["image","video"]},"title":{"type":"string","maxLength":200},"description":{"type":"string","maxLength":2000},"tags":{"maxItems":50,"type":"array","items":{"type":"string","maxLength":64}}},"required":["workspace_id","source_url","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"import_id":{"type":"string","format":"uuid"},"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","importing","needs_repair","ready","asset_purged","failed"]}},"required":["import_id","job_id","status"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/imports/url"],"slug":"import-asset-url"},{"name":"sosoapi_get_asset_import_status","title":"Get asset import status","description":"Read an import by import_id. For posting pass include_asset=true: a ready result includes the registered asset id, kind and stable asset_url, avoiding a separate get_asset. Pending or missing assets cannot be scheduled. Never use the source or preview URL as media identity. If stalled, read sosoapi_job_status with job_id; never start a duplicate import.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"import_id":{"type":"string","format":"uuid"},"include_asset":{"type":"boolean"}},"required":["workspace_id","import_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"import":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","importing","needs_repair","ready","asset_purged","failed"]},"job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"completed_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_purged_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_url":{"type":"string","format":"uri"},"final_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"object_key":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"content_type":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"byte_size":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"content_sha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"media_probe":{"anyOf":[{"$ref":"#/definitions/__schema0"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","status","job_id","asset_id","completed_asset_id","asset_purged_at","source_url","final_url","object_key","content_type","byte_size","content_sha256","media_probe","error_message","created_at","completed_at"],"additionalProperties":false},"asset":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]},"asset_type":{"type":"string","enum":["text","image","video","audio"]},"asset_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","asset_type","asset_url"],"additionalProperties":false},{"type":"null"}]}},"required":["import"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/definitions/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/definitions/__schema0"}}]}}},"routes":["/assets-api/imports/status"],"slug":"get-asset-import-status"},{"name":"sosoapi_list_orphan_assets","title":"List orphan assets","description":"List stored objects in a Workspace that no asset record points to (storage clean-up), paged by continuation token. Workspace owner only.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"object_continuation_token":{"type":"string","minLength":1,"maxLength":2048},"continuation_token":{"type":"string","minLength":1,"maxLength":2048},"limit":{"type":"integer","minimum":1,"maximum":200}},"required":["workspace_id"]},"outputSchema":{"type":"object","properties":{"orphans":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1},"kind":{"anyOf":[{"type":"string","enum":["video","image","audio","cover","thumbnail","frame","video-source","branding"]},{"type":"null"}]},"size":{"type":"integer","minimum":0,"maximum":9007199254740991},"lastModified":{"type":"string"},"eligible_for_cleanup":{"type":"boolean"}},"required":["key","kind","size","lastModified","eligible_for_cleanup"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"next_object_continuation_token":{"anyOf":[{"type":"string"},{"type":"null"}]},"continuation_token":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["orphans","total","next_object_continuation_token","continuation_token"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/orphans/list"],"slug":"list-orphan-assets"},{"name":"sosoapi_delete_orphan_assets","title":"Delete orphan assets","description":"Delete selected unregistered storage objects by key. Workspace owner only; list them first with sosoapi_list_orphan_assets.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"keys":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":512}}},"required":["workspace_id","keys"]},"outputSchema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1},"status":{"type":"string","enum":["deleted","not_orphan","not_eligible","not_in_workspace","error"]}},"required":["key","status"],"additionalProperties":false}}},"required":["results"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/orphans/delete"],"slug":"delete-orphan-assets"},{"name":"sosoapi_get_asset_storage_inventory","title":"Get asset storage inventory","description":"Read a paged inventory of a Workspace's registered assets and stored objects to audit storage.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"asset_cursor":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"object_continuation_token":{"type":"string","minLength":1,"maxLength":2048},"continuation_token":{"type":"string","minLength":1,"maxLength":2048},"limit":{"type":"integer","minimum":1,"maximum":200}},"required":["workspace_id"]},"outputSchema":{"type":"object","properties":{"assets":{"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]},"object_key":{"anyOf":[{"type":"string"},{"type":"null"}]},"classification":{"type":"string","enum":["safe","warning_history","blocked_active"]}},"required":["id","object_key","classification"],"additionalProperties":false}},"objects":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1},"size":{"type":"integer","minimum":0,"maximum":9007199254740991},"lastModified":{"type":"string"}},"required":["key","size","lastModified"],"additionalProperties":false}},"next_asset_cursor":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"next_object_continuation_token":{"anyOf":[{"type":"string"},{"type":"null"}]},"continuation_token":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["assets","objects","next_asset_cursor","next_object_continuation_token","continuation_token"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/storage/inventory"],"slug":"get-asset-storage-inventory"},{"name":"sosoapi_create_asset_export","title":"Create asset export","description":"Export selected assets (asset_ids) as a manifest. Mode export_verify_then_purge prepares them for a later purge. Optional idempotency_key.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["export_only","export_verify_then_purge"]},"asset_ids":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["workspace_id","mode","asset_ids"]},"outputSchema":{"type":"object","properties":{"export_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["exported","verification_required"]},"manifest_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"manifest_object_key":{"type":"string","minLength":1},"deduped":{"type":"boolean"}},"required":["export_id","status","manifest_sha256","manifest_object_key","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/exports/create"],"slug":"create-asset-export"},{"name":"sosoapi_verify_asset_export","title":"Verify asset export","description":"Start verifying an asset export (export_id). An export must be verified before a purge can be requested.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"export_id":{"type":"string","format":"uuid"}},"required":["workspace_id","export_id"]},"outputSchema":{"type":"object","properties":{"export_id":{"type":"string","format":"uuid"},"job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"status":{"type":"string","enum":["verifying","verified"]}},"required":["export_id","job_id","status"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/exports/verify"],"slug":"verify-asset-export"},{"name":"sosoapi_get_asset_export_status","title":"Get asset export status","description":"Read an asset export's status: exported, verification_required, verifying, verified or failed.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"export_id":{"type":"string","format":"uuid"}},"required":["workspace_id","export_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"export_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["exported","verification_required","verifying","verified","failed"]},"job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"verification_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"verification_cursor":{"type":"integer","minimum":0,"maximum":9007199254740991},"verified_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["export_id","status","job_id","verification_error","verification_cursor","verified_at"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/exports/status"],"slug":"get-asset-export-status"},{"name":"sosoapi_request_asset_purge","title":"Request asset purge","description":"Request permanent deletion of the stored bytes of assets covered by a verified export (export_id, asset_ids; confirm_history_loss may be required). Workspace owner only; irreversible once deleted.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"export_id":{"type":"string","format":"uuid"},"asset_ids":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"confirm_history_loss":{"type":"boolean"},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["workspace_id","export_id","asset_ids"]},"outputSchema":{"type":"object","properties":{"purge_request_id":{"type":"string","format":"uuid"},"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["requested","claimed","deleting_bytes","needs_repair","purged","failed","cancelled"]},"classifications":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"classification":{"type":"string","enum":["safe","warning_history","blocked_active"]}},"required":["asset_id","classification"],"additionalProperties":false}},"deduped":{"type":"boolean"}},"required":["purge_request_id","job_id","status","classifications","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/purges/request"],"slug":"request-asset-purge"},{"name":"sosoapi_retry_asset_purge","title":"Retry asset purge","description":"Retry a purge request that stopped (purge_request_id). Workspace owner only.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"purge_request_id":{"type":"string","format":"uuid"},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["workspace_id","purge_request_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"purge_request_id":{"type":"string","format":"uuid"},"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["requested","claimed","deleting_bytes","needs_repair","purged","failed","cancelled"]},"deduped":{"type":"boolean"}},"required":["purge_request_id","job_id","status","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/purges/retry"],"slug":"retry-asset-purge"},{"name":"sosoapi_list_projects","title":"List projects","description":"List a Workspace's projects (an optional layer for provenance and account defaults) and which one is active.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Page size, 1 to 100. Sending limit or cursor switches this route to cursor paging and adds next_cursor to the answer."},"cursor":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque cursor: the next_cursor of the previous page, unchanged. Omit it for the first page. The same filters must be sent with every page."},"include_version":{"description":"Optional. true adds the resource version to the answer.","type":"boolean"}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"operational_state":{"type":"string","enum":["active","archived"]},"lifecycle_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"defaults_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"archived_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"archived_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"archived_by_api_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","name","operational_state","lifecycle_version","defaults_version","archived_at","archived_by","archived_by_api_key_id","created_at","updated_at"],"additionalProperties":false}},"active_project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"next_cursor":{"description":"Present only when the request sent limit or cursor. Null on the last page.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["projects","active_project_id"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/list"],"slug":"list-projects"},{"name":"sosoapi_get_project","title":"Get project","description":"Read one project by id: name, lifecycle state, and the lifecycle and defaults versions later writes need.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"include_version":{"description":"Optional. true adds the resource version to the answer.","type":"boolean"}},"required":["id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"operational_state":{"type":"string","enum":["active","archived"]},"lifecycle_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"defaults_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"archived_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"archived_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"archived_by_api_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","name","operational_state","lifecycle_version","defaults_version","archived_at","archived_by","archived_by_api_key_id","created_at","updated_at"],"additionalProperties":false}},"required":["project"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/get"],"slug":"get-project"},{"name":"sosoapi_create_project","title":"Create project","description":"Create a project in a Workspace. Workspace owner only; optional idempotency_key.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["workspace_id","name"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"operational_state":{"type":"string","enum":["active","archived"]},"lifecycle_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"defaults_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"archived_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"archived_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"archived_by_api_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","name","operational_state","lifecycle_version","defaults_version","archived_at","archived_by","archived_by_api_key_id","created_at","updated_at"],"additionalProperties":false},"deduped":{"type":"boolean"}},"required":["project"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/create"],"slug":"create-project"},{"name":"sosoapi_update_project","title":"Update project","description":"Rename a project (its name is the only editable field). Workspace owner only.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"expected_version":{"description":"Optional. The version you read. If it changed since, the update fails with 409 VERSION_CONFLICT instead of overwriting.","type":"integer","exclusiveMinimum":0,"maximum":2147483647},"include_version":{"description":"Optional. true adds the resource version to the answer.","type":"boolean"}},"required":["id","name"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"operational_state":{"type":"string","enum":["active","archived"]},"lifecycle_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"defaults_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"archived_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"archived_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"archived_by_api_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","name","operational_state","lifecycle_version","defaults_version","archived_at","archived_by","archived_by_api_key_id","created_at","updated_at"],"additionalProperties":false}},"required":["project"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/update"],"slug":"update-project"},{"name":"sosoapi_set_active_project","title":"Set active project","description":"Set which project is the user's active one (a server-side default).","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"}},"required":["project_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"active_project_id":{"type":"string","format":"uuid"}},"required":["ok","active_project_id"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/set-active"],"slug":"set-active-project"},{"name":"sosoapi_get_project_account_defaults","title":"Get project account defaults","description":"Read a project's default social accounts and per-account overrides, with the defaults_version the next replace needs.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"}},"required":["project_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"defaults_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"accounts":{"type":"array","items":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"facebook_page_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"language":{"type":"string","minLength":1,"maxLength":35},"region":{"type":"string","minLength":1,"maxLength":16},"timezone":{"type":"string","minLength":1,"maxLength":80},"resolution_source":{"type":"string","enum":["project_default","workspace_default","connected_account"]}},"required":["social_account_id","workspace_id","platform","platform_user_id","username","facebook_page_name","enabled","language","region","timezone","resolution_source"],"additionalProperties":false}}},"required":["project_id","defaults_version","accounts"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/account-defaults/get"],"slug":"get-project-account-defaults"},{"name":"sosoapi_replace_project_account_defaults","title":"Replace project account defaults","description":"Replace a project's default accounts and overrides in one step. Needs expected_defaults_version from the latest read and an idempotency_key (editor role).","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"expected_defaults_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string","minLength":8,"maxLength":160},"overrides":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"},"enabled":{"type":"boolean"},"language":{"type":"string","minLength":1,"maxLength":35},"region":{"type":"string","minLength":1,"maxLength":16},"timezone":{"type":"string","minLength":1,"maxLength":80}},"required":["social_account_id","enabled","language","region","timezone"],"additionalProperties":false}}},"required":["project_id","expected_defaults_version","idempotency_key","overrides"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"defaults_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"accounts":{"type":"array","items":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"facebook_page_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"language":{"type":"string","minLength":1,"maxLength":35},"region":{"type":"string","minLength":1,"maxLength":16},"timezone":{"type":"string","minLength":1,"maxLength":80},"resolution_source":{"type":"string","enum":["project_default","workspace_default","connected_account"]}},"required":["social_account_id","workspace_id","platform","platform_user_id","username","facebook_page_name","enabled","language","region","timezone","resolution_source"],"additionalProperties":false}},"receipt_id":{"type":"string","format":"uuid"},"applied":{"type":"boolean"},"deduped":{"type":"boolean"}},"required":["project_id","defaults_version","accounts","receipt_id","applied","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/account-defaults/replace"],"slug":"replace-project-account-defaults"},{"name":"sosoapi_archive_project","title":"Archive project","description":"Archive a project; schedules tied to it are held (held_schedule_count). Owner only; needs expected_lifecycle_version and an idempotency_key. Undo with sosoapi_unarchive_project.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"expected_lifecycle_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["id","expected_lifecycle_version","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"operational_state":{"type":"string","enum":["active","archived"]},"lifecycle_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"defaults_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"archived_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"archived_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"archived_by_api_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","name","operational_state","lifecycle_version","defaults_version","archived_at","archived_by","archived_by_api_key_id","created_at","updated_at"],"additionalProperties":false},"receipt_id":{"type":"string","format":"uuid"},"applied":{"type":"boolean"},"deduped":{"type":"boolean"},"held_schedule_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["project","receipt_id","applied","deduped","held_schedule_count"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/archive"],"slug":"archive-project"},{"name":"sosoapi_unarchive_project","title":"Unarchive project","description":"Reactivate an archived project; held schedules resume or need rescheduling. Owner only; needs expected_lifecycle_version and an idempotency_key.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"expected_lifecycle_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["id","expected_lifecycle_version","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":200},"operational_state":{"type":"string","enum":["active","archived"]},"lifecycle_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"defaults_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"archived_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"archived_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"archived_by_api_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","name","operational_state","lifecycle_version","defaults_version","archived_at","archived_by","archived_by_api_key_id","created_at","updated_at"],"additionalProperties":false},"receipt_id":{"type":"string","format":"uuid"},"applied":{"type":"boolean"},"deduped":{"type":"boolean"},"resumed_schedule_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"needs_reschedule_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["project","receipt_id","applied","deduped","resumed_schedule_count","needs_reschedule_count"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/unarchive"],"slug":"unarchive-project"},{"name":"sosoapi_get_project_lifecycle_history","title":"Get project lifecycle history","description":"Read a project's lifecycle events (such as archive and unarchive), up to 200.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"limit":{"type":"integer","minimum":1,"maximum":200}},"required":["project_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"project_id":{"type":"string","format":"uuid"},"action":{"type":"string","enum":["archived","unarchived"]},"previous_state":{"type":"string","enum":["active","archived"]},"new_state":{"type":"string","enum":["active","archived"]},"previous_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"new_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"actor_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"actor_kind":{"type":"string","enum":["jwt","api_key","delegated_ai"]},"actor_api_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"actor_delegated_grant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"occurred_at":{"type":"string"}},"required":["id","workspace_id","project_id","action","previous_state","new_state","previous_version","new_version","actor_user_id","actor_kind","actor_api_key_id","actor_delegated_grant_id","occurred_at"],"additionalProperties":false}}},"required":["events"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/lifecycle/history"],"slug":"get-project-lifecycle-history"},{"name":"sosoapi_get_project_profile","title":"Get project profile","description":"Read a project's brand profile (tagline, voice, target audience, goals, palette and more); profile is null when none exists.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"}},"required":["project_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"project/v1"},"profile":{"anyOf":[{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"voice":{"anyOf":[{"type":"string"},{"type":"null"}]},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}]},"color_palette":{"type":"array","items":{"type":"string"}},"goals":{"type":"array","items":{"type":"string"}},"no_go_topics":{"type":"array","items":{"type":"string"}},"language_primary":{"type":"string"},"positioning":{"anyOf":[{"type":"string"},{"type":"null"}]},"usp":{"anyOf":[{"type":"string"},{"type":"null"}]},"visual_identity":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"forbidden_claims":{"type":"array","items":{"type":"string"}},"north_star_metric":{"anyOf":[{"type":"string"},{"type":"null"}]},"posting_cadence":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"app_store_url_ios":{"anyOf":[{"type":"string"},{"type":"null"}]},"app_store_url_android":{"anyOf":[{"type":"string"},{"type":"null"}]},"app_metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"profile_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"updated_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"updated_by_kind":{"type":"string","enum":["jwt","api_key","delegated_ai","migration"]},"updated_by_api_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"updated_by_delegated_grant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["project_id","workspace_id","tagline","description","voice","target_audience","color_palette","goals","no_go_topics","language_primary","positioning","usp","visual_identity","forbidden_claims","north_star_metric","posting_cadence","app_store_url_ios","app_store_url_android","app_metadata","profile_version","updated_by","updated_by_kind","updated_by_api_key_id","updated_by_delegated_grant_id","created_at","updated_at"],"additionalProperties":false},{"type":"null"}]}},"required":["contract_version","profile"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/profile/get"],"slug":"get-project-profile"},{"name":"sosoapi_update_project_profile","title":"Update project profile","description":"Patch a project's brand profile fields. Fields you omit stay unchanged. Needs expected_profile_version from the latest read and an idempotency_key (editor role).","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"expected_profile_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string","minLength":8,"maxLength":160},"patch":{"type":"object","properties":{"tagline":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}]},"voice":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"target_audience":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"color_palette":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":64}},"goals":{"maxItems":50,"type":"array","items":{"type":"string","maxLength":160}},"no_go_topics":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":160}},"language_primary":{"type":"string","minLength":2,"maxLength":35},"positioning":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]},"usp":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"visual_identity":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"forbidden_claims":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":240}},"north_star_metric":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]},"posting_cadence":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"app_store_url_ios":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"app_store_url_android":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"app_metadata":{"type":"object","additionalProperties":{}}},"additionalProperties":false}},"required":["project_id","expected_profile_version","idempotency_key","patch"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"project/v1"},"profile":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"voice":{"anyOf":[{"type":"string"},{"type":"null"}]},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}]},"color_palette":{"type":"array","items":{"type":"string"}},"goals":{"type":"array","items":{"type":"string"}},"no_go_topics":{"type":"array","items":{"type":"string"}},"language_primary":{"type":"string"},"positioning":{"anyOf":[{"type":"string"},{"type":"null"}]},"usp":{"anyOf":[{"type":"string"},{"type":"null"}]},"visual_identity":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"forbidden_claims":{"type":"array","items":{"type":"string"}},"north_star_metric":{"anyOf":[{"type":"string"},{"type":"null"}]},"posting_cadence":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"app_store_url_ios":{"anyOf":[{"type":"string"},{"type":"null"}]},"app_store_url_android":{"anyOf":[{"type":"string"},{"type":"null"}]},"app_metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"profile_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"updated_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"updated_by_kind":{"type":"string","enum":["jwt","api_key","delegated_ai","migration"]},"updated_by_api_key_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"updated_by_delegated_grant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["project_id","workspace_id","tagline","description","voice","target_audience","color_palette","goals","no_go_topics","language_primary","positioning","usp","visual_identity","forbidden_claims","north_star_metric","posting_cadence","app_store_url_ios","app_store_url_android","app_metadata","profile_version","updated_by","updated_by_kind","updated_by_api_key_id","updated_by_delegated_grant_id","created_at","updated_at"],"additionalProperties":false},"receipt_id":{"type":"string","format":"uuid"},"applied":{"type":"boolean"},"deduped":{"type":"boolean"}},"required":["contract_version","profile","receipt_id","applied","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/profile/update"],"slug":"update-project-profile"},{"name":"sosoapi_list_project_assets","title":"List project assets","description":"List the assets linked to a project with each link's relationship (identity, source or reference), paged by cursor.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"cursor":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":200}},"required":["project_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"project/v1"},"project_id":{"type":"string","format":"uuid"},"links":{"type":"array","items":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"project_id":{"type":"string","format":"uuid"},"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"relationship":{"type":"string","enum":["identity","source","reference"]},"source":{"type":"string","enum":["user","api_key","delegated_ai","migration","scheduled_post","project_default"]},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["workspace_id","project_id","asset_id","relationship","source","created_by","created_at"],"additionalProperties":false}},"next_cursor":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["contract_version","project_id","links","next_cursor"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/assets/list"],"slug":"list-project-assets"},{"name":"sosoapi_link_project_asset","title":"Link project asset","description":"Link an existing asset to a project as identity, source or reference. Editor role; idempotency_key required.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"relationship":{"type":"string","enum":["identity","source","reference"]},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["project_id","asset_id","relationship","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"project/v1"},"link":{"anyOf":[{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"project_id":{"type":"string","format":"uuid"},"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"relationship":{"type":"string","enum":["identity","source","reference"]},"source":{"type":"string","enum":["user","api_key","delegated_ai","migration","scheduled_post","project_default"]},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["workspace_id","project_id","asset_id","relationship","source","created_by","created_at"],"additionalProperties":false},{"type":"null"}]},"receipt_id":{"type":"string","format":"uuid"},"applied":{"type":"boolean"},"deduped":{"type":"boolean"}},"required":["contract_version","link","receipt_id","applied","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/assets/link"],"slug":"link-project-asset"},{"name":"sosoapi_unlink_project_asset","title":"Unlink project asset","description":"Remove an asset's link to a project; the asset itself is kept. idempotency_key required.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["project_id","asset_id","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"project/v1"},"link":{"anyOf":[{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"project_id":{"type":"string","format":"uuid"},"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"relationship":{"type":"string","enum":["identity","source","reference"]},"source":{"type":"string","enum":["user","api_key","delegated_ai","migration","scheduled_post","project_default"]},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["workspace_id","project_id","asset_id","relationship","source","created_by","created_at"],"additionalProperties":false},{"type":"null"}]},"receipt_id":{"type":"string","format":"uuid"},"applied":{"type":"boolean"},"deduped":{"type":"boolean"}},"required":["contract_version","link","receipt_id","applied","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/assets/unlink"],"slug":"unlink-project-asset"},{"name":"sosoapi_list_project_accounts","title":"List project accounts","description":"List the social accounts linked to a project, paged by cursor.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"cursor":{"type":"string","format":"uuid"},"limit":{"type":"integer","minimum":1,"maximum":200}},"required":["project_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"project/v1"},"project_id":{"type":"string","format":"uuid"},"links":{"type":"array","items":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"project_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"source":{"type":"string","enum":["user","api_key","delegated_ai","migration","scheduled_post","project_default"]},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"facebook_page_name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["workspace_id","project_id","social_account_id","source","created_by","created_at"],"additionalProperties":false}},"next_cursor":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}},"required":["contract_version","project_id","links","next_cursor"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/accounts/list"],"slug":"list-project-accounts"},{"name":"sosoapi_link_project_account","title":"Link project account","description":"Link a connected social account to a project. Editor role; idempotency_key required.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["project_id","social_account_id","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"project/v1"},"link":{"anyOf":[{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"project_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"source":{"type":"string","enum":["user","api_key","delegated_ai","migration","scheduled_post","project_default"]},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"facebook_page_name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["workspace_id","project_id","social_account_id","source","created_by","created_at"],"additionalProperties":false},{"type":"null"}]},"receipt_id":{"type":"string","format":"uuid"},"applied":{"type":"boolean"},"deduped":{"type":"boolean"}},"required":["contract_version","link","receipt_id","applied","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/accounts/link"],"slug":"link-project-account"},{"name":"sosoapi_unlink_project_account","title":"Unlink project account","description":"Remove a social account's link to a project; the account stays connected. idempotency_key required.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["project_id","social_account_id","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"project/v1"},"link":{"anyOf":[{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"project_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"source":{"type":"string","enum":["user","api_key","delegated_ai","migration","scheduled_post","project_default"]},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"facebook_page_name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["workspace_id","project_id","social_account_id","source","created_by","created_at"],"additionalProperties":false},{"type":"null"}]},"receipt_id":{"type":"string","format":"uuid"},"applied":{"type":"boolean"},"deduped":{"type":"boolean"}},"required":["contract_version","link","receipt_id","applied","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/accounts/unlink"],"slug":"unlink-project-account"},{"name":"sosoapi_create_project_export","title":"Create project export","description":"Start an export of a project (Workspace owner only); poll sosoapi_get_project_export_status for the download URL. idempotency_key required.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["project_id","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"project/v1"},"export_id":{"type":"string","format":"uuid"},"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","processing","completed","failed"]},"deduped":{"type":"boolean"}},"required":["contract_version","export_id","job_id","status","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/export/create"],"slug":"create-project-export"},{"name":"sosoapi_get_project_export_status","title":"Get project export status","description":"Read a project export (export_id): queued, processing, completed (with a short-lived download URL) or failed. Workspace owner only.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid"},"export_id":{"type":"string","format":"uuid"}},"required":["project_id","export_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"project/v1"},"export_id":{"type":"string","format":"uuid"},"project_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","processing","completed","failed"]},"object_sha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"object_size":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"download_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"completed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["contract_version","export_id","project_id","status","object_sha256","object_size","download_url","download_expires_at","error_message","created_at","completed_at"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/projects/export/status"],"slug":"get-project-export-status"},{"name":"sosoapi_list_publication_attentions","title":"List publication attentions","description":"List publications in a Workspace that need attention, filtered by status (open or resolved) or scheduled_post_id, paged by offset.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["open","resolved"]},"scheduled_post_id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0,"maximum":10000}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"attentions":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"scheduled_post_id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"publication_attempt_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"account_label":{"type":"string"},"status":{"type":"string","enum":["open","resolved"]},"cause":{"type":"string","enum":["terminal_failure","missing_evidence","delete_failed","stuck_dispatch"]},"reason_code":{"type":"string","enum":["publication_failed","delivery_evidence_pending","provider_delete_needs_review","delivery_delayed"]},"message":{"type":"string","minLength":1,"maxLength":500},"actionability":{"type":"string","enum":["user_actionable","vic_handling","resolved"]},"available_actions":{"maxItems":1,"type":"array","items":{"type":"string","enum":["retry","delete"]}},"opened_at":{"type":"string"},"first_observed_at":{"type":"string"},"last_observed_at":{"type":"string"},"resolved_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","scheduled_post_id","publication_attempt_id","social_account_id","platform","account_label","status","cause","reason_code","message","actionability","available_actions","opened_at","first_observed_at","last_observed_at","resolved_at","created_at","updated_at"],"additionalProperties":false}},"next_offset":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}]},"returned_count":{"type":"integer","minimum":0,"maximum":200},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["attentions","next_offset","returned_count","total"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/publication-attentions/list"],"slug":"list-publication-attentions"},{"name":"sosoapi_get_x_usage","title":"Get X publishing credits","description":"Read the Organization X publishing credits shared by this Workspace. Needs workspace_id. Free gets 10 once; Pro gets 100 per billing period. Text costs 1, text containing a URL costs 10. Optional text quotes its cost. This reads stored allowance and calls no X API.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"text":{"type":"string","maxLength":4096}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"plan":{"type":"string","enum":["free","founding_pro"]},"allowance":{"type":"string","enum":["one_time","monthly"]},"period_start":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"period_end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number","const":10},{"type":"number","const":100}]},"reserved":{"type":"integer","minimum":0,"maximum":9007199254740991},"consumed":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"costs":{"type":"object","properties":{"text":{"type":"number","const":1},"with_url":{"type":"number","const":10}},"required":["text","with_url"],"additionalProperties":false},"draft_credits":{"anyOf":[{"type":"number","const":1},{"type":"number","const":10}]}},"required":["workspace_id","plan","allowance","period_start","period_end","limit","reserved","consumed","remaining","costs"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/x/usage"],"slug":"get-x-usage"},{"name":"sosoapi_list_scheduled_posts","title":"List scheduled posts","description":"List a Workspace's scheduled posts, filterable by project, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) and time range, cursor-paged.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"project_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"scheduled_from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"scheduled_to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"limit":{"type":"integer","minimum":1,"maximum":200},"cursor":{"type":"object","properties":{"scheduled_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"}},"required":["scheduled_at","id"],"additionalProperties":false}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at","project_id","batch_id","source_ref"],"additionalProperties":false}},"next_cursor":{"anyOf":[{"type":"object","properties":{"scheduled_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"}},"required":["scheduled_at","id"],"additionalProperties":false},{"type":"null"}]},"returned_count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["posts","next_cursor","returned_count"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/list"],"slug":"list-scheduled-posts"},{"name":"sosoapi_get_scheduled_post","title":"Get scheduled post","description":"Read one scheduled post by id: content, status, delivery state and outcomes. Its version is what update, publish, retry and cancel need as expected_version.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"}},"required":["id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at"],"additionalProperties":false},"delivery":{"type":"object","properties":{"stage":{"type":"string","enum":["scheduled","preparing","delivering","reconciling","cancelling","terminal"]},"message":{"type":"string","minLength":1,"maxLength":500}},"required":["stage","message"],"additionalProperties":false},"actions":{"minItems":5,"maxItems":5,"type":"array","items":{"type":"object","properties":{"action":{"type":"string","enum":["edit","publish_now","retry","cancel","delete"]},"allowed":{"type":"boolean"},"reason_code":{"type":"string","enum":["allowed","terminal_state","provider_preparation_started","delivery_started","not_scheduled","not_failed","retry_evidence_missing","destination_disconnected","expiry_passed","cancellation_in_progress","delete_in_progress","not_published"]},"message":{"type":"string","minLength":1,"maxLength":500}},"required":["action","allowed","reason_code","message"],"additionalProperties":false}},"attempts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"operation":{"type":"string","enum":["publish","delete"]},"attempt_number":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"dispatched_at":{"type":"string"}},"required":["id","operation","attempt_number","dispatched_at"],"additionalProperties":false}},"outcomes":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"publication_attempt_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"operation":{"type":"string","enum":["publish","delete"]},"status":{"type":"string","enum":["published","failed","deleted"]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"message":{"type":"string","minLength":1,"maxLength":500},"observed_at":{"type":"string"},"terminal_suboperation":{"type":"object","properties":{"kind":{"type":"string","const":"instagram_first_comment"},"status":{"type":"string","enum":["succeeded","failed","attention"]},"external_id":{"anyOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"null"}]}},"required":["kind","status","external_id"],"additionalProperties":false}},"required":["id","publication_attempt_id","operation","status","provider_post_id","permalink","message","observed_at"],"additionalProperties":false}}},"required":["post","delivery","actions","attempts","outcomes"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/get"],"slug":"get-scheduled-post"},{"name":"sosoapi_get_scheduled_post_eligibility","title":"Get scheduled post eligibility","description":"Read-only preflight per destination. Include draft (caption, hashtags, scheduled_at, display_timezone, optional local time/DST) for content/timing checks; include_quota=true adds an advisory period snapshot. Upload/import media and await readiness first. Without draft, only account/media are checked. Reserves nothing; create/dispatch recheck limits and authority.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"include_quota":{"type":"boolean"},"targets":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"},"media":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"provider_payload":{"anyOf":[{"type":"object","properties":{"platform":{"type":"string","enum":["x"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT"]}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["instagram"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO"]},"location_id":{"type":"string","minLength":1,"maxLength":256},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1,"maxLength":30}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"audio_name":{"type":"string","minLength":1,"maxLength":100},"trial_params":{"type":"object","properties":{"graduation_strategy":{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]}},"required":["graduation_strategy"],"additionalProperties":false},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"maxItems":2,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"is_paid_partnership":{"type":"boolean"},"media_options":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text":{"type":"string","minLength":1,"maxLength":1000},"user_tags":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username"],"additionalProperties":false}},"product_tags":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","minLength":1,"maxLength":256},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["product_id"],"additionalProperties":false}},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["facebook"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","REELS","STORY_IMAGE","STORY_VIDEO"]},"title":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":5000},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string","minLength":1,"maxLength":256},"tags":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"feed_targeting":{"type":"object","properties":{"age_min":{"type":"integer","minimum":13,"maximum":65},"age_max":{"type":"integer","minimum":13,"maximum":65},"college_years":{"maxItems":100,"type":"array","items":{"type":"integer","minimum":1900,"maximum":2200}},"education_statuses":{"maxItems":3,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]},{"type":"number","enum":[3]}]}},"genders":{"maxItems":2,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]}},"geo_locations":{"type":"object","properties":{"countries":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"regions":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"cities":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]},"radius":{"type":"number","exclusiveMinimum":0,"maximum":1000},"distance_unit":{"type":"string","enum":["mile","kilometer"]}},"required":["key"],"additionalProperties":false}},"zips":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"location_types":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["home","recent"]}}},"additionalProperties":false},"interests":{"maxItems":250,"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"locales":{"maxItems":250,"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}},"relationship_statuses":{"maxItems":4,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]},{"type":"number","enum":[3]},{"type":"number","enum":[4]}]}}},"additionalProperties":false},"targeting":{"type":"object","properties":{"age_min":{"anyOf":[{"type":"number","enum":[13]},{"type":"number","enum":[15]},{"type":"number","enum":[18]},{"type":"number","enum":[21]},{"type":"number","enum":[25]}]},"geo_locations":{"type":"object","properties":{"countries":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"regions":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"cities":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]},"radius":{"type":"number","exclusiveMinimum":0,"maximum":1000},"distance_unit":{"type":"string","enum":["mile","kilometer"]}},"required":["key"],"additionalProperties":false}},"zips":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"location_types":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["home","recent"]}}},"additionalProperties":false}},"additionalProperties":false},"child_attachments":{"minItems":2,"maxItems":10,"type":"array","items":{"type":"object","properties":{"link":{"type":"string","format":"uri"},"name":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":1000},"picture":{"type":"string","format":"uri"}},"required":["link","picture"],"additionalProperties":false}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string","enum":["SCHEDULED","SCHEDULED_RECURRING","DRAFT","PUBLISH_PENDING","ADS_POST","INLINE_CREATED","PUBLISHED","REVIEWABLE_BRANDED_CONTENT"]},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string","minLength":1,"maxLength":256},"spherical":{"type":"boolean"},"media_options":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text_custom":{"type":"string","minLength":1,"maxLength":1000}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["threads"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","IMAGE","VIDEO","CAROUSEL","REPOST"]},"reply_to_id":{"type":"string","minLength":1,"maxLength":256},"quote_post_id":{"type":"string","minLength":1,"maxLength":256},"repost_target_id":{"type":"string","minLength":1,"maxLength":256},"reply_control":{"type":"string","enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"]},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","properties":{"option_a":{"type":"string","minLength":1,"maxLength":25},"option_b":{"type":"string","minLength":1,"maxLength":25},"option_c":{"type":"string","minLength":1,"maxLength":25},"option_d":{"type":"string","minLength":1,"maxLength":25}},"required":["option_a","option_b"],"additionalProperties":false},"gif_attachment":{"type":"object","properties":{"gif_id":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","enum":["GIPHY"]}},"required":["gif_id","provider"],"additionalProperties":false},"text_attachment":{"type":"object","properties":{"plaintext":{"type":"string","minLength":1,"maxLength":10000},"link_attachment_url":{"type":"string","format":"uri"},"text_with_styling_info":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"styling_info":{"minItems":1,"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}},"required":["offset","length","styling_info"],"additionalProperties":false}}},"required":["plaintext"],"additionalProperties":false},"topic_tag":{"type":"string","minLength":1,"maxLength":50},"text_entities":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"entity_type":{"type":"string","enum":["SPOILER","spoiler"]},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["entity_type","offset","length"],"additionalProperties":false}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"location_id":{"type":"string","minLength":1,"maxLength":256},"allowlisted_country_codes":{"minItems":1,"maxItems":249,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"media_options":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text":{"type":"string","minLength":1,"maxLength":1000},"is_spoiler_media":{"type":"boolean"}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["youtube"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["VIDEO"]},"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000},"tags":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"category_id":{"anyOf":[{"type":"string","minLength":0,"maxLength":0},{"type":"string","pattern":"^\\d+$"}]},"default_language":{"type":"string","minLength":2,"maxLength":35},"localizations":{"type":"object","additionalProperties":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["title","description"],"additionalProperties":false}},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","enum":["SHORT"]},"brand_partner":{"type":"object","properties":{"channel_id":{"type":"string","pattern":"^UC[A-Za-z0-9_-]+$"},"channel_handle":{"type":"string","pattern":"^@[A-Za-z0-9._-]+$"}},"additionalProperties":false}},"required":["post_type","title","privacy_status","cancellation_mode"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false}]},"draft":{"type":"object","properties":{"caption":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"hashtags":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}},"scheduled_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},"schedule_dst_disambiguation":{"type":"string","enum":["exact","earlier","later"]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["scheduled_at","display_timezone"],"additionalProperties":false}},"required":["social_account_id","media","provider_payload"],"additionalProperties":false}}},"required":["workspace_id","targets"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"destinations":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"},"platform":{"anyOf":[{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},{"type":"null"}]},"status":{"type":"string","enum":["eligible","ineligible","unknown"]},"reason_code":{"type":"string","enum":["eligible","account_not_found","account_disconnected","account_action_required","account_temporarily_unavailable","account_publishing_restricted","account_readiness_unknown","account_sponsorship_required","organization_channel_disconnected","provider_authorization_revoke_pending","organization_channel_not_primary","organization_channel_transition","organization_new_work_blocked","content_incompatible","schedule_incompatible","schedule_check_unavailable","capability_unavailable","capability_unknown"]},"message":{"type":"string","minLength":1,"maxLength":500},"required_capabilities":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["social_account_id","platform","status","reason_code","message","required_capabilities"],"additionalProperties":false}},"quota":{"type":"object","properties":{"status":{"type":"string","enum":["available","insufficient","unknown","not_enforced"]},"requested_destinations":{"type":"integer","exclusiveMinimum":0,"maximum":50},"remaining_publishes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"remaining_pending_posts":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"period_start":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"period_end":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"checked_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"reserved":{"type":"boolean","const":false}},"required":["status","requested_destinations","remaining_publishes","remaining_pending_posts","period_start","period_end","checked_at","reserved"],"additionalProperties":false}},"required":["destinations"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/eligibility"],"slug":"get-scheduled-post-eligibility"},{"name":"sosoapi_create_scheduled_post","title":"Create scheduled post","description":"Schedule one account at scheduled_at with provider_payload. Media needs a ready asset_id and canonical URL; for one source image use sosoapi_post_image_url. Pair local_scheduled_at with schedule_dst_disambiguation or omit both. Requires publish, editor role and idempotency_key. Scheduled is not published: read its outcome.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"social_account_id":{"type":"string","format":"uuid"},"caption":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"hashtags":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}},"media":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"provider_payload":{"anyOf":[{"type":"object","properties":{"platform":{"type":"string","enum":["x"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT"]}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["instagram"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO"]},"location_id":{"type":"string","minLength":1,"maxLength":256},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1,"maxLength":30}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"audio_name":{"type":"string","minLength":1,"maxLength":100},"trial_params":{"type":"object","properties":{"graduation_strategy":{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]}},"required":["graduation_strategy"],"additionalProperties":false},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"maxItems":2,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"is_paid_partnership":{"type":"boolean"},"media_options":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text":{"type":"string","minLength":1,"maxLength":1000},"user_tags":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username"],"additionalProperties":false}},"product_tags":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","minLength":1,"maxLength":256},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["product_id"],"additionalProperties":false}},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["facebook"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","REELS","STORY_IMAGE","STORY_VIDEO"]},"title":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":5000},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string","minLength":1,"maxLength":256},"tags":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"feed_targeting":{"type":"object","properties":{"age_min":{"type":"integer","minimum":13,"maximum":65},"age_max":{"type":"integer","minimum":13,"maximum":65},"college_years":{"maxItems":100,"type":"array","items":{"type":"integer","minimum":1900,"maximum":2200}},"education_statuses":{"maxItems":3,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]},{"type":"number","enum":[3]}]}},"genders":{"maxItems":2,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]}},"geo_locations":{"type":"object","properties":{"countries":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"regions":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"cities":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]},"radius":{"type":"number","exclusiveMinimum":0,"maximum":1000},"distance_unit":{"type":"string","enum":["mile","kilometer"]}},"required":["key"],"additionalProperties":false}},"zips":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"location_types":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["home","recent"]}}},"additionalProperties":false},"interests":{"maxItems":250,"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"locales":{"maxItems":250,"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}},"relationship_statuses":{"maxItems":4,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]},{"type":"number","enum":[3]},{"type":"number","enum":[4]}]}}},"additionalProperties":false},"targeting":{"type":"object","properties":{"age_min":{"anyOf":[{"type":"number","enum":[13]},{"type":"number","enum":[15]},{"type":"number","enum":[18]},{"type":"number","enum":[21]},{"type":"number","enum":[25]}]},"geo_locations":{"type":"object","properties":{"countries":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"regions":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"cities":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]},"radius":{"type":"number","exclusiveMinimum":0,"maximum":1000},"distance_unit":{"type":"string","enum":["mile","kilometer"]}},"required":["key"],"additionalProperties":false}},"zips":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"location_types":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["home","recent"]}}},"additionalProperties":false}},"additionalProperties":false},"child_attachments":{"minItems":2,"maxItems":10,"type":"array","items":{"type":"object","properties":{"link":{"type":"string","format":"uri"},"name":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":1000},"picture":{"type":"string","format":"uri"}},"required":["link","picture"],"additionalProperties":false}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string","enum":["SCHEDULED","SCHEDULED_RECURRING","DRAFT","PUBLISH_PENDING","ADS_POST","INLINE_CREATED","PUBLISHED","REVIEWABLE_BRANDED_CONTENT"]},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string","minLength":1,"maxLength":256},"spherical":{"type":"boolean"},"media_options":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text_custom":{"type":"string","minLength":1,"maxLength":1000}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["threads"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","IMAGE","VIDEO","CAROUSEL","REPOST"]},"reply_to_id":{"type":"string","minLength":1,"maxLength":256},"quote_post_id":{"type":"string","minLength":1,"maxLength":256},"repost_target_id":{"type":"string","minLength":1,"maxLength":256},"reply_control":{"type":"string","enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"]},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","properties":{"option_a":{"type":"string","minLength":1,"maxLength":25},"option_b":{"type":"string","minLength":1,"maxLength":25},"option_c":{"type":"string","minLength":1,"maxLength":25},"option_d":{"type":"string","minLength":1,"maxLength":25}},"required":["option_a","option_b"],"additionalProperties":false},"gif_attachment":{"type":"object","properties":{"gif_id":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","enum":["GIPHY"]}},"required":["gif_id","provider"],"additionalProperties":false},"text_attachment":{"type":"object","properties":{"plaintext":{"type":"string","minLength":1,"maxLength":10000},"link_attachment_url":{"type":"string","format":"uri"},"text_with_styling_info":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"styling_info":{"minItems":1,"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}},"required":["offset","length","styling_info"],"additionalProperties":false}}},"required":["plaintext"],"additionalProperties":false},"topic_tag":{"type":"string","minLength":1,"maxLength":50},"text_entities":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"entity_type":{"type":"string","enum":["SPOILER","spoiler"]},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["entity_type","offset","length"],"additionalProperties":false}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"location_id":{"type":"string","minLength":1,"maxLength":256},"allowlisted_country_codes":{"minItems":1,"maxItems":249,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"media_options":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text":{"type":"string","minLength":1,"maxLength":1000},"is_spoiler_media":{"type":"boolean"}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["youtube"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["VIDEO"]},"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000},"tags":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"category_id":{"anyOf":[{"type":"string","minLength":0,"maxLength":0},{"type":"string","pattern":"^\\d+$"}]},"default_language":{"type":"string","minLength":2,"maxLength":35},"localizations":{"type":"object","additionalProperties":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["title","description"],"additionalProperties":false}},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","enum":["SHORT"]},"brand_partner":{"type":"object","properties":{"channel_id":{"type":"string","pattern":"^UC[A-Za-z0-9_-]+$"},"channel_handle":{"type":"string","pattern":"^@[A-Za-z0-9._-]+$"}},"additionalProperties":false}},"required":["post_type","title","privacy_status","cancellation_mode"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false}]},"scheduled_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},"schedule_dst_disambiguation":{"type":"string","enum":["exact","earlier","later"]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"automatic_retry_enabled":{"type":"boolean"},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["workspace_id","social_account_id","provider_payload","scheduled_at","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at","project_id","batch_id","source_ref"],"additionalProperties":false},"deduped":{"type":"boolean"}},"required":["post","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/create"],"slug":"create-scheduled-post"},{"name":"sosoapi_bulk_create_scheduled_posts","title":"Bulk create scheduled posts","description":"Schedule posts for several accounts in one call (targets). Media needs ready uploaded/imported asset_ids and their canonical URLs. Each target succeeds or fails on its own and is reported in successes or failures. Needs the publish capability.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"targets":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"},"caption":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"hashtags":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}},"media":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"provider_payload":{"anyOf":[{"type":"object","properties":{"platform":{"type":"string","enum":["x"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT"]}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["instagram"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO"]},"location_id":{"type":"string","minLength":1,"maxLength":256},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1,"maxLength":30}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"audio_name":{"type":"string","minLength":1,"maxLength":100},"trial_params":{"type":"object","properties":{"graduation_strategy":{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]}},"required":["graduation_strategy"],"additionalProperties":false},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"maxItems":2,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"is_paid_partnership":{"type":"boolean"},"media_options":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text":{"type":"string","minLength":1,"maxLength":1000},"user_tags":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username"],"additionalProperties":false}},"product_tags":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","minLength":1,"maxLength":256},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["product_id"],"additionalProperties":false}},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["facebook"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","REELS","STORY_IMAGE","STORY_VIDEO"]},"title":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":5000},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string","minLength":1,"maxLength":256},"tags":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"feed_targeting":{"type":"object","properties":{"age_min":{"type":"integer","minimum":13,"maximum":65},"age_max":{"type":"integer","minimum":13,"maximum":65},"college_years":{"maxItems":100,"type":"array","items":{"type":"integer","minimum":1900,"maximum":2200}},"education_statuses":{"maxItems":3,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]},{"type":"number","enum":[3]}]}},"genders":{"maxItems":2,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]}},"geo_locations":{"type":"object","properties":{"countries":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"regions":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"cities":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]},"radius":{"type":"number","exclusiveMinimum":0,"maximum":1000},"distance_unit":{"type":"string","enum":["mile","kilometer"]}},"required":["key"],"additionalProperties":false}},"zips":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"location_types":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["home","recent"]}}},"additionalProperties":false},"interests":{"maxItems":250,"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"locales":{"maxItems":250,"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}},"relationship_statuses":{"maxItems":4,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]},{"type":"number","enum":[3]},{"type":"number","enum":[4]}]}}},"additionalProperties":false},"targeting":{"type":"object","properties":{"age_min":{"anyOf":[{"type":"number","enum":[13]},{"type":"number","enum":[15]},{"type":"number","enum":[18]},{"type":"number","enum":[21]},{"type":"number","enum":[25]}]},"geo_locations":{"type":"object","properties":{"countries":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"regions":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"cities":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]},"radius":{"type":"number","exclusiveMinimum":0,"maximum":1000},"distance_unit":{"type":"string","enum":["mile","kilometer"]}},"required":["key"],"additionalProperties":false}},"zips":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"location_types":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["home","recent"]}}},"additionalProperties":false}},"additionalProperties":false},"child_attachments":{"minItems":2,"maxItems":10,"type":"array","items":{"type":"object","properties":{"link":{"type":"string","format":"uri"},"name":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":1000},"picture":{"type":"string","format":"uri"}},"required":["link","picture"],"additionalProperties":false}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string","enum":["SCHEDULED","SCHEDULED_RECURRING","DRAFT","PUBLISH_PENDING","ADS_POST","INLINE_CREATED","PUBLISHED","REVIEWABLE_BRANDED_CONTENT"]},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string","minLength":1,"maxLength":256},"spherical":{"type":"boolean"},"media_options":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text_custom":{"type":"string","minLength":1,"maxLength":1000}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["threads"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","IMAGE","VIDEO","CAROUSEL","REPOST"]},"reply_to_id":{"type":"string","minLength":1,"maxLength":256},"quote_post_id":{"type":"string","minLength":1,"maxLength":256},"repost_target_id":{"type":"string","minLength":1,"maxLength":256},"reply_control":{"type":"string","enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"]},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","properties":{"option_a":{"type":"string","minLength":1,"maxLength":25},"option_b":{"type":"string","minLength":1,"maxLength":25},"option_c":{"type":"string","minLength":1,"maxLength":25},"option_d":{"type":"string","minLength":1,"maxLength":25}},"required":["option_a","option_b"],"additionalProperties":false},"gif_attachment":{"type":"object","properties":{"gif_id":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","enum":["GIPHY"]}},"required":["gif_id","provider"],"additionalProperties":false},"text_attachment":{"type":"object","properties":{"plaintext":{"type":"string","minLength":1,"maxLength":10000},"link_attachment_url":{"type":"string","format":"uri"},"text_with_styling_info":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"styling_info":{"minItems":1,"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}},"required":["offset","length","styling_info"],"additionalProperties":false}}},"required":["plaintext"],"additionalProperties":false},"topic_tag":{"type":"string","minLength":1,"maxLength":50},"text_entities":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"entity_type":{"type":"string","enum":["SPOILER","spoiler"]},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["entity_type","offset","length"],"additionalProperties":false}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"location_id":{"type":"string","minLength":1,"maxLength":256},"allowlisted_country_codes":{"minItems":1,"maxItems":249,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"media_options":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text":{"type":"string","minLength":1,"maxLength":1000},"is_spoiler_media":{"type":"boolean"}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["youtube"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["VIDEO"]},"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000},"tags":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"category_id":{"anyOf":[{"type":"string","minLength":0,"maxLength":0},{"type":"string","pattern":"^\\d+$"}]},"default_language":{"type":"string","minLength":2,"maxLength":35},"localizations":{"type":"object","additionalProperties":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["title","description"],"additionalProperties":false}},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","enum":["SHORT"]},"brand_partner":{"type":"object","properties":{"channel_id":{"type":"string","pattern":"^UC[A-Za-z0-9_-]+$"},"channel_handle":{"type":"string","pattern":"^@[A-Za-z0-9._-]+$"}},"additionalProperties":false}},"required":["post_type","title","privacy_status","cancellation_mode"],"additionalProperties":false}},"required":["platform","publish_options"],"additionalProperties":false}]},"scheduled_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},"schedule_dst_disambiguation":{"type":"string","enum":["exact","earlier","later"]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"automatic_retry_enabled":{"type":"boolean"},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["social_account_id","provider_payload","scheduled_at","idempotency_key"],"additionalProperties":false}}},"required":["workspace_id","targets"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"successes":{"type":"array","items":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"},"post":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at","project_id","batch_id","source_ref"],"additionalProperties":false}},"required":["social_account_id","post"],"additionalProperties":false}},"failures":{"type":"array","items":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"},"code":{"type":"string"},"message":{"type":"string"}},"required":["social_account_id","code","message"],"additionalProperties":false}}},"required":["batch_id","successes","failures"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/bulk-create"],"slug":"bulk-create-scheduled-posts"},{"name":"sosoapi_update_scheduled_post","title":"Update scheduled post","description":"Edit a scheduled post that has not been dispatched (caption, hashtags, media, link, time). Needs expected_version from the latest read; a stale version is rejected.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"expected_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"patch":{"type":"object","properties":{"caption":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"hashtags":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}},"media":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"scheduled_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},"schedule_dst_disambiguation":{"type":"string","enum":["exact","earlier","later"]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]}},"additionalProperties":false},"provider_payload":{"anyOf":[{"type":"object","properties":{"platform":{"type":"string","enum":["x"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT"]}},"required":["post_type"],"additionalProperties":false}},"required":["platform"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["instagram"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO"]},"location_id":{"type":"string","minLength":1,"maxLength":256},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1,"maxLength":30}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"audio_name":{"type":"string","minLength":1,"maxLength":100},"trial_params":{"type":"object","properties":{"graduation_strategy":{"type":"string","enum":["MANUAL","SS_PERFORMANCE"]}},"required":["graduation_strategy"],"additionalProperties":false},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"maxItems":2,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"is_paid_partnership":{"type":"boolean"},"media_options":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text":{"type":"string","minLength":1,"maxLength":1000},"user_tags":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"username":{"type":"string","minLength":1,"maxLength":30},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["username"],"additionalProperties":false}},"product_tags":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","minLength":1,"maxLength":256},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["product_id"],"additionalProperties":false}},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["facebook"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","REELS","STORY_IMAGE","STORY_VIDEO"]},"title":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":5000},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string","minLength":1,"maxLength":256},"tags":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"feed_targeting":{"type":"object","properties":{"age_min":{"type":"integer","minimum":13,"maximum":65},"age_max":{"type":"integer","minimum":13,"maximum":65},"college_years":{"maxItems":100,"type":"array","items":{"type":"integer","minimum":1900,"maximum":2200}},"education_statuses":{"maxItems":3,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]},{"type":"number","enum":[3]}]}},"genders":{"maxItems":2,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]}},"geo_locations":{"type":"object","properties":{"countries":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"regions":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"cities":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]},"radius":{"type":"number","exclusiveMinimum":0,"maximum":1000},"distance_unit":{"type":"string","enum":["mile","kilometer"]}},"required":["key"],"additionalProperties":false}},"zips":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"location_types":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["home","recent"]}}},"additionalProperties":false},"interests":{"maxItems":250,"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"locales":{"maxItems":250,"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}},"relationship_statuses":{"maxItems":4,"type":"array","items":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]},{"type":"number","enum":[3]},{"type":"number","enum":[4]}]}}},"additionalProperties":false},"targeting":{"type":"object","properties":{"age_min":{"anyOf":[{"type":"number","enum":[13]},{"type":"number","enum":[15]},{"type":"number","enum":[18]},{"type":"number","enum":[21]},{"type":"number","enum":[25]}]},"geo_locations":{"type":"object","properties":{"countries":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"regions":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"cities":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]},"radius":{"type":"number","exclusiveMinimum":0,"maximum":1000},"distance_unit":{"type":"string","enum":["mile","kilometer"]}},"required":["key"],"additionalProperties":false}},"zips":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"object","properties":{"key":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"integer","minimum":0,"maximum":9007199254740991}]}},"required":["key"],"additionalProperties":false}},"location_types":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","enum":["home","recent"]}}},"additionalProperties":false}},"additionalProperties":false},"child_attachments":{"minItems":2,"maxItems":10,"type":"array","items":{"type":"object","properties":{"link":{"type":"string","format":"uri"},"name":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":1000},"picture":{"type":"string","format":"uri"}},"required":["link","picture"],"additionalProperties":false}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string","enum":["SCHEDULED","SCHEDULED_RECURRING","DRAFT","PUBLISH_PENDING","ADS_POST","INLINE_CREATED","PUBLISHED","REVIEWABLE_BRANDED_CONTENT"]},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string","minLength":1,"maxLength":256},"spherical":{"type":"boolean"},"media_options":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text_custom":{"type":"string","minLength":1,"maxLength":1000}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["threads"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","IMAGE","VIDEO","CAROUSEL","REPOST"]},"reply_to_id":{"type":"string","minLength":1,"maxLength":256},"quote_post_id":{"type":"string","minLength":1,"maxLength":256},"repost_target_id":{"type":"string","minLength":1,"maxLength":256},"reply_control":{"type":"string","enum":["everyone","accounts_you_follow","mentioned_only","parent_post_author_only","followers_only"]},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","properties":{"option_a":{"type":"string","minLength":1,"maxLength":25},"option_b":{"type":"string","minLength":1,"maxLength":25},"option_c":{"type":"string","minLength":1,"maxLength":25},"option_d":{"type":"string","minLength":1,"maxLength":25}},"required":["option_a","option_b"],"additionalProperties":false},"gif_attachment":{"type":"object","properties":{"gif_id":{"type":"string","minLength":1,"maxLength":256},"provider":{"type":"string","enum":["GIPHY"]}},"required":["gif_id","provider"],"additionalProperties":false},"text_attachment":{"type":"object","properties":{"plaintext":{"type":"string","minLength":1,"maxLength":10000},"link_attachment_url":{"type":"string","format":"uri"},"text_with_styling_info":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"styling_info":{"minItems":1,"type":"array","items":{"type":"string","enum":["bold","italic","highlight","underline","strikethrough"]}}},"required":["offset","length","styling_info"],"additionalProperties":false}}},"required":["plaintext"],"additionalProperties":false},"topic_tag":{"type":"string","minLength":1,"maxLength":50},"text_entities":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"entity_type":{"type":"string","enum":["SPOILER","spoiler"]},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"length":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["entity_type","offset","length"],"additionalProperties":false}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"location_id":{"type":"string","minLength":1,"maxLength":256},"allowlisted_country_codes":{"minItems":1,"maxItems":249,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"media_options":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"alt_text":{"type":"string","minLength":1,"maxLength":1000},"is_spoiler_media":{"type":"boolean"}},"required":["asset_id"],"additionalProperties":false}}},"required":["post_type"],"additionalProperties":false}},"required":["platform"],"additionalProperties":false},{"type":"object","properties":{"platform":{"type":"string","enum":["youtube"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["VIDEO"]},"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000},"tags":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"category_id":{"anyOf":[{"type":"string","minLength":0,"maxLength":0},{"type":"string","pattern":"^\\d+$"}]},"default_language":{"type":"string","minLength":2,"maxLength":35},"localizations":{"type":"object","additionalProperties":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":5000}},"required":["title","description"],"additionalProperties":false}},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","enum":["SHORT"]},"brand_partner":{"type":"object","properties":{"channel_id":{"type":"string","pattern":"^UC[A-Za-z0-9_-]+$"},"channel_handle":{"type":"string","pattern":"^@[A-Za-z0-9._-]+$"}},"additionalProperties":false}},"required":["post_type","title","privacy_status","cancellation_mode"],"additionalProperties":false}},"required":["platform"],"additionalProperties":false}]}},"required":["id","expected_version","patch"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at","project_id","batch_id","source_ref"],"additionalProperties":false}},"required":["post"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/update"],"slug":"update-scheduled-post"},{"name":"sosoapi_publish_scheduled_post_now","title":"Publish scheduled post now","description":"Publish a scheduled post immediately instead of at scheduled_at. Public and not undoable; needs expected_version. Queued is not published: read the outcome.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"expected_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","expected_version"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at","project_id","batch_id","source_ref"],"additionalProperties":false}},"required":["post"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/publish-now"],"slug":"publish-scheduled-post-now"},{"name":"sosoapi_retry_scheduled_post","title":"Retry scheduled post","description":"Retry a failed scheduled post, optionally at a new scheduled_at. Needs expected_version.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"expected_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"scheduled_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","expected_version"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at","project_id","batch_id","source_ref"],"additionalProperties":false}},"required":["post"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/retry"],"slug":"retry-scheduled-post"},{"name":"sosoapi_delete_scheduled_post","title":"Delete scheduled post","description":"Delete a scheduled post that is not published (scheduled, needs_reschedule, failed or cancelled). Agents cannot delete provider content once published. Needs expected_version.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"expected_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","expected_version"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at","project_id","batch_id","source_ref"],"additionalProperties":false}},"required":["post"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/delete"],"slug":"delete-scheduled-post"},{"name":"sosoapi_cancel_scheduled_post","title":"Cancel scheduled post","description":"Cancel a scheduled post that has not been published yet so it never goes out. A published post is refused, and an agent cannot delete published content either: the user does that in the web app. Needs expected_version.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"expected_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","expected_version"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at","project_id","batch_id","source_ref"],"additionalProperties":false}},"required":["post"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/cancel"],"slug":"cancel-scheduled-post"},{"name":"sosoapi_withdraw_scheduled_post_delete","title":"Withdraw deletion request","description":"Withdraw a stopped Instagram Login deletion request and retain the published post. Needs expected_version.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"expected_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","expected_version"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at","project_id","batch_id","source_ref"],"additionalProperties":false}},"required":["post"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/withdraw-delete"],"slug":"withdraw-scheduled-post-delete"},{"name":"sosoapi_get_dashboard_counts","title":"Get dashboard counts","description":"Read a Workspace's operational counts: scheduled posts, recent jobs and connected accounts.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"scheduledCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"recentJobsCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"socialsCount":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["scheduledCount","recentJobsCount","socialsCount"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/analytics-api/dashboard/ops-counts"],"slug":"get-dashboard-counts"},{"name":"sosoapi_list_monitored_posts","title":"List monitored posts","description":"List social posts SosoAPI has discovered for a Workspace (id, platform, permalink, publish time), filterable by account, platform and time, cursor-paged. Metadata only, no captions.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"cursor":{"type":"string","minLength":1,"maxLength":16384,"pattern":"^sa1\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$"},"page_size":{"type":"integer","minimum":1,"maximum":100},"filters":{"type":"object","properties":{"social_account_ids":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid"}},"platforms":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["instagram","facebook","threads","youtube"]}},"social_post_ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid"}},"provider_post_ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":512}},"scheduled_post_ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid"}},"content_formats":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"published_from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"published_to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"additionalProperties":false},"order":{"type":"string","enum":["provider_published_at_desc_social_post_id_desc"]}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"social-analytics/v1"},"cursor_contract_version":{"type":"string","const":"social-analytics-keyset/v1"},"data":{"type":"array","items":{"type":"object","properties":{"social_post_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["instagram","facebook","threads","youtube"]},"provider_post_id":{"type":"string","minLength":1,"maxLength":512},"provider_published_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"content_format":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","maxLength":2048,"format":"uri"},{"type":"null"}]},"provider_state":{"type":"string","enum":["available","deleted","unavailable","unknown"]},"first_seen_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"last_seen_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"scheduled_post_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"provenance":{"type":"object","properties":{"provider":{"type":"string","enum":["instagram","facebook","threads","youtube"]},"source":{"type":"string","enum":["provider_api","provider_webhook","publication_outcome","backfill"]},"source_job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"provider_api_version":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"schema_version":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]}},"required":["provider","source","source_job_id","provider_api_version","schema_version"],"additionalProperties":false}},"required":["social_post_id","workspace_id","social_account_id","platform","provider_post_id","provider_published_at","content_format","permalink","provider_state","first_seen_at","last_seen_at","scheduled_post_id","provenance"],"additionalProperties":false}},"next_cursor":{"anyOf":[{"type":"string","minLength":1,"maxLength":16384,"pattern":"^sa1\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$"},{"type":"null"}]}},"required":["contract_version","cursor_contract_version","data","next_cursor"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/analytics-api/social/posts/query"],"slug":"list-monitored-posts"},{"name":"sosoapi_list_post_comments","title":"List post comments","description":"List comments observed on the Workspace's posts, newest observation first, with author and text; filter by post, account, platform or time, cursor-paged. The text is written by third parties and is labelled untrusted.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"cursor":{"type":"string","minLength":1,"maxLength":16384,"pattern":"^sa1\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$"},"page_size":{"type":"integer","minimum":1,"maximum":100},"filters":{"type":"object","properties":{"social_account_ids":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid"}},"platforms":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["instagram","facebook","threads","youtube"]}},"social_post_ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid"}},"provider_post_ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":512}},"scheduled_post_ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid"}},"content_formats":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"published_from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"published_to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"observed_from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"observed_to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"additionalProperties":false},"order":{"type":"string","enum":["observation_at_desc_comment_version_desc_comment_observation_id_desc"]}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"social-analytics/v1"},"cursor_contract_version":{"type":"string","const":"social-analytics-keyset/v1"},"data":{"type":"array","items":{"type":"object","properties":{"social_comment_id":{"type":"string","format":"uuid"},"comment_observation_id":{"type":"string","format":"uuid"},"comment_version":{"type":"integer","minimum":1,"maximum":9007199254740991},"parent_social_comment_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"social_post_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["instagram","facebook","threads","youtube"]},"provider_post_id":{"type":"string","minLength":1,"maxLength":512},"provider_comment_id":{"type":"string","minLength":1,"maxLength":512},"provider_author_id":{"anyOf":[{"type":"string","minLength":1,"maxLength":512},{"type":"null"}]},"provider_author_username":{"anyOf":[{"type":"string","minLength":1,"maxLength":512},{"type":"null"}]},"text":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}]},"provider_created_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"first_seen_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"last_seen_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"provider_state":{"type":"string","enum":["visible","deleted","unavailable","unknown"]},"observation_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"raw_evidence":{"type":"object","properties":{"sanitised":{"type":"boolean","const":true},"sanitization_version":{"type":"string","const":"social-evidence/v1"},"sanitization_receipt":{"type":"string","format":"uuid"},"redacted_fields":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"payload":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":200},"additionalProperties":{"$ref":"#/definitions/__schema0"}}},"required":["sanitised","sanitization_version","sanitization_receipt","redacted_fields","payload"],"additionalProperties":false},"provenance":{"type":"object","properties":{"provider":{"type":"string","enum":["instagram","facebook","threads","youtube"]},"source":{"type":"string","enum":["provider_api","provider_webhook","publication_outcome","backfill"]},"source_job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"provider_api_version":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"schema_version":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]}},"required":["provider","source","source_job_id","provider_api_version","schema_version"],"additionalProperties":false}},"required":["social_comment_id","comment_observation_id","comment_version","parent_social_comment_id","social_post_id","social_account_id","platform","provider_post_id","provider_comment_id","provider_author_id","provider_author_username","text","provider_created_at","first_seen_at","last_seen_at","provider_state","observation_at","raw_evidence","provenance"],"additionalProperties":false}},"next_cursor":{"anyOf":[{"type":"string","minLength":1,"maxLength":16384,"pattern":"^sa1\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$"},{"type":"null"}]}},"required":["contract_version","cursor_contract_version","data","next_cursor"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/definitions/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/definitions/__schema0"}}]}}},"routes":["/analytics-api/social/comments/query"],"slug":"list-post-comments"},{"name":"sosoapi_request_provider_insights","title":"Request provider insights","description":"Ask the provider for insights for an account or one post over an optional date range (up to 366 days). Returns a request_id and, when cached, the result; otherwise poll sosoapi_get_provider_insight_status.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"resource_kind":{"type":"string","enum":["account","post"]},"provider_resource_id":{"type":"string","minLength":1,"maxLength":512},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"include_audience":{"type":"boolean"},"refresh":{"type":"boolean"}},"required":["workspace_id","social_account_id","resource_kind"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"provider-insights/v1"},"request_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","completed"]},"cache_status":{"type":"string","enum":["hit","miss","bypassed"]},"poll_after_ms":{"type":"integer","minimum":0,"maximum":60000},"result":{"type":"object","properties":{"contract_version":{"type":"string","const":"provider-insights/v1"},"request_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["facebook","instagram","threads","youtube"]},"resource":{"type":"object","properties":{"kind":{"type":"string","enum":["account","post"]},"social_account_id":{"type":"string","format":"uuid"},"provider_resource_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["kind","social_account_id","provider_resource_id"],"additionalProperties":false},"provider_api_version":{"type":"string","minLength":1,"maxLength":100},"fetched_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","enum":["available","partial","unavailable"]},"availability":{"minItems":1,"maxItems":64,"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed"]},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["scope","status"],"additionalProperties":false}},"provider_data":{"anyOf":[{},{"type":"null"}]},"requested_date_range":{"anyOf":[{"type":"object","properties":{"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["start_date","end_date"],"additionalProperties":false},{"type":"null"}]},"cache":{"type":"object","properties":{"authoritative":{"type":"boolean","const":false},"status":{"type":"string","enum":["stored","hit","bypassed"]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["authoritative","status","expires_at"],"additionalProperties":false}},"required":["contract_version","request_id","platform","resource","provider_api_version","fetched_at","status","availability","provider_data","requested_date_range","cache"],"additionalProperties":false}},"required":["contract_version","request_id","status","cache_status","poll_after_ms"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/analytics-api/provider-insights/request"],"slug":"request-provider-insights"},{"name":"sosoapi_get_provider_insight_status","title":"Get provider insight status","description":"Read an insights request (request_id): queued, processing, completed (with the provider result and per-metric availability) or failed.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"request_id":{"type":"string","format":"uuid"}},"required":["workspace_id","request_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"provider-insights/v1"},"request_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","processing","completed","failed"]},"attempt_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"result":{"type":"object","properties":{"contract_version":{"type":"string","const":"provider-insights/v1"},"request_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["facebook","instagram","threads","youtube"]},"resource":{"type":"object","properties":{"kind":{"type":"string","enum":["account","post"]},"social_account_id":{"type":"string","format":"uuid"},"provider_resource_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["kind","social_account_id","provider_resource_id"],"additionalProperties":false},"provider_api_version":{"type":"string","minLength":1,"maxLength":100},"fetched_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","enum":["available","partial","unavailable"]},"availability":{"minItems":1,"maxItems":64,"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed"]},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["scope","status"],"additionalProperties":false}},"provider_data":{"anyOf":[{},{"type":"null"}]},"requested_date_range":{"anyOf":[{"type":"object","properties":{"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["start_date","end_date"],"additionalProperties":false},{"type":"null"}]},"cache":{"type":"object","properties":{"authoritative":{"type":"boolean","const":false},"status":{"type":"string","enum":["stored","hit","bypassed"]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["authoritative","status","expires_at"],"additionalProperties":false}},"required":["contract_version","request_id","platform","resource","provider_api_version","fetched_at","status","availability","provider_data","requested_date_range","cache"],"additionalProperties":false},"error":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":100},"reason":{"type":"string","minLength":1,"maxLength":2000},"retryable":{"type":"boolean"}},"required":["code","reason","retryable"],"additionalProperties":false}},"required":["contract_version","request_id","status","attempt_count"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/analytics-api/provider-insights/status"],"slug":"get-provider-insight-status"},{"name":"sosoapi_start_instagram_oauth","title":"Start Instagram OAuth","description":"Get the provider authorize_url a human must open to connect an Instagram account. Pass workspace_id. Nothing is connected until they approve and confirm in the browser.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"redirect_to":{"type":"string","format":"uri"},"workspace_id":{"type":"string","format":"uuid"},"expected_platform_user_id":{"type":"string","minLength":1},"interaction_mode":{"type":"string","enum":["connect","request_scopes","switch_account","recover"]}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"authorize_url":{"type":"string","format":"uri"}},"required":["authorize_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/oauth-api/instagram/init"],"slug":"start-instagram-oauth"},{"name":"sosoapi_refresh_instagram_oauth","title":"Refresh Instagram OAuth","description":"Refresh an Instagram connection's access token (optionally one social_account_id); reports whether it refreshed and the new expiry.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"refreshed":{"type":"boolean"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ok","refreshed","expires_at"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/oauth-api/instagram/refresh"],"slug":"refresh-instagram-oauth"},{"name":"sosoapi_start_threads_oauth","title":"Start Threads OAuth","description":"Get the provider authorize_url a human must open to connect a Threads account. Pass workspace_id. Nothing is connected until they approve and confirm in the browser.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"redirect_to":{"type":"string","format":"uri"},"workspace_id":{"type":"string","format":"uuid"},"expected_platform_user_id":{"type":"string","minLength":1},"interaction_mode":{"type":"string","enum":["connect","request_scopes","switch_account","recover"]}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"authorize_url":{"type":"string","format":"uri"}},"required":["authorize_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/oauth-api/threads/init"],"slug":"start-threads-oauth"},{"name":"sosoapi_refresh_threads_oauth","title":"Refresh Threads OAuth","description":"Refresh a Threads connection's access token (optionally one social_account_id); reports whether it refreshed and the new expiry.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"refreshed":{"type":"boolean"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ok","refreshed","expires_at"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/oauth-api/threads/refresh"],"slug":"refresh-threads-oauth"},{"name":"sosoapi_check_threads_oauth","title":"Check Threads OAuth","description":"Read the Threads connection's health: connected, expiry, scope and whether it can be refreshed. Pass workspace_id.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["check"]},"workspace_id":{"type":"string","format":"uuid"}},"required":["action"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"connected":{"type":"boolean"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"scope":{"anyOf":[{"type":"string"},{"type":"null"}]},"can_refresh":{"type":"boolean"},"last_refreshed_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["connected","expires_at","scope","can_refresh","last_refreshed_at"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/oauth-api/threads/check"],"slug":"check-threads-oauth"},{"name":"sosoapi_start_meta_oauth","title":"Start Meta OAuth","description":"Get the provider authorize_url a human must open to connect a Facebook Page, or Instagram through Facebook (connection_intent). Pass workspace_id. Nothing is connected until they approve and confirm in the browser.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"redirect_to":{"type":"string","format":"uri"},"workspace_id":{"type":"string","format":"uuid"},"expected_platform_user_id":{"type":"string","minLength":1},"connection_intent":{"type":"string","enum":["facebook","instagram_via_facebook"]},"interaction_mode":{"type":"string","enum":["connect","request_scopes","switch_account","recover"]}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"authorize_url":{"type":"string","format":"uri"}},"required":["authorize_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/oauth-api/meta/init"],"slug":"start-meta-oauth"},{"name":"sosoapi_refresh_meta_oauth","title":"Refresh Meta OAuth","description":"Re-verify a Facebook/Meta connection (social_account_id) and report capability_verified.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"}},"required":["social_account_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"capability_verified":{"type":"boolean","const":true}},"required":["ok","capability_verified"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/oauth-api/meta/refresh"],"slug":"refresh-meta-oauth"},{"name":"sosoapi_start_youtube_oauth","title":"Start YouTube OAuth","description":"Get the provider authorize_url a human must open to connect a YouTube channel. Pass workspace_id. Nothing is connected until they approve and confirm in the browser.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"redirect_to":{"type":"string","format":"uri"},"workspace_id":{"type":"string","format":"uuid"},"expected_platform_user_id":{"type":"string","minLength":1},"interaction_mode":{"type":"string","enum":["connect","request_scopes","switch_account","recover"]}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"authorize_url":{"type":"string","format":"uri"}},"required":["authorize_url"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/oauth-api/youtube/init"],"slug":"start-youtube-oauth"},{"name":"sosoapi_refresh_youtube_oauth","title":"Refresh YouTube OAuth","description":"Refresh a YouTube connection's token (social_account_id); returns the new expiry and capability_verified.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"social_account_id":{"type":"string","format":"uuid"}},"required":["social_account_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"expires_at":{"type":"string"},"capability_verified":{"type":"boolean","const":true}},"required":["ok","expires_at","capability_verified"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/oauth-api/youtube/refresh"],"slug":"refresh-youtube-oauth"},{"name":"sosoapi_list_jobs","title":"List jobs","description":"List the signed-in user's recent background jobs with status and progress.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Page size, 1 to 100. Sending limit or cursor switches this route to cursor paging and adds next_cursor to the answer."},"cursor":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque cursor: the next_cursor of the previous page, unchanged. Omit it for the first page. The same filters must be sent with every page."}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"user_id":{"type":"string","format":"uuid"},"kind":{"type":"string"},"status":{"type":"string"},"payload":{"$ref":"#/definitions/__schema0"},"scheduled_for":{"anyOf":[{"type":"string"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"progress":{"anyOf":[{"type":"integer","minimum":0,"maximum":100},{"type":"null"}]},"progress_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","user_id","kind","status","payload","scheduled_for","schedule_timezone","progress","progress_message","created_at","updated_at"],"additionalProperties":false}},"next_cursor":{"description":"Present only when the request sent limit or cursor. Null on the last page.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["jobs"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/definitions/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/definitions/__schema0"}}]}}},"routes":["/jobs-api/list"],"slug":"list-jobs"},{"name":"sosoapi_job_status","title":"Get job status","description":"Read one background job by job_id: status, type and the error message if it failed.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"}},"required":["job_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string"},"job_type":{"type":"string"},"result_data":{"$ref":"#/definitions/__schema0"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","status","job_type","result_data","error_message","created_at","updated_at"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/definitions/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/definitions/__schema0"}}]}}},"routes":["/jobs-api/get"],"slug":"job-status"},{"name":"sosoapi_get_comment_outcome","title":"Get comment delivery outcome","description":"Read confirmed delivery, recovery lineage, pending verification and unresolved follow-up.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"action_id":{"type":"string","format":"uuid"}},"required":["workspace_id","action_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"action_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","executing","succeeded","attention","failed"]},"execution_stage":{"type":"string","enum":["execute","verify"]},"verification_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"verification_evidence":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"delivery_outcome":{"type":"string","enum":["confirmed","recovered","not_attempted","unknown"]},"follow_up_required":{"type":"boolean"},"resolution":{"anyOf":[{"type":"object","properties":{"action_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["confirmed_delivery","confirmed_replacement"]},"replacement_action_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"evidence":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["action_id","workspace_id","kind","replacement_action_id","evidence","created_by","created_at"],"additionalProperties":false},{"type":"null"}]}},"required":["contract_version","action_id","status","execution_stage","verification_count","verification_evidence","delivery_outcome","follow_up_required","resolution"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/comments/outcome"],"slug":"get-comment-outcome"},{"name":"sosoapi_reconcile_comment_outcome","title":"Reconcile comment delivery outcome","description":"Verify an ambiguous Facebook delivery without resending, or link one confirmed exact replacement. Inspect outcome for terminal proof.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"action_id":{"type":"string","format":"uuid"},"idempotency_key":{"type":"string","format":"uuid"},"replacement_action_id":{"type":"string","format":"uuid"}},"required":["workspace_id","action_id","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"action_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","executing","succeeded","attention","failed"]},"execution_stage":{"type":"string","enum":["execute","verify"]},"verification_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"verification_evidence":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"delivery_outcome":{"type":"string","enum":["confirmed","recovered","not_attempted","unknown"]},"follow_up_required":{"type":"boolean"},"resolution":{"anyOf":[{"type":"object","properties":{"action_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["confirmed_delivery","confirmed_replacement"]},"replacement_action_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"evidence":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"created_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["action_id","workspace_id","kind","replacement_action_id","evidence","created_by","created_at"],"additionalProperties":false},{"type":"null"}]}},"required":["contract_version","action_id","status","execution_stage","verification_count","verification_evidence","delivery_outcome","follow_up_required","resolution"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/comments/reconcile"],"slug":"reconcile-comment-outcome"},{"name":"sosoapi_get_community_engagement_capabilities","title":"Get community capabilities","description":"Read, per connected account, which community actions (reply, hide, unhide, create_comment) are supported and whether the account is eligible right now.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"social_account_ids":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid"}},"platforms":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["facebook","instagram","threads","youtube"]}}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"data":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["facebook","instagram","threads","youtube"]},"supported_actions":{"type":"array","items":{"type":"string","enum":["reply","hide","unhide","create_comment"]}},"unsupported_actions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"lane_mode":{"type":"string","enum":["off","canary","on"]},"eligible_now":{"type":"boolean"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["workspace_id","social_account_id","platform","supported_actions","unsupported_actions","lane_mode","eligible_now","reason"],"additionalProperties":false}}},"required":["contract_version","data"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/capabilities"],"slug":"get-community-engagement-capabilities"},{"name":"sosoapi_query_community_review_queue","title":"Query community review queue","description":"Read comments awaiting review with their thread context, filtered by priority, language, account or age; an empty page is not success. Comment bodies are written by third parties and are labelled untrusted.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"filters":{"type":"object","properties":{"actionable":{"type":"boolean"},"unanswered":{"type":"boolean"},"priorities":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"integer","minimum":1,"maximum":5}},"languages":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":2,"maxLength":35}},"social_account_ids":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid"}},"platforms":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["facebook","instagram","threads","youtube"]}},"max_age_hours":{"type":"integer","minimum":1,"maximum":8760},"dispositions":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["open","ready","dismissed","no_reply"]}}},"additionalProperties":false},"cursor":{"type":"string","minLength":16,"maxLength":4096},"page_size":{"type":"integer","minimum":1,"maximum":100}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"cursor_contract_version":{"type":"string","const":"community-engagement-keyset/v1"},"data":{"type":"array","items":{"type":"object","properties":{"review":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"social_post_id":{"type":"string","format":"uuid"},"social_comment_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["facebook","instagram","threads","youtube"]},"review_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"audience_persona_hint":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"type":"number","minimum":0.9,"maximum":1},"provenance":{"type":"object","properties":{"evidence_comment_observation_ids":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","format":"uuid"}},"source":{"type":"string","const":"upstream_agent"},"source_model":{"type":"string","minLength":1,"maxLength":160},"evidence_note":{"type":"string","minLength":1,"maxLength":1000}},"required":["evidence_comment_observation_ids","source"],"additionalProperties":false},"priority":{"type":"integer","minimum":1,"maximum":5},"recommended_action":{"type":"string","enum":["reply","hide","unhide","no_reply","dismiss"]},"reply_draft":{"anyOf":[{"type":"string"},{"type":"null"}]},"disposition":{"type":"string","enum":["open","ready","dismissed","no_reply"]},"assignee_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspace_id","social_account_id","social_post_id","social_comment_id","platform","review_version","language","audience_persona_hint","confidence","provenance","priority","recommended_action","reply_draft","disposition","assignee_user_id","created_at","updated_at"],"additionalProperties":false},"current_action":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"action":{"type":"string","enum":["reply","hide","unhide"]},"status":{"type":"string","enum":["queued","executing","succeeded","attention","failed"]},"attention_reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"terminal_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","action","status","attention_reason","updated_at","terminal_at"],"additionalProperties":false},{"type":"null"}]},"post":{"type":"object","properties":{"provider_post_id":{"type":"string","minLength":1,"maxLength":512},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["provider_post_id","permalink"],"additionalProperties":false},"comment":{"type":"object","properties":{"provider_comment_id":{"type":"string","minLength":1,"maxLength":512},"parent_social_comment_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_state":{"type":"string","minLength":1,"maxLength":80},"provider_created_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"source_permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["provider_comment_id","parent_social_comment_id","body","provider_state","provider_created_at","source_permalink"],"additionalProperties":false},"thread_context":{"maxItems":25,"type":"array","items":{"type":"object","properties":{"social_comment_id":{"type":"string","format":"uuid"},"provider_comment_id":{"type":"string","minLength":1,"maxLength":512},"parent_social_comment_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_state":{"type":"string","minLength":1,"maxLength":80},"observed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["social_comment_id","provider_comment_id","parent_social_comment_id","body","provider_state","observed_at","permalink"],"additionalProperties":false}},"thread_context_truncated":{"type":"boolean"},"coverage":{"type":"object","properties":{"status":{"type":"string","enum":["complete","partial","stale","missing","unsupported","deferred","unknown","paused"]},"last_success_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"next_check_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string","const":"social-evidence-coverage/v1"}},"required":["status","last_success_at","next_check_at","reason","source"],"additionalProperties":false},"source_links":{"maxItems":3,"type":"array","items":{"type":"string","format":"uri"}}},"required":["review","current_action","post","comment","thread_context","thread_context_truncated","coverage","source_links"],"additionalProperties":false}},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["contract_version","cursor_contract_version","data","next_cursor"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/review-queue/query"],"slug":"query-community-review-queue"},{"name":"sosoapi_submit_community_review","title":"Submit community review","description":"Record a new immutable review version for one comment: recommended action, optional reply_draft, priority and confidence (at least 0.9). Sends and prepares nothing.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"social_post_id":{"type":"string","format":"uuid"},"social_comment_id":{"type":"string","format":"uuid"},"language":{"type":"string","minLength":2,"maxLength":35},"audience_persona_hint":{"type":"string","minLength":1,"maxLength":280},"confidence":{"type":"number","minimum":0.9,"maximum":1},"provenance":{"type":"object","properties":{"evidence_comment_observation_ids":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","format":"uuid"}},"source":{"type":"string","enum":["upstream_agent"]},"source_model":{"type":"string","minLength":1,"maxLength":160},"evidence_note":{"type":"string","minLength":1,"maxLength":1000}},"required":["evidence_comment_observation_ids","source"],"additionalProperties":false},"priority":{"type":"integer","minimum":1,"maximum":5},"recommended_action":{"type":"string","enum":["reply","hide","unhide","no_reply","dismiss"]},"reply_draft":{"type":"string","minLength":1,"maxLength":2000},"disposition":{"type":"string","enum":["open","ready","dismissed","no_reply"]},"assignee_user_id":{"type":"string","format":"uuid"},"idempotency_key":{"type":"string","format":"uuid"}},"required":["workspace_id","social_account_id","social_post_id","social_comment_id","confidence","provenance","priority","recommended_action","disposition","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"review":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"social_post_id":{"type":"string","format":"uuid"},"social_comment_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["facebook","instagram","threads","youtube"]},"review_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"audience_persona_hint":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"type":"number","minimum":0.9,"maximum":1},"provenance":{"type":"object","properties":{"evidence_comment_observation_ids":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","format":"uuid"}},"source":{"type":"string","const":"upstream_agent"},"source_model":{"type":"string","minLength":1,"maxLength":160},"evidence_note":{"type":"string","minLength":1,"maxLength":1000}},"required":["evidence_comment_observation_ids","source"],"additionalProperties":false},"priority":{"type":"integer","minimum":1,"maximum":5},"recommended_action":{"type":"string","enum":["reply","hide","unhide","no_reply","dismiss"]},"reply_draft":{"anyOf":[{"type":"string"},{"type":"null"}]},"disposition":{"type":"string","enum":["open","ready","dismissed","no_reply"]},"assignee_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspace_id","social_account_id","social_post_id","social_comment_id","platform","review_version","language","audience_persona_hint","confidence","provenance","priority","recommended_action","reply_draft","disposition","assignee_user_id","created_at","updated_at"],"additionalProperties":false}},"required":["contract_version","review"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/reviews/submit"],"slug":"submit-community-review"},{"name":"sosoapi_prepare_community_action","title":"Prepare community action","description":"Bind a review version to one action (reply, hide or unhide) and get a short-lived prepare_token for sosoapi_apply_community_action. Sends nothing yet.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"review_id":{"type":"string","format":"uuid"},"expected_review_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"action":{"type":"string","enum":["reply","hide","unhide"]},"reply_draft":{"type":"string","minLength":1,"maxLength":2000},"idempotency_key":{"type":"string","format":"uuid"}},"required":["workspace_id","review_id","expected_review_version","action","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"prepared":{"type":"object","properties":{"prepare_token":{"type":"string","format":"uuid"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"binding":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"social_post_id":{"type":"string","format":"uuid"},"social_comment_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["facebook","instagram","threads","youtube"]},"provider_post_id":{"type":"string","minLength":1,"maxLength":512},"provider_comment_id":{"type":"string","minLength":1,"maxLength":512},"action":{"type":"string","enum":["reply","hide","unhide"]},"desired_hidden":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"draft_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"idempotency_key":{"type":"string","format":"uuid"}},"required":["workspace_id","social_account_id","social_post_id","social_comment_id","platform","provider_post_id","provider_comment_id","action","desired_hidden","draft_sha256","idempotency_key"],"additionalProperties":false}},"required":["prepare_token","expires_at","binding"],"additionalProperties":false}},"required":["contract_version","prepared"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/actions/prepare"],"slug":"prepare-community-action"},{"name":"sosoapi_apply_community_action","title":"Apply community action","description":"Send the action bound to a prepare_token to the provider; a reply is public. Queued is not success: poll sosoapi_get_community_action_status.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"prepare_token":{"type":"string","format":"uuid"}},"required":["workspace_id","prepare_token"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"action":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"social_post_id":{"type":"string","format":"uuid"},"social_comment_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["facebook","instagram","threads","youtube"]},"provider_post_id":{"type":"string","minLength":1,"maxLength":512},"provider_comment_id":{"type":"string","minLength":1,"maxLength":512},"action":{"type":"string","enum":["reply","hide","unhide"]},"desired_hidden":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"draft_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"idempotency_key":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","executing","succeeded","attention","failed"]},"attempt_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"provider_evidence":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"terminal_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","social_post_id","social_comment_id","platform","provider_post_id","provider_comment_id","action","desired_hidden","draft_sha256","idempotency_key","status","attempt_count","provider_evidence","created_at","updated_at","terminal_at"],"additionalProperties":false}},"required":["contract_version","action"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/actions/apply"],"slug":"apply-community-action"},{"name":"sosoapi_get_community_action_status","title":"Get community action status","description":"Read the terminal receipt of an applied community action (action_id); enqueue is not success.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"action_id":{"type":"string","format":"uuid"}},"required":["workspace_id","action_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"action":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"social_post_id":{"type":"string","format":"uuid"},"social_comment_id":{"type":"string","format":"uuid"},"platform":{"type":"string","enum":["facebook","instagram","threads","youtube"]},"provider_post_id":{"type":"string","minLength":1,"maxLength":512},"provider_comment_id":{"type":"string","minLength":1,"maxLength":512},"action":{"type":"string","enum":["reply","hide","unhide"]},"desired_hidden":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"draft_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"idempotency_key":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","executing","succeeded","attention","failed"]},"attempt_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"provider_evidence":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"terminal_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","social_post_id","social_comment_id","platform","provider_post_id","provider_comment_id","action","desired_hidden","draft_sha256","idempotency_key","status","attempt_count","provider_evidence","created_at","updated_at","terminal_at"],"additionalProperties":false},"receipt":{"anyOf":[{"type":"object","properties":{"action_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["succeeded","attention","failed"]},"provider_evidence":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"terminal_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"attention_reason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["action_id","status","provider_evidence","terminal_at","attention_reason"],"additionalProperties":false},{"type":"null"}]}},"required":["contract_version","action","receipt"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/actions/status"],"slug":"get-community-action-status"},{"name":"sosoapi_create_comment","title":"Create community comment","description":"Queue one exact comment against a canonical post or comment target; status is not provider success.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"target":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["post"]},"social_post_id":{"type":"string","format":"uuid"}},"required":["kind","social_post_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["comment"]},"social_comment_id":{"type":"string","format":"uuid"}},"required":["kind","social_comment_id"],"additionalProperties":false}]},"message":{"type":"string","minLength":1,"maxLength":2000},"idempotency_key":{"type":"string","format":"uuid"}},"required":["workspace_id","social_account_id","target","message","idempotency_key"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"replayed":{"type":"boolean"},"action":{"type":"object","properties":{"action_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"target":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"post"},"social_post_id":{"type":"string","format":"uuid"}},"required":["kind","social_post_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"comment"},"social_post_id":{"type":"string","format":"uuid"},"social_comment_id":{"type":"string","format":"uuid"}},"required":["kind","social_post_id","social_comment_id"],"additionalProperties":false}]},"content_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"idempotency_key":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","executing","succeeded","attention","failed"]},"poll_after_ms":{"type":"integer","minimum":0,"maximum":300000}},"required":["action_id","workspace_id","social_account_id","target","content_sha256","idempotency_key","status","poll_after_ms"],"additionalProperties":false}},"required":["contract_version","replayed","action"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/comments/create"],"slug":"create-comment"},{"name":"sosoapi_get_comment_action_status","title":"Get community comment status","description":"Read the sanitized terminal receipt for a direct comment action.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"action_id":{"type":"string","format":"uuid"}},"required":["workspace_id","action_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"action":{"type":"object","properties":{"action_id":{"type":"string","format":"uuid"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"type":"string","format":"uuid"},"target":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"post"},"social_post_id":{"type":"string","format":"uuid"}},"required":["kind","social_post_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"comment"},"social_post_id":{"type":"string","format":"uuid"},"social_comment_id":{"type":"string","format":"uuid"}},"required":["kind","social_post_id","social_comment_id"],"additionalProperties":false}]},"content_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"idempotency_key":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","executing","succeeded","attention","failed"]},"attempt_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["action_id","workspace_id","social_account_id","target","content_sha256","idempotency_key","status","attempt_count","created_at","updated_at"],"additionalProperties":false},"receipt":{"anyOf":[{"type":"object","properties":{"action_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["succeeded","attention","failed"]},"provider_terminal":{"type":"boolean"},"provider_comment_id":{"anyOf":[{"type":"string","minLength":1,"maxLength":512},{"type":"null"}]},"terminal_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"attention_reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}},"required":["action_id","status","provider_terminal","provider_comment_id","terminal_at","attention_reason"],"additionalProperties":false},{"type":"null"}]}},"required":["contract_version","action","receipt"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/comments/status"],"slug":"get-comment-action-status"},{"name":"sosoapi_get_community_engagement_summary","title":"Get community summary","description":"Read a Workspace's community operations summary: lane mode, backlog, response times, action statuses and provider rates.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"core":false,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"}},"required":["workspace_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"contract_version":{"type":"string","const":"community-engagement/v1"},"summary":{"type":"object","properties":{"lane_mode":{"type":"string","enum":["off","canary","on"]},"backlog":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}},"response_time_seconds":{"type":"object","properties":{"median":{"anyOf":[{"type":"number"},{"type":"null"}]},"p95":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["median","p95"],"additionalProperties":false},"action_statuses":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}},"provider_rate":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}},"partial_failure_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"known_common_dependencies":{"type":"array","items":{"type":"string"}}},"required":["lane_mode","backlog","response_time_seconds","action_statuses","provider_rate","partial_failure_count","known_common_dependencies"],"additionalProperties":false}},"required":["contract_version","summary"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/community-engagement-api/operations/summary"],"slug":"get-community-engagement-summary"},{"name":"sosoapi_post_image_url","title":"Post one image from a URL","description":"Submit the complete image URL post once, with empty media. The backend prepares and publishes it even after disconnect. Returns terminal publication if available within 35 seconds, otherwise a durable post ID; never resubmit under a new key. Needs operate and publish grants. Local time/DST fields go together. import_id is for resuming older clients only.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio","http"],"inputSchema":{"type":"object","properties":{"source_url":{"type":"string","maxLength":2048,"format":"uri"},"post":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"social_account_id":{"type":"string","format":"uuid"},"caption":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}]},"hashtags":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}},"media":{"maxItems":0,"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"provider_payload":{"type":"object","properties":{"platform":{"type":"string","enum":["threads","instagram","facebook"]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["IMAGE","STORY_IMAGE"]}},"required":["post_type"],"additionalProperties":{}}},"required":["platform","publish_options"],"additionalProperties":false},"scheduled_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},"schedule_dst_disambiguation":{"type":"string","enum":["exact","earlier","later"]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","additionalProperties":{}},{"type":"null"}]},"automatic_retry_enabled":{"type":"boolean"},"idempotency_key":{"type":"string","minLength":8,"maxLength":160}},"required":["workspace_id","social_account_id","provider_payload","scheduled_at","idempotency_key"],"additionalProperties":false},"import_id":{"description":"Use only the import_id returned for this same URL, Workspace and user intent.","type":"string","format":"uuid"}},"required":["source_url","post"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"stage":{"type":"string","enum":["media_pending","media_failed","scheduled"]},"import_id":{"type":"string","format":"uuid"},"completion":{"type":"string","enum":["pending","terminal"]},"scheduled_post":{"anyOf":[{"type":"object","properties":{"post":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"},"workspace_id":{"type":"string","format":"uuid"},"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"destination":{"type":"object","properties":{"social_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram","threads","facebook","youtube","x"]},"platform_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"account_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["social_account_id","platform","platform_user_id","account_label"],"additionalProperties":false},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"hashtags":{"type":"array","items":{"type":"string"}},"media":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["image","video"]},"url":{"type":"string","format":"uri"},"cover_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"asset_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"mime_type":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"preview_url":{"description":"Temporary authorized read URL; keep url as persisted Scheduled Post media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cover_preview_url":{"description":"Temporary authorized cover read URL; keep cover_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["kind","url"],"additionalProperties":false}},"link_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"publish_options":{"type":"object","properties":{"post_type":{"type":"string","enum":["TEXT","LINK","IMAGE","MULTI_IMAGE","VIDEO","CAROUSEL","REELS","STORY_IMAGE","STORY_VIDEO","REPOST","SHORT"]},"location_id":{"type":"string","minLength":1},"share_to_feed":{"type":"boolean"},"collaborators":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1}},"first_comment":{"type":"string","minLength":1,"maxLength":2200},"topic_tag":{"type":"string","minLength":1},"thumb_offset_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string","maxLength":255},"youtube_privacy_status":{"type":"string","enum":["private","unlisted","public"]},"youtube_category_id":{"type":"string","pattern":"^\\d+$"},"youtube_contains_synthetic_media":{"type":"boolean"},"description":{"type":"string","maxLength":5000},"category_id":{"type":"string","pattern":"^\\d+$"},"privacy_status":{"type":"string","enum":["private","unlisted","public"]},"cancellation_mode":{"type":"string","enum":["DELETE","UNSCHEDULE_KEEP_PRIVATE"]},"tags":{"type":"array","items":{"type":"string"}},"default_language":{"type":"string"},"localizations":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"license":{"type":"string","enum":["youtube","creativeCommon"]},"embeddable":{"type":"boolean"},"public_stats_viewable":{"type":"boolean"},"self_declared_made_for_kids":{"type":"boolean"},"contains_synthetic_media":{"type":"boolean"},"has_paid_product_placement":{"type":"boolean"},"recording_date":{"type":"string"},"notify_subscribers":{"type":"boolean"},"thumbnail_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"surface_expectation":{"type":"string","const":"SHORT"},"brand_partner":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_asset_id":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"audio_name":{"type":"string"},"trial_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"is_ai_generated":{"type":"boolean"},"branded_content_sponsor_ids":{"type":"array","items":{"type":"string"}},"is_paid_partnership":{"type":"boolean"},"media_options":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reply_to_id":{"type":"string"},"quote_post_id":{"type":"string"},"repost_target_id":{"type":"string"},"reply_control":{"type":"string"},"enable_reply_approvals":{"type":"boolean"},"link_attachment":{"type":"string","format":"uri"},"poll_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"gif_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_attachment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"text_entities":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_spoiler_media":{"type":"boolean"},"is_ghost_post":{"type":"boolean"},"allowlisted_country_codes":{"type":"array","items":{"type":"string"}},"crossreshare_to_ig":{"type":"boolean"},"crossreshare_to_ig_dark_mode":{"type":"boolean"},"auto_publish_text":{"type":"boolean"},"publication_mode":{"type":"string","enum":["PUBLISH","DRAFT"]},"backdated_time":{"type":"number"},"backdated_time_granularity":{"type":"string","enum":["year","month","day","hour","minute"]},"place":{"type":"string"},"feed_targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"child_attachments":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"multi_share_end_card":{"type":"boolean"},"multi_share_optimized":{"type":"boolean"},"unpublished_content_type":{"type":"string"},"no_story":{"type":"boolean"},"crossposted_video_id":{"type":"string"},"spherical":{"type":"boolean"}},"additionalProperties":false},"scheduled_at":{"type":"string"},"display_timezone":{"type":"string","minLength":1,"maxLength":80},"local_scheduled_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,6})?)?$"},{"type":"null"}]},"schedule_timezone":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}]},"schedule_dst_disambiguation":{"anyOf":[{"type":"string","enum":["exact","earlier","later"]},{"type":"null"}]},"schedule_intent_state":{"type":"string","enum":["verified","legacy_unverified"]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","publishing","published","failed","expired","needs_reschedule","cancelled","deleted"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"automatic_retry_enabled":{"type":"boolean"},"delete_requested_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider_post_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"permalink":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"batch_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"source_ref":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["id","workspace_id","social_account_id","platform","destination","caption","hashtags","media","publish_options","scheduled_at","display_timezone","expires_at","status","version","automatic_retry_enabled","delete_requested_at","published_at","deleted_at","provider_post_id","permalink","created_at","updated_at","project_id","batch_id","source_ref"],"additionalProperties":false},"deduped":{"type":"boolean"}},"required":["post","deduped"],"additionalProperties":false},{"type":"null"}]},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"resume_arguments":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["stage","import_id","scheduled_post"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/studio-api/scheduled-posts/create-image-url"],"slug":"post-image-url"},{"name":"sosoapi_upload_asset","title":"Upload a local image or video","description":"Upload a local image or video file into a Workspace asset library and register it as an asset. Only real PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG files up to 500 MiB from the working directory, temp folder, Pictures/Movies/Videos or SOSOAPI_UPLOAD_ROOTS are accepted; dot-files and dot-folders are refused. Returns the asset id and URL for Scheduled Post media.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"core":true,"transports":["stdio"],"inputSchema":{"type":"object","properties":{"workspace_id":{"type":"string","format":"uuid"},"file_path":{"type":"string","minLength":1},"idempotency_key":{"type":"string","minLength":8,"maxLength":160},"content_type":{"type":"string","minLength":1},"title":{"type":"string","maxLength":200},"description":{"type":"string","maxLength":2000},"tags":{"maxItems":50,"type":"array","items":{"type":"string","maxLength":64}},"metadata":{"type":"object","additionalProperties":{}}},"required":["workspace_id","file_path","idempotency_key"]},"outputSchema":{"type":"object","properties":{"asset":{"type":"object","properties":{"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"string"}]},"workspace_id":{"type":"string","format":"uuid"},"user_id":{"type":"string","format":"uuid"},"asset_type":{"type":"string","enum":["text","image","video","audio"]},"asset_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"preview_url":{"description":"Workspace-authorized temporary read URL. Refresh through Asset read/list after preview_expires_at; keep asset_url as persisted media identity.","anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"preview_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"created_at":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","workspace_id","user_id","asset_type","asset_url","title","description","tags","metadata","created_at"],"additionalProperties":false},"deduped":{"type":"boolean"}},"required":["asset","deduped"],"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false},"routes":["/assets-api/upload/sign","/assets-api/upload/complete"],"slug":"upload-asset"}]