{ "openapi": "3.1.0", "info": { "title": "Cuekoo Tools API", "version": "1.0.0", "description": "Cuekoo exposes 26 Tools. Each one is a single HTTP call and a single MCP tool with the same name and arguments. Every call is authenticated with an organization API key and billed in credits; free Tools are marked with x-credits.free." }, "servers": [ { "url": "https://api.cuekoo.com", "description": "Production" } ], "tags": [ { "name": "Account \u0026 credits", "description": "Credit balance and queued jobs." }, { "name": "Connected channels", "description": "The social accounts this workspace has connected." }, { "name": "Creators \u0026 posts", "description": "Look up a creator, their posts and similar creators." }, { "name": "Discovery", "description": "Find standout and viral posts, and the patterns behind them." }, { "name": "Analysis", "description": "AI analysis of a single post." }, { "name": "Competitors", "description": "The competitors this workspace tracks." }, { "name": "Ideas", "description": "Saved content ideas." }, { "name": "Inspo", "description": "Posts saved for inspiration." }, { "name": "Publishing", "description": "Uploaded media and posts." } ], "paths": { "/openapi/v1/tools/analyze_post": { "post": { "tags": [ "Analysis" ], "summary": "Analyze a video post", "description": "Use to examine a TikTok, Instagram or YouTube video post's hook, timeline, transcript and reusable structure. Cost: 10 + 4 per started 30 seconds (14–34 credits). Videos up to 180 seconds. Results may contain unknowns where evidence is insufficient. This Tool is queued: the call returns a job id, and get_job returns the result.", "operationId": "analyze_post", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnalyzePostInput" } } } }, "responses": { "200": { "description": "The call is queued. Poll get_job with the returned job_id for the result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnalyzePostOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_analyze_post", "x-credits": { "free": false, "max": 34, "typical": 34, "fixed": false }, "x-async": true } }, "/openapi/v1/tools/archive_idea": { "post": { "tags": [ "Ideas" ], "summary": "Archive an idea", "description": "Archive an idea the user no longer wants on the board, or restore an archived one with restore true. Archiving keeps everything; an archived idea still counts toward the plan's idea limit.", "operationId": "archive_idea", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveIdeaInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveIdeaOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_archive_idea", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/connect_my_account": { "post": { "tags": [ "Connected channels" ], "summary": "Connect my account", "description": "Use when someone wants to connect their own TikTok, Instagram or YouTube account. Returns a browser link; the person must sign in to complete the connection.", "operationId": "connect_my_account", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectMyAccountInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectMyAccountOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_connect_my_account", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/get_balance": { "post": { "tags": [ "Account \u0026 credits" ], "summary": "Get credit balance", "description": "Shows the current plan, connected account and creator limits, available credits, held credits and credits used this period.", "operationId": "get_balance", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetBalanceInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetBalanceOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_get_balance", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/get_idea": { "post": { "tags": [ "Ideas" ], "summary": "Get an idea", "description": "Read an idea's full content by its id: the Markdown body, properties, the posts embedded in the body, uploaded attachments and the posts made from it. Read it before drafting a post from it or updating it.", "operationId": "get_idea", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetIdeaInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetIdeaOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_get_idea", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/get_job": { "post": { "tags": [ "Account \u0026 credits" ], "summary": "Get job", "description": "Shows the status and result of a queued tool call.", "operationId": "get_job", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetJobInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetJobOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_get_job", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/get_my_account_insights": { "post": { "tags": [ "Connected channels" ], "summary": "Get my account insights", "description": "Use to compare a connected account's performance with the previous period and review daily trends. Reads stored analytics only.", "operationId": "get_my_account_insights", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetMyAccountInsightsInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetMyAccountInsightsOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_get_my_account_insights", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/get_post": { "post": { "tags": [ "Creators \u0026 posts" ], "summary": "Get post", "description": "Use to inspect one post's metrics, its outlier score (views / its creator's usual views; 2 or more is an outlier), virality score and engagement rate. API and MCP lookups of third-party posts cost 2 credits, even on a cache hit. Page reads of fresh saved metrics are free; a live refresh costs 2.", "operationId": "get_post", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPostInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPostOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_get_post", "x-credits": { "free": false, "max": 2, "typical": 2, "fixed": true } } }, "/openapi/v1/tools/list_competitors": { "post": { "tags": [ "Competitors" ], "summary": "List competitors", "description": "Use to see the workspace's competitor list: each competitor's platform, handle, display name, bio, avatar, check cadence, state and last check, plus what the list costs in credits per month and how many credits are left. Reads saved workspace data only.", "operationId": "list_competitors", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListCompetitorsInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListCompetitorsOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_list_competitors", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/list_ideas": { "post": { "tags": [ "Ideas" ], "summary": "List ideas", "description": "List the workspace's ideas, most recently updated first, optionally by group, tag, platform, assignee or due date, or the archived ones. Items carry an excerpt; use get_idea for the full body.", "operationId": "list_ideas", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListIdeasInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListIdeasOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_list_ideas", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/list_inspo": { "post": { "tags": [ "Inspo" ], "summary": "List Inspo", "description": "List the posts the workspace saved to Inspo, newest first, optionally one collection or the posts in none. Numbers are as of the day each post was saved.", "operationId": "list_inspo", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListInspoInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListInspoOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_list_inspo", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/list_media": { "post": { "tags": [ "Publishing" ], "summary": "List ready media", "description": "List uploaded media ready to publish. Pass next_cursor as cursor to read the next page. Media must be uploaded in Cuekoo Studio first. If the list is empty, ask the user to upload the video or photos at /publish.", "operationId": "list_media", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListMediaInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListMediaOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_list_media", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/list_my_accounts": { "post": { "tags": [ "Connected channels" ], "summary": "List my connected accounts", "description": "Lists your social accounts connected to Cuekoo in this workspace, including platform, handle, followers, connection status and sync status. Call this first to find the account IDs other tools need.", "operationId": "list_my_accounts", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListMyAccountsInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListMyAccountsOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_list_my_accounts", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/list_my_posts": { "post": { "tags": [ "Connected channels" ], "summary": "List my posts", "description": "Use to review a connected account's published posts, engagement and performance against its own baseline. Reads stored data only.", "operationId": "list_my_posts", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListMyPostsInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListMyPostsOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_list_my_posts", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/list_outliers": { "post": { "tags": [ "Discovery" ], "summary": "Find standout posts", "description": "Use to find posts that beat their own creator's usual views at least twice. The outlier score is views / the creator's baseline, the median views of their latest 10 unpinned posts at least a day old. Searches up to 10 named creators when creators is given, the creators this workspace tracks with scope competitors, and otherwise every post Cuekoo has stored, there only from creators whose usual post reaches 1,000 views. Named or tracked creators Cuekoo has not stored, or without enough posts for a baseline, come back in skipped. Returns 10 posts per page with a next_cursor. API, MCP and Koo cost 1 credit per non-empty page; empty pages and direct web browsing are free.", "operationId": "list_outliers", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListOutliersInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListOutliersOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_list_outliers", "x-credits": { "free": false, "max": 1, "typical": 1, "fixed": false } } }, "/openapi/v1/tools/list_patterns": { "post": { "tags": [ "Discovery" ], "summary": "Find recurring post patterns", "description": "Use to find recurring hooks and formats among standout posts by creators tracked in this workspace. Returns evidence posts and ways to adapt each pattern. Requires at least three saved standout posts. This Tool is queued: the call returns a job id, and get_job returns the result.", "operationId": "list_patterns", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListPatternsInput" } } } }, "responses": { "200": { "description": "The call is queued. Poll get_job with the returned job_id for the result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListPatternsOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_list_patterns", "x-credits": { "free": false, "max": 20, "typical": 20, "fixed": true }, "x-async": true } }, "/openapi/v1/tools/list_posts": { "post": { "tags": [ "Creators \u0026 posts" ], "summary": "List creator posts", "description": "Use to see one creator's recent posts with each post's outlier score (views / the creator's usual views; 2 or more is an outlier), virality score and engagement rate. Each successful request retrieves the latest posts for 5 credits, including repeated requests.", "operationId": "list_posts", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListPostsInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListPostsOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_list_posts", "x-credits": { "free": false, "max": 5, "typical": 5, "fixed": true } } }, "/openapi/v1/tools/publish_post": { "post": { "tags": [ "Publishing" ], "summary": "Create a draft or publish a post", "description": "Create one post for one connected account. Use list_my_accounts for channel_id and list_media for uploaded media IDs. A draft may reference media that is still uploading, but publishing requires all media to be ready. mode now queues publishing and usually returns pending; check results in Cuekoo Studio (there is no status Tool yet). TikTok defaults to inbox delivery; even for inbox, mode now requires the user's explicit content_preview_confirmed and express_consent_given. Never set consent fields on the user's behalf. Ask the user to confirm the privacy level and the consent statements first. Minimal options: TikTok inbox {\"delivery\":\"inbox\",\"content_preview_confirmed\":true,\"express_consent_given\":true} only after the user confirms both; Instagram {\"content_type\":\"post\"}; YouTube {\"title\":\"Video title\",\"visibility\":\"private\"}. Direct TikTok also requires an explicit privacy_level and both confirmations. Set idea_id to link the post to an idea (get_idea); when the post goes live the idea moves to its done group. Set idempotency_key to a new UUID for each new post and send the same value when retrying the same call: a retry with the same key and input returns the original post instead of publishing twice.", "operationId": "publish_post", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishPostInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishPostOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_publish_post", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/remove_inspo": { "post": { "tags": [ "Inspo" ], "summary": "Remove a saved post", "description": "Remove a post from the workspace's Inspo, which frees its slot. Ideas that embed the post keep the link.", "operationId": "remove_inspo", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemoveInspoInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemoveInspoOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_remove_inspo", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/save_idea": { "post": { "tags": [ "Ideas" ], "summary": "Save an idea", "description": "Create an idea on the workspace's Create board when the user asks to remember an idea or you developed a promising topic. The body is Markdown; a post link alone on a line shows as an embedded post. Each plan limits how many ideas a workspace keeps.", "operationId": "save_idea", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SaveIdeaInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SaveIdeaOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_save_idea", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/save_inspo": { "post": { "tags": [ "Inspo" ], "summary": "Save to Inspo", "description": "Save another creator's TikTok, Instagram or YouTube post to the workspace's Inspo with its numbers frozen as of today. A post id from Discover or list_outliers saves free from stored data; a post_url is fetched fresh and costs 2 credits, charged only when the fetch succeeds (an invalid, private or deleted post is free). A duplicate recognized before fetching is free. A short link resolved by a successful fetch can still cost 2. A workspace keeps at most 1,000 posts.", "operationId": "save_inspo", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SaveInspoInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SaveInspoOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_save_inspo", "x-credits": { "free": false, "max": 2, "typical": 2, "fixed": false } } }, "/openapi/v1/tools/search_creators": { "post": { "tags": [ "Creators \u0026 posts" ], "summary": "Search creators", "description": "Use to find creators on one platform by name, keyword or @handle, through the platform's own account search, in the platform's order (up to 20). TikTok and Instagram match names, handles and keywords, so use them to find creators by topic. YouTube matches channel names only: a topic keyword such as \"skincare\" returns nothing there, so search YouTube for a channel's name. To find accounts like a given @handle, use search_similar_creators instead. Instagram results have no follower counts, so followers cannot filter them. Each result carries the profile URL and, when known, name, avatar, short bio and follower count.", "operationId": "search_creators", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchCreatorsInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchCreatorsOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_search_creators", "x-credits": { "free": false, "max": 2, "typical": 2, "fixed": true } } }, "/openapi/v1/tools/search_similar_creators": { "post": { "tags": [ "Creators \u0026 posts" ], "summary": "Find similar creators", "description": "Use to discover creators similar to a public TikTok or Instagram account, as recommended by the platform, in recommendation order. YouTube and other platforms are not supported. Each result carries the profile URL and, when known, name, avatar, short bio and follower count; follower counts and bios are often unavailable for Instagram.", "operationId": "search_similar_creators", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchSimilarCreatorsInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchSimilarCreatorsOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_search_similar_creators", "x-credits": { "free": false, "max": 2, "typical": 2, "fixed": true } } }, "/openapi/v1/tools/update_competitors": { "post": { "tags": [ "Competitors" ], "summary": "Update competitors", "description": "Use to add creators to or remove them from the workspace's competitor list in one call. Add by profile link or platform and handle; new competitors are on the list as soon as the call returns, get their first check within minutes, and are checked daily after that. Each successful check costs credits: 10 for the first, then 2 per check, and nothing for creators the workspace already tracks in Creator Tracking. Removing stops its checks, so nothing more is charged for it.", "operationId": "update_competitors", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateCompetitorsInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateCompetitorsOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_update_competitors", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/update_idea": { "post": { "tags": [ "Ideas" ], "summary": "Update an idea", "description": "Change an idea's title, body, group, platforms, due date, assignee or tags. Read it with get_idea first and pass its version; if someone changed it since, the call fails with version_conflict and the current idea, so re-read and apply the change again. Only the user's confirmed changes should be written.", "operationId": "update_idea", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateIdeaInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateIdeaOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_update_idea", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } }, "/openapi/v1/tools/update_inspo": { "post": { "tags": [ "Inspo" ], "summary": "Move a saved post", "description": "Move a post saved in Inspo to another collection, or out of any collection with an empty collection_id.", "operationId": "update_inspo", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateInspoInput" } } } }, "responses": { "200": { "description": "The Tool result.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateInspoOutput" } } } }, "400": { "description": "The request body or an argument is invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "401": { "description": "The Authorization header is missing or the key is not active.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "402": { "description": "The plan does not include the feature, a quota is used up, or the credit balance is too low.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "403": { "description": "The API key lacks the scope the Tool needs.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "404": { "description": "The Tool, or the resource its arguments name, does not exist in this workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "409": { "description": "This Idempotency-Key was already used for a different call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "410": { "description": "The queued job's result is no longer available.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } }, "502": { "description": "An upstream provider failed; retry later.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolError" } } } } }, "x-mcp-tool": "cuekoo_update_inspo", "x-credits": { "free": true, "max": 0, "typical": 0, "fixed": true } } } }, "components": { "schemas": { "AnalyzePostInput": { "additionalProperties": false, "properties": { "output_language": { "description": "Language tag for the analysis text, such as en or pt-BR; default en", "type": "string" }, "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "AnalyzePostOutput": { "additionalProperties": false, "properties": { "job_id": { "type": "string" }, "status": { "type": "string" } }, "required": [ "job_id", "status" ], "type": "object" }, "ArchiveIdeaInput": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "restore": { "description": "true brings an archived idea back to the board", "type": "boolean" } }, "required": [ "id" ], "type": "object" }, "ArchiveIdeaOutput": { "additionalProperties": false, "properties": { "idea": { "additionalProperties": false, "properties": { "archived": { "type": "boolean" }, "assignee": { "additionalProperties": false, "properties": { "display_name": { "type": "string" }, "id": { "type": "string" } }, "required": [ "id", "display_name" ], "type": [ "null", "object" ] }, "body": { "description": "Markdown; media:\u003cid\u003e images and videos, a post link alone on a line is an embed", "type": "string" }, "created_at": { "type": "string" }, "due_date": { "type": [ "null", "string" ] }, "group": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "is_done": { "type": "boolean" }, "name": { "type": "string" } }, "required": [ "id", "name", "is_done" ], "type": "object" }, "id": { "type": "string" }, "platforms": { "items": { "type": "string" }, "type": [ "null", "array" ] }, "post_count": { "type": "integer" }, "tags": { "items": { "additionalProperties": false, "properties": { "color": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name", "color" ], "type": "object" }, "type": [ "null", "array" ] }, "title": { "type": "string" }, "updated_at": { "type": "string" }, "version": { "description": "Pass this version to update_idea", "type": "integer" } }, "required": [ "id", "title", "body", "group", "platforms", "due_date", "assignee", "tags", "post_count", "version", "archived", "created_at", "updated_at" ], "type": "object" } }, "required": [ "idea" ], "type": "object" }, "ConnectMyAccountInput": { "additionalProperties": false, "properties": { "platform": { "description": "Platform to connect: tiktok, instagram or youtube", "type": "string" } }, "required": [ "platform" ], "type": "object" }, "ConnectMyAccountOutput": { "additionalProperties": false, "properties": { "connect_url": { "type": "string" }, "instructions": { "type": "string" } }, "required": [ "connect_url", "instructions" ], "type": "object" }, "GetBalanceInput": { "additionalProperties": false, "type": "object" }, "GetBalanceOutput": { "additionalProperties": false, "properties": { "available": { "type": "integer" }, "held": { "type": "integer" }, "plan": { "additionalProperties": false, "properties": { "channels_limit": { "type": [ "null", "integer" ] }, "channels_used": { "type": "integer" }, "creators_limit": { "type": [ "null", "integer" ] }, "creators_used": { "type": "integer" }, "name": { "type": "string" }, "period_end": { "type": [ "null", "string" ] }, "period_start": { "type": [ "null", "string" ] } }, "required": [ "name", "channels_used", "channels_limit", "creators_used", "creators_limit" ], "type": "object" }, "used_this_period": { "type": "integer" } }, "required": [ "plan", "available", "held", "used_this_period" ], "type": "object" }, "GetIdeaInput": { "additionalProperties": false, "properties": { "id": { "type": "string" } }, "required": [ "id" ], "type": "object" }, "GetIdeaOutput": { "additionalProperties": false, "properties": { "attachments": { "items": { "additionalProperties": false, "properties": { "kind": { "type": "string" }, "media_id": { "type": "string" }, "status": { "type": "string" }, "url": { "type": "string" } }, "required": [ "media_id", "kind", "status", "url" ], "type": "object" }, "type": [ "null", "array" ] }, "embeds": { "items": { "additionalProperties": false, "properties": { "platform": { "type": "string" }, "post_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "url", "platform", "post_id" ], "type": "object" }, "type": [ "null", "array" ] }, "idea": { "additionalProperties": false, "properties": { "archived": { "type": "boolean" }, "assignee": { "additionalProperties": false, "properties": { "display_name": { "type": "string" }, "id": { "type": "string" } }, "required": [ "id", "display_name" ], "type": [ "null", "object" ] }, "body": { "description": "Markdown; media:\u003cid\u003e images and videos, a post link alone on a line is an embed", "type": "string" }, "created_at": { "type": "string" }, "due_date": { "type": [ "null", "string" ] }, "group": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "is_done": { "type": "boolean" }, "name": { "type": "string" } }, "required": [ "id", "name", "is_done" ], "type": "object" }, "id": { "type": "string" }, "platforms": { "items": { "type": "string" }, "type": [ "null", "array" ] }, "post_count": { "type": "integer" }, "tags": { "items": { "additionalProperties": false, "properties": { "color": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name", "color" ], "type": "object" }, "type": [ "null", "array" ] }, "title": { "type": "string" }, "updated_at": { "type": "string" }, "version": { "description": "Pass this version to update_idea", "type": "integer" } }, "required": [ "id", "title", "body", "group", "platforms", "due_date", "assignee", "tags", "post_count", "version", "archived", "created_at", "updated_at" ], "type": "object" }, "posts": { "items": { "additionalProperties": false, "properties": { "caption": { "description": "The first 200 characters", "type": "string" }, "channel_username": { "type": "string" }, "id": { "type": "string" }, "outcome": { "type": "string" }, "platform": { "type": "string" }, "scheduled_at": { "type": [ "null", "string" ] }, "state": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "platform", "channel_username", "state", "outcome", "caption", "scheduled_at", "url" ], "type": "object" }, "type": [ "null", "array" ] } }, "required": [ "idea", "embeds", "attachments", "posts" ], "type": "object" }, "GetJobInput": { "additionalProperties": false, "properties": { "job_id": { "format": "uuid", "type": "string" } }, "required": [ "job_id" ], "type": "object" }, "GetJobOutput": { "additionalProperties": false, "properties": { "created_at": { "type": "string" }, "error": { "type": "string" }, "error_code": { "type": "string" }, "finished_at": { "type": [ "null", "string" ] }, "id": { "format": "uuid", "type": "string" }, "result": { "description": "The Tool's result: the JSON object its own output schema describes." }, "status": { "type": "string" }, "tool": { "type": "string" } }, "required": [ "id", "tool", "status", "created_at" ], "type": "object" }, "GetMyAccountInsightsInput": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "from": { "type": "string" }, "time_zone": { "type": "string" }, "to": { "type": "string" } }, "required": [ "channel_id" ], "type": "object" }, "GetMyAccountInsightsOutput": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "current": { "additionalProperties": false, "properties": { "follower_change": { "type": [ "null", "integer" ] }, "followers": { "type": [ "null", "integer" ] }, "metrics": { "additionalProperties": false, "properties": { "comments": { "type": [ "null", "integer" ] }, "likes": { "type": [ "null", "integer" ] }, "saves": { "type": [ "null", "integer" ] }, "shares": { "type": [ "null", "integer" ] }, "views": { "type": [ "null", "integer" ] } }, "required": [ "views", "likes", "comments", "shares", "saves" ], "type": "object" }, "posts": { "type": "integer" } }, "required": [ "followers", "follower_change", "posts", "metrics" ], "type": "object" }, "daily": { "items": { "additionalProperties": false, "properties": { "date": { "type": "string" }, "engagement_rate": { "type": [ "null", "number" ] }, "engagements": { "type": [ "null", "integer" ] }, "followers": { "type": [ "null", "integer" ] }, "posts": { "type": "integer" }, "views": { "type": [ "null", "integer" ] } }, "required": [ "date", "followers", "posts", "views", "engagements", "engagement_rate" ], "type": "object" }, "type": [ "null", "array" ] }, "from": { "type": "string" }, "last_synced_at": { "type": [ "null", "string" ] }, "previous": { "additionalProperties": false, "properties": { "follower_change": { "type": [ "null", "integer" ] }, "followers": { "type": [ "null", "integer" ] }, "metrics": { "additionalProperties": false, "properties": { "comments": { "type": [ "null", "integer" ] }, "likes": { "type": [ "null", "integer" ] }, "saves": { "type": [ "null", "integer" ] }, "shares": { "type": [ "null", "integer" ] }, "views": { "type": [ "null", "integer" ] } }, "required": [ "views", "likes", "comments", "shares", "saves" ], "type": "object" }, "posts": { "type": "integer" } }, "required": [ "followers", "follower_change", "posts", "metrics" ], "type": "object" }, "sync_status": { "type": "string" }, "time_zone": { "type": "string" }, "to": { "type": "string" } }, "required": [ "channel_id", "from", "to", "time_zone", "current", "previous", "daily", "sync_status", "last_synced_at" ], "type": "object" }, "GetPostInput": { "additionalProperties": false, "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "GetPostOutput": { "additionalProperties": false, "properties": { "charged": { "type": "boolean" }, "engagement_rate": { "type": [ "null", "number" ] }, "is_outlier": { "type": "boolean" }, "outlier_score": { "type": [ "null", "number" ] }, "post": { "additionalProperties": false, "properties": { "caption": { "type": "string" }, "format": { "type": "string" }, "metrics": { "additionalProperties": false, "properties": { "comments": { "type": [ "null", "integer" ] }, "likes": { "type": [ "null", "integer" ] }, "saves": { "type": [ "null", "integer" ] }, "shares": { "type": [ "null", "integer" ] }, "views": { "type": [ "null", "integer" ] } }, "required": [ "views", "likes", "comments", "shares", "saves" ], "type": "object" }, "observed_at": { "type": "string" }, "platform": { "type": "string" }, "post_id": { "type": "string" }, "published_at": { "type": "string" }, "url": { "type": "string" } }, "required": [ "platform", "post_id", "url", "caption", "format", "published_at", "metrics", "observed_at" ], "type": "object" }, "virality_score": { "type": [ "null", "number" ] } }, "required": [ "post", "outlier_score", "virality_score", "engagement_rate", "is_outlier", "charged" ], "type": "object" }, "ListCompetitorsInput": { "additionalProperties": false, "properties": { "platform": { "type": "string" } }, "type": "object" }, "ListCompetitorsOutput": { "additionalProperties": false, "properties": { "credits": { "additionalProperties": false, "properties": { "first_check": { "type": "integer" }, "monthly_estimate": { "type": "integer" }, "per_check": { "type": "integer" }, "remaining": { "type": "integer" } }, "required": [ "first_check", "per_check", "remaining", "monthly_estimate" ], "type": "object" }, "items": { "items": { "additionalProperties": false, "properties": { "added_at": { "type": "string" }, "avatar_url": { "type": "string" }, "billed": { "type": "boolean" }, "bio": { "type": "string" }, "cadence": { "type": "string" }, "display_name": { "type": "string" }, "followers": { "type": [ "null", "integer" ] }, "handle": { "type": "string" }, "id": { "type": "string" }, "last_checked_at": { "type": [ "null", "string" ] }, "platform": { "type": "string" }, "state": { "type": "string" } }, "required": [ "id", "platform", "handle", "followers", "cadence", "state", "billed", "last_checked_at", "added_at" ], "type": "object" }, "type": [ "null", "array" ] }, "max_competitors": { "type": "integer" } }, "required": [ "items", "credits", "max_competitors" ], "type": "object" }, "ListIdeasInput": { "additionalProperties": false, "properties": { "archived": { "description": "List archived ideas instead of the board", "type": "boolean" }, "assignee_user_id": { "type": "string" }, "cursor": { "type": "string" }, "due_from": { "description": "YYYY-MM-DD, inclusive", "type": "string" }, "due_to": { "description": "YYYY-MM-DD, inclusive", "type": "string" }, "group": { "description": "Board group name", "type": "string" }, "limit": { "description": "1 to 50, default 20", "type": "integer" }, "platform": { "description": "tiktok, instagram or youtube", "type": "string" }, "tag": { "description": "Tag name", "type": "string" } }, "type": "object" }, "ListIdeasOutput": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "archived": { "type": "boolean" }, "assignee": { "additionalProperties": false, "properties": { "display_name": { "type": "string" }, "id": { "type": "string" } }, "required": [ "id", "display_name" ], "type": [ "null", "object" ] }, "due_date": { "type": [ "null", "string" ] }, "excerpt": { "type": "string" }, "group_id": { "type": "string" }, "id": { "type": "string" }, "platforms": { "items": { "type": "string" }, "type": [ "null", "array" ] }, "post_count": { "type": "integer" }, "tags": { "items": { "additionalProperties": false, "properties": { "color": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name", "color" ], "type": "object" }, "type": [ "null", "array" ] }, "title": { "type": "string" }, "updated_at": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "id", "title", "excerpt", "group_id", "platforms", "due_date", "assignee", "tags", "post_count", "version", "archived", "updated_at" ], "type": "object" }, "type": [ "null", "array" ] }, "next_cursor": { "type": "string" } }, "required": [ "items", "next_cursor" ], "type": "object" }, "ListInspoInput": { "additionalProperties": false, "properties": { "collection_id": { "description": "Only this collection", "type": "string" }, "cursor": { "type": "string" }, "limit": { "description": "1 to 50, default 20", "type": "integer" }, "uncollected": { "description": "Only posts in no collection", "type": "boolean" } }, "type": "object" }, "ListInspoOutput": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "caption": { "type": "string" }, "collection_id": { "type": [ "null", "string" ] }, "comments": { "type": [ "null", "integer" ] }, "cover_url": { "type": "string" }, "creator_handle": { "type": "string" }, "id": { "type": "string" }, "likes": { "type": [ "null", "integer" ] }, "outlier_score": { "type": [ "null", "number" ] }, "platform": { "type": "string" }, "pool_post_id": { "type": [ "null", "string" ] }, "post_id": { "type": "string" }, "published_at": { "type": [ "null", "string" ] }, "saved_at": { "type": "string" }, "source": { "type": "string" }, "url": { "type": "string" }, "views": { "description": "At save; never refreshed", "type": [ "null", "integer" ] } }, "required": [ "id", "platform", "post_id", "pool_post_id", "url", "creator_handle", "caption", "cover_url", "published_at", "views", "likes", "comments", "outlier_score", "collection_id", "source", "saved_at" ], "type": "object" }, "type": [ "null", "array" ] }, "next_cursor": { "type": "string" } }, "required": [ "items", "next_cursor" ], "type": "object" }, "ListMediaInput": { "additionalProperties": false, "properties": { "cursor": { "type": "string" }, "kind": { "type": "string" }, "limit": { "type": "integer" } }, "type": "object" }, "ListMediaOutput": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "created_at": { "type": "string" }, "duration_seconds": { "type": [ "null", "number" ] }, "height": { "type": [ "null", "integer" ] }, "kind": { "type": "string" }, "media_id": { "format": "uuid", "type": "string" }, "mime": { "type": "string" }, "size_bytes": { "type": "integer" }, "width": { "type": [ "null", "integer" ] } }, "required": [ "media_id", "kind", "mime", "size_bytes", "width", "height", "duration_seconds", "created_at" ], "type": "object" }, "type": [ "null", "array" ] }, "next_cursor": { "type": "string" } }, "required": [ "items", "next_cursor" ], "type": "object" }, "ListMyAccountsInput": { "additionalProperties": false, "properties": { "platform": { "description": "Only return accounts on this platform: tiktok, instagram or youtube", "type": "string" } }, "type": "object" }, "ListMyAccountsOutput": { "additionalProperties": false, "properties": { "channels": { "items": { "additionalProperties": false, "properties": { "auth_status": { "type": "string" }, "capabilities": { "items": { "type": "string" }, "type": [ "null", "array" ] }, "connected_at": { "type": "string" }, "display_name": { "type": "string" }, "followers": { "type": "integer" }, "following": { "type": "integer" }, "handle": { "type": "string" }, "id": { "type": "string" }, "last_synced_at": { "type": [ "null", "string" ] }, "platform": { "type": "string" }, "post_count": { "type": "integer" }, "profile_url": { "type": [ "null", "string" ] }, "provider": { "type": "string" }, "sync_status": { "type": "string" }, "username": { "type": [ "null", "string" ] }, "verified": { "type": "boolean" } }, "required": [ "id", "platform", "provider", "handle", "username", "display_name", "profile_url", "verified", "followers", "following", "post_count", "auth_status", "capabilities", "sync_status", "last_synced_at", "connected_at" ], "type": "object" }, "type": [ "null", "array" ] } }, "required": [ "channels" ], "type": "object" }, "ListMyPostsInput": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "cursor": { "type": "string" }, "from": { "type": "string" }, "limit": { "type": "integer" }, "sort": { "type": "string" }, "to": { "type": "string" } }, "required": [ "channel_id" ], "type": "object" }, "ListMyPostsOutput": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "caption": { "type": "string" }, "engagement_rate": { "type": [ "null", "number" ] }, "format": { "type": "string" }, "metrics": { "additionalProperties": false, "properties": { "comments": { "type": [ "null", "integer" ] }, "likes": { "type": [ "null", "integer" ] }, "saves": { "type": [ "null", "integer" ] }, "shares": { "type": [ "null", "integer" ] }, "views": { "type": [ "null", "integer" ] } }, "required": [ "views", "likes", "comments", "shares", "saves" ], "type": "object" }, "multiple": { "type": [ "null", "number" ] }, "post_id": { "type": "string" }, "published_at": { "type": "string" }, "url": { "type": "string" } }, "required": [ "post_id", "url", "caption", "format", "published_at", "metrics", "multiple", "engagement_rate" ], "type": "object" }, "type": [ "null", "array" ] }, "next_cursor": { "type": "string" } }, "required": [ "items", "next_cursor" ], "type": "object" }, "ListOutliersInput": { "additionalProperties": false, "properties": { "content_types": { "description": "Only these formats: video, slideshow (photo posts and carousels)", "items": { "type": "string" }, "type": [ "null", "array" ] }, "creators": { "description": "Up to 10 creators to search; naming creators without a scope searches them; not allowed with scope all or competitors", "items": { "additionalProperties": false, "properties": { "handle": { "description": "The creator's handle, with or without the leading @", "type": "string" }, "platform": { "description": "The creator's platform: tiktok, instagram or youtube", "type": "string" } }, "required": [ "platform", "handle" ], "type": "object" }, "type": [ "null", "array" ] }, "cursor": { "description": "next_cursor from the previous page, to continue the same search", "type": "string" }, "hashtags": { "description": "Up to 10 hashtags, with or without #. A post carrying any of them matches", "items": { "type": "string" }, "type": [ "null", "array" ] }, "keyword": { "description": "Only posts whose caption contains this text or that carry it as a hashtag; up to 100 characters", "type": "string" }, "languages": { "description": "ISO 639-1 language codes; posts in other languages are left out, posts with no detectable language are kept. Default: [\"en\"], or every language when creators are named; pass [] for every language", "items": { "type": "string" }, "type": [ "null", "array" ] }, "limit": { "description": "Posts per page, 1 to 10. Default: 10", "type": [ "null", "integer" ] }, "max_followers": { "description": "Only creators with at most this many followers", "type": [ "null", "integer" ] }, "max_outlier_score": { "description": "Only posts with at most this outlier score, to leave out freak multiples on tiny baselines", "type": [ "null", "number" ] }, "max_views": { "description": "Only posts with at most this many views", "type": [ "null", "integer" ] }, "min_followers": { "description": "Only creators with at least this many followers", "type": [ "null", "integer" ] }, "min_outlier_score": { "description": "Only posts with at least this outlier score, views / the creator's usual views; at least 2. Default: 2, the outlier threshold", "type": [ "null", "number" ] }, "min_views": { "description": "Only posts with at least this many views", "type": [ "null", "integer" ] }, "niches": { "description": "Up to 5 niche slugs from Cuekoo's taxonomy, level 1 or level 2 (for example beauty or skincare). A post matches when it is labeled with any of them; combined with hashtags, a post matching either is kept", "items": { "type": "string" }, "type": [ "null", "array" ] }, "one_per_creator": { "description": "Return only each creator's best post under the sort, so one prolific creator does not fill the page", "type": "boolean" }, "platforms": { "description": "Only these platforms: tiktok, instagram, youtube. Default: all three", "items": { "type": "string" }, "type": [ "null", "array" ] }, "published_within_days": { "description": "Only posts published in the last 7, 30 or 90 days. Default: 30", "type": "integer" }, "regions": { "description": "ISO 3166-1 alpha-2 region codes of the creator's account registration (not the audience). Default: no region filter", "items": { "type": "string" }, "type": [ "null", "array" ] }, "scope": { "description": "Whose posts to search: all (every post Cuekoo has stored), competitors (the creators this workspace tracks) or creators (the creators listed in creators)", "type": "string" }, "sort": { "description": "Order, highest first: outlier_score, views or published_at. Default: outlier_score", "type": "string" } }, "type": "object" }, "ListOutliersOutput": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "ai_labeled": { "type": "boolean" }, "baseline": { "additionalProperties": false, "properties": { "captured_at": { "type": "string" }, "samples": { "type": "integer" }, "views": { "type": "integer" } }, "required": [ "views", "samples", "captured_at" ], "type": [ "null", "object" ] }, "creator": { "additionalProperties": false, "properties": { "display_name": { "type": "string" }, "followers": { "type": "integer" }, "handle": { "type": "string" }, "language": { "type": [ "null", "string" ] }, "platform": { "type": "string" }, "region": { "type": [ "null", "string" ] } }, "required": [ "platform", "handle", "display_name", "followers", "region", "language" ], "type": "object" }, "engagement_rate": { "type": [ "null", "number" ] }, "language": { "type": [ "null", "string" ] }, "metrics": { "additionalProperties": false, "properties": { "comments": { "type": [ "null", "integer" ] }, "latest_captured_at": { "type": [ "null", "string" ] }, "likes": { "type": [ "null", "integer" ] }, "saves": { "type": [ "null", "integer" ] }, "shares": { "type": [ "null", "integer" ] }, "views": { "type": [ "null", "integer" ] } }, "required": [ "views", "likes", "comments", "shares", "saves", "latest_captured_at" ], "type": "object" }, "niche": { "additionalProperties": false, "properties": { "l1": { "type": "string" }, "l2": { "items": { "type": "string" }, "type": [ "null", "array" ] } }, "required": [ "l1", "l2" ], "type": [ "null", "object" ] }, "outlier_score": { "type": [ "null", "number" ] }, "post": { "additionalProperties": false, "properties": { "caption": { "type": "string" }, "content_type": { "type": "string" }, "duration_seconds": { "type": [ "null", "integer" ] }, "id": { "format": "uuid", "type": "string" }, "platform": { "type": "string" }, "platform_post_id": { "type": "string" }, "published_at": { "type": "string" }, "thumbnail_url": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "platform", "platform_post_id", "url", "thumbnail_url", "caption", "content_type", "duration_seconds", "published_at" ], "type": "object" }, "region": { "type": [ "null", "string" ] }, "virality_score": { "type": [ "null", "number" ] } }, "required": [ "post", "metrics", "creator", "outlier_score", "virality_score", "engagement_rate", "niche", "language", "region", "ai_labeled", "baseline" ], "type": "object" }, "type": [ "null", "array" ] }, "next_cursor": { "type": "string" }, "skipped": { "items": { "additionalProperties": false, "properties": { "handle": { "type": "string" }, "platform": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "platform", "handle", "reason" ], "type": "object" }, "type": [ "null", "array" ] } }, "required": [ "items", "skipped" ], "type": "object" }, "ListPatternsInput": { "additionalProperties": false, "properties": { "days": { "description": "Look back this many days; default 14", "type": "integer" }, "max_posts": { "description": "Maximum posts to analyze, default 20, up to 30", "type": "integer" }, "output_language": { "description": "Language tag for the analysis, such as en or pt-BR; default en", "type": "string" }, "platform": { "description": "Optional platform: tiktok, instagram or youtube", "type": "string" } }, "type": "object" }, "ListPatternsOutput": { "additionalProperties": false, "properties": { "job_id": { "type": "string" }, "status": { "type": "string" } }, "required": [ "job_id", "status" ], "type": "object" }, "ListPostsInput": { "additionalProperties": false, "properties": { "account": { "type": "string" }, "days": { "type": "integer" }, "platform": { "type": "string" } }, "required": [ "account" ], "type": "object" }, "ListPostsOutput": { "additionalProperties": false, "properties": { "account": { "additionalProperties": false, "properties": { "followers": { "type": "integer" }, "handle": { "type": "string" }, "platform": { "type": "string" } }, "required": [ "platform", "handle", "followers" ], "type": "object" }, "charged": { "type": "boolean" }, "items": { "items": { "additionalProperties": false, "properties": { "engagement_rate": { "type": [ "null", "number" ] }, "is_outlier": { "type": "boolean" }, "outlier_score": { "type": [ "null", "number" ] }, "post": { "additionalProperties": false, "properties": { "caption": { "type": "string" }, "format": { "type": "string" }, "metrics": { "additionalProperties": false, "properties": { "comments": { "type": [ "null", "integer" ] }, "likes": { "type": [ "null", "integer" ] }, "saves": { "type": [ "null", "integer" ] }, "shares": { "type": [ "null", "integer" ] }, "views": { "type": [ "null", "integer" ] } }, "required": [ "views", "likes", "comments", "shares", "saves" ], "type": "object" }, "observed_at": { "type": "string" }, "platform": { "type": "string" }, "post_id": { "type": "string" }, "published_at": { "type": "string" }, "url": { "type": "string" } }, "required": [ "platform", "post_id", "url", "caption", "format", "published_at", "metrics", "observed_at" ], "type": "object" }, "virality_score": { "type": [ "null", "number" ] } }, "required": [ "post", "outlier_score", "virality_score", "engagement_rate", "is_outlier" ], "type": "object" }, "type": [ "null", "array" ] } }, "required": [ "account", "items", "charged" ], "type": "object" }, "PublishPostInput": { "additionalProperties": false, "properties": { "caption": { "type": "string" }, "channel_id": { "type": "string" }, "hashtags": { "items": { "type": "string" }, "type": [ "null", "array" ] }, "idea_id": { "type": "string" }, "idempotency_key": { "type": "string" }, "media_ids": { "items": { "type": "string" }, "type": [ "null", "array" ] }, "mode": { "type": "string" }, "options": { "description": "The Tool's result: the JSON object its own output schema describes." } }, "required": [ "channel_id", "mode", "caption", "media_ids" ], "type": "object" }, "PublishPostOutput": { "additionalProperties": false, "properties": { "channel_id": { "type": "string" }, "delivery": { "type": "string" }, "group_id": { "type": "string" }, "post_id": { "type": "string" }, "state": { "type": "string" } }, "required": [ "post_id", "group_id", "state", "channel_id", "delivery" ], "type": "object" }, "RemoveInspoInput": { "additionalProperties": false, "properties": { "id": { "type": "string" } }, "required": [ "id" ], "type": "object" }, "RemoveInspoOutput": { "additionalProperties": false, "properties": { "removed": { "type": "boolean" } }, "required": [ "removed" ], "type": "object" }, "SaveIdeaInput": { "additionalProperties": false, "properties": { "assignee_user_id": { "type": "string" }, "body": { "description": "Markdown: hook, script, shot list; put a post link alone on a line to embed it", "type": "string" }, "due_date": { "description": "YYYY-MM-DD", "type": "string" }, "group": { "description": "Board group name, such as Planned; defaults to the first group", "type": "string" }, "platforms": { "description": "Target platforms: tiktok, instagram, youtube", "items": { "type": "string" }, "type": [ "null", "array" ] }, "tags": { "description": "Tag names; a missing tag is created", "items": { "type": "string" }, "type": [ "null", "array" ] }, "title": { "description": "At most 200 characters", "type": "string" } }, "type": "object" }, "SaveIdeaOutput": { "additionalProperties": false, "properties": { "idea": { "additionalProperties": false, "properties": { "archived": { "type": "boolean" }, "assignee": { "additionalProperties": false, "properties": { "display_name": { "type": "string" }, "id": { "type": "string" } }, "required": [ "id", "display_name" ], "type": [ "null", "object" ] }, "body": { "description": "Markdown; media:\u003cid\u003e images and videos, a post link alone on a line is an embed", "type": "string" }, "created_at": { "type": "string" }, "due_date": { "type": [ "null", "string" ] }, "group": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "is_done": { "type": "boolean" }, "name": { "type": "string" } }, "required": [ "id", "name", "is_done" ], "type": "object" }, "id": { "type": "string" }, "platforms": { "items": { "type": "string" }, "type": [ "null", "array" ] }, "post_count": { "type": "integer" }, "tags": { "items": { "additionalProperties": false, "properties": { "color": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name", "color" ], "type": "object" }, "type": [ "null", "array" ] }, "title": { "type": "string" }, "updated_at": { "type": "string" }, "version": { "description": "Pass this version to update_idea", "type": "integer" } }, "required": [ "id", "title", "body", "group", "platforms", "due_date", "assignee", "tags", "post_count", "version", "archived", "created_at", "updated_at" ], "type": "object" } }, "required": [ "idea" ], "type": "object" }, "SaveInspoInput": { "additionalProperties": false, "properties": { "collection_id": { "description": "The collection to file the post in", "type": "string" }, "post_id": { "description": "A post id from Discover, list_outliers; saved free from stored data", "type": "string" }, "post_url": { "description": "A TikTok, Instagram or YouTube post link; fetched fresh, so it costs credits", "type": "string" }, "source": { "description": "Where the save started: discover, competitors, analyze, koo, link, api or idea", "enum": [ "discover", "competitors", "analyze", "koo", "link", "api", "idea" ], "type": "string" } }, "type": "object" }, "SaveInspoOutput": { "additionalProperties": false, "properties": { "credits_charged": { "type": "integer" }, "post": { "additionalProperties": false, "properties": { "caption": { "type": "string" }, "collection_id": { "type": [ "null", "string" ] }, "comments": { "type": [ "null", "integer" ] }, "cover_url": { "type": "string" }, "creator_handle": { "type": "string" }, "id": { "type": "string" }, "likes": { "type": [ "null", "integer" ] }, "outlier_score": { "type": [ "null", "number" ] }, "platform": { "type": "string" }, "pool_post_id": { "type": [ "null", "string" ] }, "post_id": { "type": "string" }, "published_at": { "type": [ "null", "string" ] }, "saved_at": { "type": "string" }, "source": { "type": "string" }, "url": { "type": "string" }, "views": { "description": "At save; never refreshed", "type": [ "null", "integer" ] } }, "required": [ "id", "platform", "post_id", "pool_post_id", "url", "creator_handle", "caption", "cover_url", "published_at", "views", "likes", "comments", "outlier_score", "collection_id", "source", "saved_at" ], "type": "object" }, "status": { "description": "saved or already_saved", "type": "string" } }, "required": [ "post", "status", "credits_charged" ], "type": "object" }, "SearchCreatorsInput": { "additionalProperties": false, "properties": { "followers": { "description": "Optional audience size: under_1k, 1k_10k, 10k_100k or over_100k. Not available on Instagram", "enum": [ "under_1k", "1k_10k", "10k_100k", "over_100k" ], "type": "string" }, "platform": { "description": "The one platform to search: tiktok, instagram or youtube", "enum": [ "tiktok", "instagram", "youtube" ], "type": "string" }, "query": { "description": "A creator's name, a keyword, or an @handle; 1 to 100 characters", "type": "string" } }, "required": [ "query", "platform" ], "type": "object" }, "SearchCreatorsOutput": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "avatar_url": { "type": "string" }, "bio": { "type": "string" }, "display_name": { "type": "string" }, "followers": { "type": [ "null", "integer" ] }, "handle": { "type": "string" }, "platform": { "type": "string" }, "profile_url": { "type": "string" }, "size_tier": { "type": "string" }, "verified": { "type": "boolean" } }, "required": [ "platform", "handle", "verified", "profile_url", "followers", "size_tier" ], "type": "object" }, "type": [ "null", "array" ] } }, "required": [ "items" ], "type": "object" }, "SearchSimilarCreatorsInput": { "additionalProperties": false, "properties": { "account": { "description": "A TikTok or Instagram handle or public profile URL", "type": "string" }, "platform": { "description": "tiktok or instagram; required for a bare handle. YouTube and other platforms are not supported", "enum": [ "tiktok", "instagram" ], "type": "string" } }, "required": [ "account" ], "type": "object" }, "SearchSimilarCreatorsOutput": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "avatar_url": { "type": "string" }, "bio": { "type": "string" }, "display_name": { "type": "string" }, "followers": { "type": [ "null", "integer" ] }, "handle": { "type": "string" }, "platform": { "type": "string" }, "profile_url": { "type": "string" }, "size_tier": { "type": "string" }, "verified": { "type": "boolean" } }, "required": [ "platform", "handle", "verified", "profile_url", "followers", "size_tier" ], "type": "object" }, "type": [ "null", "array" ] } }, "required": [ "items" ], "type": "object" }, "ToolError": { "properties": { "code": { "type": "string" }, "details": { "additionalProperties": true, "type": "object" }, "error": { "type": "string" } }, "required": [ "code", "error" ], "type": "object" }, "UpdateCompetitorsInput": { "additionalProperties": false, "properties": { "add": { "items": { "additionalProperties": false, "properties": { "account": { "type": "string" }, "platform": { "type": "string" } }, "required": [ "account" ], "type": "object" }, "type": [ "null", "array" ] }, "remove": { "items": { "type": "string" }, "type": [ "null", "array" ] } }, "required": [ "add", "remove" ], "type": "object" }, "UpdateCompetitorsOutput": { "additionalProperties": false, "properties": { "added": { "items": { "additionalProperties": false, "properties": { "handle": { "type": "string" }, "platform": { "type": "string" } }, "required": [ "platform", "handle" ], "type": "object" }, "type": [ "null", "array" ] }, "already_listed": { "items": { "additionalProperties": false, "properties": { "handle": { "type": "string" }, "platform": { "type": "string" } }, "required": [ "platform", "handle" ], "type": "object" }, "type": [ "null", "array" ] }, "credits": { "additionalProperties": false, "properties": { "first_check": { "type": "integer" }, "monthly_estimate": { "type": "integer" }, "per_check": { "type": "integer" }, "remaining": { "type": "integer" } }, "required": [ "first_check", "per_check", "remaining", "monthly_estimate" ], "type": "object" }, "removed": { "items": { "type": "string" }, "type": [ "null", "array" ] } }, "required": [ "removed", "added", "already_listed", "credits" ], "type": "object" }, "UpdateIdeaInput": { "additionalProperties": false, "properties": { "assignee_user_id": { "description": "A member's user id; an empty string unassigns", "type": [ "null", "string" ] }, "body": { "description": "The whole new Markdown body", "type": [ "null", "string" ] }, "due_date": { "description": "YYYY-MM-DD; an empty string clears it", "type": [ "null", "string" ] }, "group": { "description": "Board group name to move the idea to", "type": [ "null", "string" ] }, "id": { "type": "string" }, "platforms": { "items": { "type": "string" }, "type": [ "null", "array" ] }, "tags": { "description": "The full new list of tag names; a missing tag is created", "items": { "type": "string" }, "type": [ "null", "array" ] }, "title": { "type": [ "null", "string" ] }, "version": { "description": "The version from get_idea or the last update; a stale one is refused", "type": "integer" } }, "required": [ "id", "version" ], "type": "object" }, "UpdateIdeaOutput": { "additionalProperties": false, "properties": { "idea": { "additionalProperties": false, "properties": { "archived": { "type": "boolean" }, "assignee": { "additionalProperties": false, "properties": { "display_name": { "type": "string" }, "id": { "type": "string" } }, "required": [ "id", "display_name" ], "type": [ "null", "object" ] }, "body": { "description": "Markdown; media:\u003cid\u003e images and videos, a post link alone on a line is an embed", "type": "string" }, "created_at": { "type": "string" }, "due_date": { "type": [ "null", "string" ] }, "group": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "is_done": { "type": "boolean" }, "name": { "type": "string" } }, "required": [ "id", "name", "is_done" ], "type": "object" }, "id": { "type": "string" }, "platforms": { "items": { "type": "string" }, "type": [ "null", "array" ] }, "post_count": { "type": "integer" }, "tags": { "items": { "additionalProperties": false, "properties": { "color": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name", "color" ], "type": "object" }, "type": [ "null", "array" ] }, "title": { "type": "string" }, "updated_at": { "type": "string" }, "version": { "description": "Pass this version to update_idea", "type": "integer" } }, "required": [ "id", "title", "body", "group", "platforms", "due_date", "assignee", "tags", "post_count", "version", "archived", "created_at", "updated_at" ], "type": "object" } }, "required": [ "idea" ], "type": "object" }, "UpdateInspoInput": { "additionalProperties": false, "properties": { "collection_id": { "description": "The collection to move the post to; an empty string takes it out of any", "type": "string" }, "id": { "type": "string" } }, "required": [ "id", "collection_id" ], "type": "object" }, "UpdateInspoOutput": { "additionalProperties": false, "properties": { "post": { "additionalProperties": false, "properties": { "caption": { "type": "string" }, "collection_id": { "type": [ "null", "string" ] }, "comments": { "type": [ "null", "integer" ] }, "cover_url": { "type": "string" }, "creator_handle": { "type": "string" }, "id": { "type": "string" }, "likes": { "type": [ "null", "integer" ] }, "outlier_score": { "type": [ "null", "number" ] }, "platform": { "type": "string" }, "pool_post_id": { "type": [ "null", "string" ] }, "post_id": { "type": "string" }, "published_at": { "type": [ "null", "string" ] }, "saved_at": { "type": "string" }, "source": { "type": "string" }, "url": { "type": "string" }, "views": { "description": "At save; never refreshed", "type": [ "null", "integer" ] } }, "required": [ "id", "platform", "post_id", "pool_post_id", "url", "creator_handle", "caption", "cover_url", "published_at", "views", "likes", "comments", "outlier_score", "collection_id", "source", "saved_at" ], "type": "object" } }, "required": [ "post" ], "type": "object" } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "Organization API key: Authorization: Bearer ck_… Create one in the workspace under Settings → Developer." } } } }