v50

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-112650216.3 KB

Accounts

Create support ticket

Creates a rate-limited account-scoped service ticket with scraper request evidence. Account API keys are accepted so users and AI/API agents can open service tickets.

post/v1/support/tickets

Request body

subjectstring required

detailsstring required

request_idstring nullable

scraper_idstring nullable

failing_commandstring nullable

first_log_linestring nullable

severity'low' | 'normal' | 'urgent'

Support ticket severity.

Example request

{
  "subject": "Request failed",
  "details": "Request failed after retry.",
  "request_id": "request_123",
  "scraper_id": "tiktok",
  "failing_command": "tovuk request show request_123 --json",
  "first_log_line": "upstream timeout",
  "severity": "normal"
}

Response

Account-scoped service ticket created.

next_commandstring required

Example response

{
  "ticket": {
    "id": "ticket_0123456789abcdef0123",
    "created_by": "account_api_key",
    "subject": "Request failed",
    "details": "Request failed after retry.",
    "request_id": "request_123",
    "scraper_id": "tiktok",
    "failing_command": "tovuk request show request_123 --json",
    "first_log_line": "upstream timeout",
    "status": "open",
    "severity": "normal",
    "agent_instruction": "Continue with tovuk request diagnostics.",
    "created_at": "2026-06-23T12:00:00Z",
    "updated_at": "2026-06-23T12:10:00Z"
  },
  "rate_limit": {
    "limit_per_hour": 10,
    "remaining_hour": 9,
    "limit_per_day": 10,
    "remaining_day": 9
  },
  "next_command": "tovuk support list --json"
}