Awzor Media LLC Runs API

openapi: 3.2.0
info:
  title: Hook Detector Runs API
  description: 'Find short-form hooks that already work.


    Sign up with a beta access code (ask at https://hookdetector.com/access): one POST to

    `/v1/accounts` with `access_code` gives an API key and free credits. The same operations are available as MCP tools at `/mcp`.


    Full guide, always current, at `/llms.txt`.'
  contact:
    name: Hook Detector
    url: https://hookdetector.com/
    email: contact@hookdetector.com
  version: 3.0.0
tags:
- name: Runs
paths:
  /v1/runs/{run_id}/thumbs/{key}:
    get:
      tags:
      - Runs
      summary: A clip on a run's live research wall, as a JPEG for an tag
      description: 'The cover of one clip a run in flight is working on: the thumb_url of an entry in

        progress.feed. No key needed (an cannot send one): the URL is the secret, an HMAC

        of the run and the clip under the server''s secret, so it cannot be guessed. Served from

        the cover the run already holds, re-encoded; 404 once the run no longer shows it. Cached

        for a day. Free. On MCP the same URL is in get_run''s progress.feed.'
      operationId: get_thumb_v1_runs__run_id__thumbs__key__get
      parameters:
      - name: run_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Run Id
      - name: key
        in: path
        required: true
        schema:
          type: string
          title: Key
      responses:
        '200':
          description: the clip's cover as a JPEG, at most 400 KB
          content:
            image/jpeg:
              schema:
                type: string
                format: binary
        '404':
          description: not found on this account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '422':
          description: invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '429':
          description: rate limited; see Retry-After
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '500':
          description: our fault; names the request id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
components:
  schemas:
    ErrorOut:
      properties:
        detail:
          type: string
          title: Detail
          description: one sentence a person can read
        code:
          type: string
          title: Code
          description: stable machine code; see the Errors section of /llms.txt
        errors:
          anyOf:
          - items:
              additionalProperties: true
              type: object
            type: array
          - type: 'null'
          title: Errors
          description: 'on a 422 only: the field level list'
      additionalProperties: true
      type: object
      required:
      - detail
      - code
      title: ErrorOut
      examples:
      - code: run_not_found
        detail: no such run for this account