Currents Requests API

openapi: 3.2.0
info:
  title: Currents trace Requests API
  version: '1'
  description: On-demand access to Playwright trace contents (screencast frames, trace summary, DOM snapshots, network requests, attachments) via ranged zip reads. Human-readable docs at /docs.
servers:
- url: https://t.crts.sh
tags:
- name: Requests
paths:
  /{slug}/requests:
    get:
      summary: Network requests the test made
      description: 'Every request the page issued, from the trace: index (the {index} in the item routes — positions in the unfiltered list, stable under filters), method, url, status, mime type, body size, timing, and the response and request body hashes when captured. format=har returns a standard HAR 1.2 file (bodies excluded) that opens in any HAR viewer, including browser devtools. A .network entry too large to read is left out; the trace summary names it in networkOmitted.'
      parameters:
      - name: slug
        in: path
        required: true
        description: Link slug minted by the Currents backend; grants read access to one trace until the link expires.
        schema:
          type: string
          pattern: ^[A-Za-z0-9_-]{16}$
      - name: status
        in: query
        required: false
        description: 4xx, 5xx, failed (>=400 or no response), or an exact code
        schema:
          type: string
      - name: url
        in: query
        required: false
        description: substring filter on the request url
        schema:
          type: string
      - name: requestBody
        in: query
        required: false
        description: 'substring filter on the body the page sent, like a GraphQL operation name or a value from a form; at most 1000 characters. 422 when the bodies to search are over 32 MB together: narrow with url or status first.'
        schema:
          type: string
      - name: format
        in: query
        required: false
        description: json (default) or har
        schema:
          type: string
          enum:
          - json
          - har
      responses:
        '200':
          description: Network requests the test made (application/json)
        '400':
          description: invalid parameters
        '404':
          description: unknown or expired link, or not found in this trace
        '413':
          description: the trace is larger than the worker can read
        '422':
          description: the trace artifact is not a readable zip
        '502':
          description: the trace could not be fetched from storage
        '503':
          description: this deployment has no link bucket bound, so no link can be read
      tags:
      - Requests
      operationId: getBySlugRequests
      x-operation-id-source: derived
  /{slug}/requests/{index}:
    get:
      summary: One network request
      description: 'The request at this index in the unfiltered list: method, url, status, mime type, body size, timing, and the response and request body hashes when captured.'
      parameters:
      - name: slug
        in: path
        required: true
        description: Link slug minted by the Currents backend; grants read access to one trace until the link expires.
        schema:
          type: string
          pattern: ^[A-Za-z0-9_-]{16}$
      - name: index
        in: path
        required: true
        description: Position in the unfiltered requests list.
        schema:
          type: integer
          minimum: 0
      responses:
        '200':
          description: One network request (application/json)
        '400':
          description: invalid parameters
        '404':
          description: unknown or expired link, or not found in this trace
        '413':
          description: the trace is larger than the worker can read
        '422':
          description: the trace artifact is not a readable zip
        '502':
          description: the trace could not be fetched from storage
        '503':
          description: this deployment has no link bucket bound, so no link can be read
      tags:
      - Requests
      operationId: getBySlugRequestsByIndex
      x-operation-id-source: derived
  /{slug}/requests/{index}/body:
    get:
      summary: A response body the test saw
      description: The captured response body of the request at this index, served with its recorded mime type. The payload behind "the API returned wrong data" — no reproduction needed. 404 when the trace did not capture this body.
      parameters:
      - name: slug
        in: path
        required: true
        description: Link slug minted by the Currents backend; grants read access to one trace until the link expires.
        schema:
          type: string
          pattern: ^[A-Za-z0-9_-]{16}$
      - name: index
        in: path
        required: true
        description: Position in the unfiltered requests list.
        schema:
          type: integer
          minimum: 0
      responses:
        '200':
          description: A response body the test saw (response mimeType)
        '400':
          description: invalid parameters
        '404':
          description: unknown or expired link, or not found in this trace
        '413':
          description: the trace is larger than the worker can read
        '422':
          description: the trace artifact is not a readable zip
        '502':
          description: the trace could not be fetched from storage
        '503':
          description: this deployment has no link bucket bound, so no link can be read
      tags:
      - Requests
      operationId: getBySlugRequestsByIndexBody
      x-operation-id-source: derived
  /{slug}/requests/{index}/request-body:
    get:
      summary: A request body the page sent
      description: The body the page sent with the request at this index (POST data, a GraphQL query and its variables), served with its recorded mime type. Tells apart requests that share a url, like every call to /graphql. 404 when the request had no body.
      parameters:
      - name: slug
        in: path
        required: true
        description: Link slug minted by the Currents backend; grants read access to one trace until the link expires.
        schema:
          type: string
          pattern: ^[A-Za-z0-9_-]{16}$
      - name: index
        in: path
        required: true
        description: Position in the unfiltered requests list.
        schema:
          type: integer
          minimum: 0
      responses:
        '200':
          description: A request body the page sent (request mimeType)
        '400':
          description: invalid parameters
        '404':
          description: unknown or expired link, or not found in this trace
        '413':
          description: the trace is larger than the worker can read
        '422':
          description: the trace artifact is not a readable zip
        '502':
          description: the trace could not be fetched from storage
        '503':
          description: this deployment has no link bucket bound, so no link can be read
      tags:
      - Requests
      operationId: getBySlugRequestsByIndexRequestBody
      x-operation-id-source: derived
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer