generated: '2026-10-19'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://v12.sh/docs/quickstart
sources:
- https://v12.sh/docs/quickstart
- https://v12.sh/docs/public-api/quickstart
- https://v12.sh/docs/public-api/authentication
idempotency:
  coverage: partial
  evidence: Idempotency-Key on 2 of 19 mutating operations
  scope:
  - commentOnFinding
  - startRun
  header: Idempotency-Key
  mechanism: request header / body token declared in the OpenAPI
  verified: derived
pagination:
  style: cursor
  params:
  - limit
  - cursor
  response_fields:
  - nextCursor
  evidence: Responses include a `nextCursor` field to be sent back as `cursor` for the next page; `limit` controls page size and `nextCursor`
    is null on the last page.
versioning: API version is encoded in the URL path (e.g., /api/v2/...).
error_envelope: Error bodies contain a `requestId` field and standard HTTP status codes; additional error details are provided in a `details`
  object.
authentication: Bearer token in the `Authorization` header; token prefixes are `v12p_` for API keys and `v12a_` for OAuth tokens.
request_tracing: Every error response includes a `requestId` that can be used for tracing.
rate_limit_signaling: Responses include `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers indicating the bucket, remaining
  quota, and seconds until reset.
note: Fields not described in the provided pages are set to null or omitted.
docs: https://v12.sh/docs/quickstart