v2

latestOpenAPI 3.1.02026-07-2615946107.7 KB

Artifacts

Update artifact metadata

Update visibility, name, social link-preview fields, or anonymous-access opt-ins. Public visibility requires a paid plan or paid Teams workspace; otherwise visibility is held with code VISIBILITY_HELD and a paywall notice.

patch/v1/artifacts/{id}

Request body

namestring

visibility'public' | 'workspace' | 'private'

'unlisted' was retired 2026-07 — still accepted as input and treated as 'public'.

allow_anon_writeboolean

Let anonymous visitors mutate json/tables/blobs/datasets on public artifacts.

allow_anon_emailboolean

Let anonymous visitors send contact-form email.

allow_anon_agentboolean

Let anonymous visitors use the in-artifact AI chat agent.

allow_anon_collabboolean

Let anonymous visitors join realtime collaboration.

social_titlestring nullable

social_descriptionstring nullable

social_image_urlstring nullable

Response

Updated

idstring

namestring

slugstring

visibility'public' | 'workspace' | 'private'

'unlisted' was retired 2026-07 — still accepted as input and treated as 'public'.

moderation_status'approved' | 'pending' | 'blocked'

Safety review state for open visibility.

allow_anon_writeboolean

allow_anon_emailboolean

allow_anon_agentboolean

allow_anon_collabboolean

urlstring uri

thumbnail_urlstring uri

is_favoriteboolean

created_atinteger