Skip to main content
GET
Get a signed artifact download link

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Path Parameters

id
string<uuid>
required

Response

Bad request — the payload failed validation

Uniform error envelope returned for every non-2xx response

status
integer<int32>
required

HTTP status code (mirrors the response status line)

Example:

404

code
string
required

Stable machine code for this error, such as NOT_FOUND or SYNTHETICS_USAGE_CAPPED

Example:

"NOT_FOUND"

category
enum<string>
required

Machine class clients use to choose the next action

Available options:
validation,
blocked,
auth,
permission,
ownership,
plan,
quota,
rate_limit,
conflict,
confirmation_required,
not_found,
gone,
platform
retryable
boolean
required

Whether a later attempt can succeed without changing the request

Example:

false

message
string
required

Human-readable error message; safe to surface to end users

Example:

"Monitor not found"

timestamp
integer<int64>
required

Server time when the error was produced (epoch milliseconds)

Example:

1737302400000

requestId
string | null

Opaque per-request id; same value as the X-Request-Id response header. Use in support tickets.

Example:

"5b6f7a8c-1234-4d5e-9f0a-1b2c3d4e5f6a"

errors
(object | null)[] | null

Structured per-field rejections; populated for validation errors, null otherwise

One structured validation rejection

retryAfterSeconds
integer<int64> | null

Seconds to wait before retrying a rate limit

Example:

30

resource
string | null

Meter or resource this limit applies to

Example:

"browser_runs"

used
integer<int64> | null

Amount used in the current period

Example:

1000

limit
integer<int64> | null

Maximum allowed for this period or plan

Example:

1000

resetsAt
string | null

When this quota window resumes (ISO-8601)

Example:

"2026-11-01T00:00:00Z"

plan
string | null

Plan this refusal was evaluated against

Example:

"FREE"

upgradeUrl
string | null

Page where an admin can change the plan

Example:

"https://app.devhelm.io/settings/billing"

canRaise
string | null

Role that can raise this limit

Example:

"org admin"

owner
string | null

Who owns the resource when a write is refused

required
string | null

Missing scope, secret key, or other required value

have
integer<int64> | null

Current amount compared with the plan limit

Example:

10

reason
enum<string> | null

Why permission was refused: scope or role

Available options:
scope,
role
Example:

"role"

next
object | null

Command and documentation that fix this error

details
object | null

Extra fields for this error, such as a missing secret key and environment

expiredAt
string<date-time> | null

When this evidence expired

policy
string | null

Retention written when the artifact was saved, such as P7D