{"openapi":"3.1.0","info":{"title":"Coldvio Agent API","version":"0.1.0-beta","description":"Customer-scoped API used by the Coldvio CLI and MCP server. The first customer release is not live until the controlled rollout completes.","termsOfService":"https://www.coldvio.com/terms","contact":{"name":"Coldvio support","url":"https://www.coldvio.com/developers/troubleshooting"},"license":{"name":"Proprietary","url":"https://www.coldvio.com/terms"},"x-long-description":"A narrow, customer-controlled Agent API for Coldvio voice, CRM, campaigns, content, trends, draft generation, and reviewed actions. Browser PKCE is the recommended provisioning path; tenant isolation and scopes are enforced by the API.","x-category":"sales-enablement","x-website":"https://www.coldvio.com/developers","x-version-lifecycle":"beta","x-badges":[{"name":"Customer beta","color":"#1769ff"},{"name":"Region evidence pending","color":"#6b7280"}]},"servers":[{"url":"https://api.coldvio.com","description":"Production (available after rollout)"}],"tags":[{"name":"Account","description":"Customer account summary and active voice profile."},{"name":"CRM","description":"Tenant-owned contacts, lead lists, and selected CRM updates."},{"name":"Campaigns","description":"Outreach campaigns, queued actions, and explicit approval or rejection."},{"name":"Content","description":"Customer posts and cached trend ideas."},{"name":"Generation","description":"Credit-consuming LinkedIn and email drafts that never send or publish."}],"paths":{"/v1/agent/intents":{"post":{"operationId":"issue_operation_intent","summary":"Issue a short-lived intent for one consequential operation","tags":["Account"],"security":[{"customerAgentToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["operation","resource_id","payload"],"additionalProperties":false,"properties":{"operation":{"type":"string","enum":["update_contact","approve_action","reject_action"]},"resource_id":{"type":"string","format":"uuid"},"payload":{"type":"object","additionalProperties":true}}},{"type":"object","required":["operation","payload"],"additionalProperties":false,"properties":{"operation":{"type":"string","enum":["generate_linkedin_draft","generate_email_draft"]},"resource_id":{"type":"null"},"payload":{"type":"object","additionalProperties":true}}}]}}}},"responses":{"201":{"description":"Intent issued","content":{"application/json":{"schema":{"type":"object","required":["intent","expires_at","expires_in"],"properties":{"intent":{"type":"string","pattern":"^cvi_"},"expires_at":{"type":"string","format":"date-time"},"expires_in":{"type":"integer","const":120}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"operation-dependent","x-coldvio-confirmation-required":false}},"/v1/agent/summary":{"get":{"operationId":"get_summary","summary":"Get credits and account counts","tags":["Account"],"security":[{"customerAgentToken":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/voice-profile":{"get":{"operationId":"get_voice_profile","summary":"Get the active voice profile","tags":["Account"],"security":[{"customerAgentToken":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/agent/contacts":{"get":{"operationId":"list_contacts","summary":"Search tenant-owned CRM contacts","tags":["CRM"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":120}},{"name":"status","in":"query","schema":{"type":"string","maxLength":30}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/agent/contacts/{id}":{"get":{"operationId":"get_contact","summary":"Get one tenant-owned contact","tags":["CRM"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false},"patch":{"operationId":"update_contact","summary":"Update selected CRM fields","tags":["CRM"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Coldvio-Intent","in":"header","required":true,"schema":{"type":"string","pattern":"^cvi_"},"description":"One-use, 120-second operation intent issued for this exact customer, operation, resource, and payload."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:write","x-coldvio-confirmation-required":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["expected_updated_at"],"properties":{"expected_updated_at":{"type":"string","format":"date-time","description":"Contact updated_at value returned by the update-confirmation endpoint"},"status":{"type":"string","enum":["new","contacted","accepted","replied","not-interested","closed"]},"notes":{"type":["string","null"],"maxLength":10000},"tags":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":50}},"follow_up_date":{"type":["string","null"],"format":"date-time"}},"minProperties":2}}}}}},"/v1/agent/contacts/{id}/update-confirmation":{"get":{"operationId":"get_contact_update_confirmation","summary":"Get authoritative contact identity and version immediately before a confirmed update","tags":["CRM"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:write","x-coldvio-confirmation-required":false}},"/v1/agent/lead-lists":{"get":{"operationId":"list_lead_lists","summary":"List tenant-owned lead lists","tags":["CRM"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/agent/lead-lists/{id}/leads":{"get":{"operationId":"list_leads","summary":"Search leads in one list","tags":["CRM"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"q","in":"query","schema":{"type":"string","maxLength":120}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/agent/campaigns":{"get":{"operationId":"list_campaigns","summary":"List outreach campaigns","tags":["Campaigns"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"status","in":"query","schema":{"type":"string","maxLength":30}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/agent/campaigns/{id}":{"get":{"operationId":"get_campaign","summary":"Get one campaign and its steps","tags":["Campaigns"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/agent/actions":{"get":{"operationId":"list_actions","summary":"List campaign actions","tags":["Campaigns"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"campaign_id","in":"query","schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","schema":{"type":"string","maxLength":30}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/agent/actions/{id}":{"get":{"operationId":"get_action","summary":"Get one campaign action with authoritative review context","tags":["Campaigns"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/agent/actions/{id}/approval-confirmation":{"get":{"operationId":"get_action_approval_confirmation","summary":"Get the narrow authoritative context required to approve or reject one action","tags":["Campaigns"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:approve","x-coldvio-confirmation-required":false}},"/v1/campaign-actions/{id}/approve":{"patch":{"operationId":"approve_action","summary":"Approve a pending action; may queue an external action","tags":["Campaigns"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Coldvio-Intent","in":"header","required":true,"schema":{"type":"string","pattern":"^cvi_"},"description":"One-use, 120-second operation intent issued for this exact customer, operation, resource, and payload."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:approve","x-coldvio-confirmation-required":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["expected_text"],"additionalProperties":false,"properties":{"expected_text":{"type":"string","minLength":1,"maxLength":2000,"description":"Exact generated text reviewed before approval; the API rejects stale text."},"edited_text":{"type":"string","minLength":1,"maxLength":2000}}}}}}}},"/v1/campaign-actions/{id}/reject":{"patch":{"operationId":"reject_action","summary":"Reject a pending action","tags":["Campaigns"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Coldvio-Intent","in":"header","required":true,"schema":{"type":"string","pattern":"^cvi_"},"description":"One-use, 120-second operation intent issued for this exact customer, operation, resource, and payload."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:approve","x-coldvio-confirmation-required":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}}}},"/v1/agent/posts":{"get":{"operationId":"list_posts","summary":"List content posts","tags":["Content"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"status","in":"query","schema":{"type":"string","maxLength":30}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/agent/posts/{id}":{"get":{"operationId":"get_post","summary":"Get one content post","tags":["Content"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/agent/trends":{"get":{"operationId":"list_trends","summary":"List cached customer trend ideas","tags":["Content"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:read","x-coldvio-confirmation-required":false}},"/v1/linkedin/generate":{"post":{"operationId":"generate_linkedin_draft","summary":"Generate a LinkedIn draft; spends credits and does not send","tags":["Generation"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"X-Coldvio-Intent","in":"header","required":true,"schema":{"type":"string","pattern":"^cvi_"},"description":"One-use, 120-second operation intent issued for this exact customer, operation, resource, and payload."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:generate","x-coldvio-confirmation-required":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"title":"Outreach draft","type":"object","required":["taskType","profile"],"additionalProperties":true,"properties":{"taskType":{"const":"outreach"},"profile":{"type":"object","required":["name"],"additionalProperties":true,"properties":{"name":{"type":"string","minLength":1,"maxLength":2000},"headline":{"type":"string","maxLength":2000}}},"purpose":{"type":"string","maxLength":2000},"customAngle":{"type":"string","maxLength":2000}}},{"title":"Reply draft","type":"object","required":["taskType","conversation"],"additionalProperties":true,"properties":{"taskType":{"const":"reply"},"conversation":{"type":"string","minLength":1,"maxLength":20000},"purpose":{"type":"string","maxLength":2000},"customAngle":{"type":"string","maxLength":2000}}},{"title":"Comment draft","type":"object","required":["taskType","post"],"additionalProperties":true,"properties":{"taskType":{"const":"comment"},"post":{"oneOf":[{"type":"string","minLength":1,"maxLength":10000},{"type":"object","required":["postText"],"additionalProperties":true,"properties":{"postText":{"type":"string","minLength":1,"maxLength":10000},"replyTo":{"type":"object","required":["text"],"additionalProperties":true,"properties":{"text":{"type":"string","minLength":1,"maxLength":2000}}}}}]},"purpose":{"type":"string","maxLength":2000},"customAngle":{"type":"string","maxLength":2000}}},{"title":"CRM action suggestions","type":"object","required":["taskType","contact","messages"],"additionalProperties":true,"properties":{"taskType":{"const":"crm_actions"},"contact":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","maxLength":2000},"headline":{"type":"string","maxLength":2000},"company":{"type":"string","maxLength":2000},"mode":{"type":"string","maxLength":2000},"status":{"type":"string","maxLength":2000},"notes":{"type":"string","maxLength":10000},"tags":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":200}},"lastInteractionDate":{"oneOf":[{"type":"number","minimum":-8640000000000000,"maximum":8640000000000000,"description":"Unix epoch milliseconds"},{"type":"string","format":"date-time","pattern":"^\\d{4}-(0[1-9]|1[0-2])-[0-3]\\d[Tt]([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:[Zz]|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"},{"type":"null"}]},"followUpDate":{"oneOf":[{"type":"number","minimum":-8640000000000000,"maximum":8640000000000000,"description":"Unix epoch milliseconds"},{"type":"string","format":"date-time","pattern":"^\\d{4}-(0[1-9]|1[0-2])-[0-3]\\d[Tt]([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:[Zz]|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"},{"type":"null"}]}}},"messages":{"type":"array","maxItems":50,"items":{"type":"object","required":["text"],"additionalProperties":true,"properties":{"text":{"type":"string","maxLength":2000},"direction":{"type":"string","enum":["sent","received"]},"timestamp":{"oneOf":[{"type":"number","minimum":-8640000000000000,"maximum":8640000000000000,"description":"Unix epoch milliseconds"},{"type":"string","format":"date-time","pattern":"^\\d{4}-(0[1-9]|1[0-2])-[0-3]\\d[Tt]([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:[Zz]|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"}]}}}},"purpose":{"type":"string","maxLength":2000},"customAngle":{"type":"string","maxLength":2000}}}]}}}}}},"/v1/email/generate":{"post":{"operationId":"generate_email_draft","summary":"Generate an email draft; spends credits and does not send","tags":["Generation"],"security":[{"customerAgentToken":[]}],"parameters":[{"name":"X-Coldvio-Intent","in":"header","required":true,"schema":{"type":"string","pattern":"^cvi_"},"description":"One-use, 120-second operation intent issued for this exact customer, operation, resource, and payload."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"428":{"$ref":"#/components/responses/IntentRequired"},"429":{"$ref":"#/components/responses/RateLimited"}},"x-coldvio-scope":"agent:generate","x-coldvio-confirmation-required":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["subject","threadContext","emailMode"],"additionalProperties":false,"properties":{"subject":{"type":"string","minLength":1,"maxLength":500},"threadContext":{"type":"string","maxLength":20000},"emailMode":{"type":"string","enum":["reply","compose"]}}}}}}}}},"components":{"securitySchemes":{"customerAgentToken":{"type":"http","scheme":"bearer","bearerFormat":"opaque","description":"Purpose-bound customer token provisioned by the Coldvio CLI's custom browser PKCE flow. The exchange endpoint is not a standards-compatible OAuth token endpoint; integrations should delegate provisioning to the CLI."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Missing, expired, or revoked customer agent token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"Wrong token audience or insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"IntentRequired":{"description":"A matching operation intent is missing, expired, changed, or already consumed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"externalDocs":{"description":"Coldvio developer documentation","url":"https://www.coldvio.com/developers"},"x-documentation":{"readme":"# Coldvio Agent API\n\nThe customer-scoped API behind the Coldvio CLI and local MCP server. It exposes a deliberate allowlist for voice, CRM, campaigns, content, trends, draft generation, and reviewed actions.\n\n## Quickstart\n\nUse the browser PKCE flow in the versioned CLI. Do not ask customers to paste bearer tokens into prompts or project configuration.\n\n```bash\nnpx -y @coldvio/cli@0.1.0 login\nnpx -y @coldvio/cli@0.1.0 status\n```\n\nBase URL: `https://api.coldvio.com`\n\nAll operations require a purpose-bound customer agent token. Every data query is tenant-scoped server-side. CRM writes, generation, approvals, and rejections require exact confirmation plus a short-lived, single-use server intent bound to the exact payload. Direct send, direct publish, and generic execute operations are not exposed.\n\nStatus: prepared for customer beta; not live until the controlled rollout completes."}}