API Reference
Audit Opportunity Draft
Audit a saved draft revision. Returns advisory findings without editing, approving, scheduling, or executing it.
Audit a saved draft revision. Returns advisory findings without editing, approving, scheduling, or executing it. Cache policy: live. Idempotency: required. Auth modes: api_key, mcp_oauth, session_bearer.
AuthorizationBearer <token>
Rankhog organization API key sent as Authorization: Bearer rhog_....
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/agent/v1/opportunities/draft/audit" \ -H "Content-Type: application/json" \ -d '{ "managedRedditAccountId": "mra_2x9rnkhdemo", "organizationId": "org_2x9rnkhdemo", "websiteId": "site_2x9rnkhdemo", "idempotencyKey": "audit-draft-3", "opportunityId": "opp_2x9opportunity", "expectedRevision": 3 }'{ "auditJobId": "job_2x9rnkhdemo", "opportunityId": "opp_2x9opportunity", "draftRevision": 3}{ "error": { "code": "agentic_invalid_input", "details": { "issues": [ { "code": "invalid_type", "message": "Expected string, received undefined.", "path": [ "organizationId" ] } ] }, "message": "Request body did not match the agentic capability schema." }}{ "error": { "code": "agentic_unauthorized", "message": "Authenticate before using Rankhog agentic capabilities." }}{ "error": { "code": "agentic_paid_plan_required", "details": { "managedAccountBillingStatus": "active", "productId": "site_demo", "subscriptionStatus": "past_due" }, "message": "This product has no active plan or trial yet. Call get_product_setup with productId site_demo: it gives the link where the person starts the 7-day trial. Never pay for them." }}{ "error": { "code": "agentic_missing_scope", "details": { "missingScopes": [ "rankhog:read", "reddit:draft:write" ] }, "message": "Missing required scope: rankhog:read, reddit:draft:write." }}{ "error": { "code": "agentic_managed_account_not_found", "message": "Managed Reddit account not found." }}{ "error": { "code": "agentic_internal_error", "message": "Rankhog could not complete this agentic request." }}