Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Currents trace Digest 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: Digest
paths:
/{slug}/digest:
get:
summary: 'The trace summary: what the attempt did and what failed'
description: Browser name, the Playwright version that recorded the trace (playwrightVersion) and its trace format version (traceFormatVersion), each null when the trace does not record it. Actions (runner-step titles, nested, deduped against browser-side calls), failing actions with errors and frame/snapshot links, page errors (exceptions the page did not catch, with the first stack frame and t=), console errors, network failures, attachments, screencast summary. networkOmitted names a .network entry too large to read, whose requests are missing from the counts and from /requests. The markdown format links every t= to the frame and snapshot endpoints.
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: format
in: query
required: false
description: json (default) or md
schema:
type: string
enum:
- json
- md
- name: timeline
in: query
required: false
description: auto (default) keeps the timeline focused on failures — every failing action with its ancestor steps and nearby rows, gaps elided; full returns every action (and lifts the JSON action cap)
schema:
type: string
enum:
- auto
- full
responses:
'200':
description: 'The trace summary: what the attempt did and what failed (application/json | text/markdown)'
'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:
- Digest
operationId: getBySlugDigest
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer