Skip to main content
POST
Create dashboard revision

Authorizations

Authorization
string
header
required

workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens

Headers

if-match
string
required

The etag of the resource version the client last read. Required on writes when the resource exposes an etag field. Mismatch returns 409 ABORTED with the current etag in the error metadata.

Required string length: 1 - 256
Example:

"42"

idempotency-key
string
required

Required caller-supplied idempotency key. Any non-empty key up to 64 characters is accepted. Endpoint-specific documentation describes how the key is used.

Required string length: 1 - 64
Example:

"create-prod-2026-05-07"

Path Parameters

id
string
required
Required string length: 1 - 55

Body

application/json
name
string
required
Required string length: 1 - 100
description
string | null
required
Maximum string length: 500
filter_definitions
object[]
required
Maximum array length: 24
default_filter_values
object
required
widgets
object[]
required
Maximum array length: 24
summary
string
Maximum string length: 500

Response

Dashboard revision created and activated

id
string
required
Required string length: 1 - 55
dashboard_id
string
required
Required string length: 1 - 55
workspace_id
string
required
Required string length: 1 - 53
parent_revision_id
string | null
required
Required string length: 1 - 55
restored_from_revision_id
string | null
required
Required string length: 1 - 55
source
enum<string>
required
Available options:
manual,
automatic,
restore,
reset,
backfill
author_id
string
required
summary
string | null
required
name
string
required
description
string | null
required
purpose
enum<string>
required
Available options:
workspace_overview,
custom
filter_definitions
object[]
required
Maximum array length: 24
default_filter_values
object
required
widgets
object[]
required
structural_diff
object | null
required
snippet_etag_drift
object[]
required
created_at
integer
required

Unix timestamp (seconds)

Required range: x >= 0
dashboard_etag
string
required