Skip to main content
POST
Update a stack profile draft

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

draft_id
string<uuid>
required

Body

application/json

Metadata fields are partial: null or omitted leaves the stored value unchanged.

spec
object
required

The profile's stack specification: stacks with their add-ons, manifests and variables.

version
integer
required

The draft version last read; a mismatch answers 409.

parameters
object[]
description
string | null
category
string | null
tags
string[] | null
requested_visibility
enum<string> | null
Available options:
organisation,
public,
null

Response

Updated draft

A builder draft. Metadata fields are null when never edited on the draft.

id
string<uuid>
required
organisation_id
string<uuid>
required
profile_id
string<uuid> | null
required
name
string
required
spec
object
required

The profile's stack specification: stacks with their add-ons, manifests and variables.

parameters
object[]
required
base_version
integer | null
required
version
integer
required

Optimistic-lock version; send it back on update.

created_at
string<date-time>
required
updated_at
string<date-time>
required
description
string | null
required
category
string | null
required
tags
string[] | null
required
requested_visibility
string | null
required
suggestion_target_profile_id
string<uuid> | null
required

Set when the draft proposes changes to another organisation's profile.

suggestion_base_version
integer | null
required