Skip to main content
POST
Create a draft

Authorizations

Authorization
string
header
required

Your personal access token where supported, or a scoped API key (hc_…) created inside HueChat at Account → Developer API. Send it as Authorization: Bearer <token>.

Path Parameters

accountId
integer
required
Required range: x >= 1

Body

application/json
title
string
required
Required string length: 1 - 160
definition
object

Owner editable definition, maximum serialized size 256 KiB. PublicDefinition strips notes and private AI configuration.

share_mode
enum<string>
Available options:
public_link

Response

Draft created

id
string<uuid>
title
string
status
enum<string>
Available options:
draft,
published,
closed,
archived
public_code
string
public_url
string<uri>

Built by the server from trusted FRONTEND_URL, never a fixed tenant subdomain.

definition
object

Owner editable definition, maximum serialized size 256 KiB. PublicDefinition strips notes and private AI configuration.

published_version
integer
version
integer
share_mode
enum<string>
Available options:
public_link,
invitation_only
created_at
string<date-time>
updated_at
string<date-time>
responses
integer
Required range: x >= 0
completed
integer
Required range: x >= 0
views
integer
Required range: x >= 0
starts
integer
Required range: x >= 0
published_available
boolean

Server-derived availability of the immutable published definition at the time of this response, including its respondent expiry. False for unpublished or expired definitions.