Skip to main content
POST
Import published package

Authorizations

Authorization
string
header
required

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

Headers

akua-context
string

Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens — a workspace-owned token implies its workspace.

Required string length: 1 - 53
Example:

"ws_j572abc123def456"

idempotency-key
string

Optional 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"

Body

application/json
name
string
required
Required string length: 1 - 120
oci_ref
string
required

OCI reference for the published Akua Package repository. If this registry matches an active workspace registry credential, Akua uses that credential to inspect the artifact.

Required string length: 1 - 2048
Pattern: ^oci:\/\/
version
object
required
description
string | null
Maximum string length: 1000

Response

Package imported

id
string
required
Required string length: 1 - 54
html_url
string<uri>
required

Absolute dashboard URL for this resource. OUTPUT_ONLY.

Maximum string length: 2048
Example:

"https://akua.dev/packages/pkg_j572abc123def456"

workspace_id
string
required
Required string length: 1 - 53
name
string
required
latest_version_id
string
required
Required string length: 1 - 55
description
string | null
required
source
object
required
created_at
integer
required

Unix timestamp (seconds)

Required range: x >= 0
composed_from_sources
object[] | null

Source provenance used to create this Package (helm URLs, OCI refs, git source details). Only visible in view=full.

etag
string