TOtovuk
Accounts

Create support ticket

Changed on

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

  • Base URL
    https://api.tovuk.com
  • Auth
    HTTP bearer

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"
}

Changes

  • 59ecc410cd88Revision changes
    • info

      added the required property / to the response with the status

  • 4ec70e480044Revision changes
    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property / from the response with the status

    • warning

      added the new in_progress enum value to the / response property for the response status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      the / response's property pattern was changed from ^[\s\S]{0,8192}$ to ^ticket_[a-f0-9]{20}$ for the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status