Rankhog Docs
DocsCLIMCPAPI
API Reference

Cancel Job

Cancel one scheduled Rankhog job the actor is authorized for. Running, finished, failed, and cancelled jobs cannot be cancelled. Cache policy: live. Idempotency: required. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/jobs/cancel

Cancel one scheduled Rankhog job the actor is authorized for. Running, finished, failed, and cancelled jobs cannot be cancelled. Cache policy: live. Idempotency: required. Auth modes: api_key, mcp_oauth, session_bearer.

Authorization

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/jobs/cancel" \  -H "Content-Type: application/json" \  -d '{    "idempotencyKey": "cancel-job-2026-06-17-001",    "jobId": "job_2x9rnkhdemo",    "organizationId": "org_2x9rnkhdemo",    "reason": "Superseded by a manual post."  }'
{  "cancelledAt": "2026-06-17T12:05:00.000Z",  "id": "job_2x9rnkhdemo",  "scheduledAt": "2026-06-17T12:00:00.000Z",  "status": "cancelled",  "type": "reddit.execute_planned_action"}
{  "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_missing_scope",    "details": {      "missingScopes": [        "rankhog:read",        "jobs:write"      ]    },    "message": "Missing required OAuth scope: rankhog:read, jobs:write."  }}

{  "error": {    "code": "agentic_job_not_found",    "message": "Job not found."  }}
{  "error": {    "code": "agentic_job_not_cancellable",    "message": "Only scheduled jobs can be cancelled."  }}
{  "error": {    "code": "agentic_internal_error",    "message": "Rankhog could not complete this agentic request."  }}

Get Reddit Account Protection POST

Return the protection policy and pacing risk that gate Reddit writes for one workspace account, so a blocked execution can be predicted instead of discovered. Changing the policy stays human-only. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

Reschedule Job POST

Move one scheduled Rankhog job to a new time. Only scheduled jobs can be rescheduled. Cache policy: live. Idempotency: required. Auth modes: api_key, mcp_oauth, session_bearer.