Skip to main content
PATCH
Curate, publish or withdraw native platform setup

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Headers

If-Match
string
required

Current strong tag from the resource's GET. A stale tag returns 412 with the current etag; an absent one returns 428.

Path Parameters

id
string
required

Stable platform slug. The bound is the one afd_authoring enforces on it with garde, published so a client learns it before the 400.

Required string length: 1 - 128

Body

application/json

Conditional platform-owned metadata edit.

description
string | null

Curated description.

name
string | null

Display label.

published
boolean | null

Explicitly publish or withdraw the staged entry.

required_credentials_reasons
object | null

Credential-name explanations, never credential values.

Response

Current platform metadata

Platform metadata without instructions or private authoring content.

card
object
required

Immutable head metadata with the current resource tag.

published
boolean
required

Whether new tenant discovery and installation are allowed.

updated_at
integer<int64>
required

Last metadata mutation, in Unix milliseconds.