Sign in

Create a bead

Changed on
post/v0/city/{cityName}/beads

Request

  • The document declares no server URL.
  • Auth: none declared. Required headers: X-GC-Request

Path parameters

cityNamestring required

City name.

Headers

X-GC-Requeststring required

Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.

Idempotency-Keystring

Idempotency key for safe retries.

Request body

assigneestring

Assigned agent.

defer_untilstring date-time

Hide the bead from ready views until this time.

descriptionstring

Bead description.

labelsstring[] nullable

Bead labels.

metadataobject

Metadata key-value pairs to set at create time.

parentstring

Parent bead ID.

priorityinteger

Bead priority.

rigstring

Rig name.

titlestring required

Bead title.

typestring

Bead type.

Response

Created

assigneestring
close_reasonstring
created_atstring date-time required
defer_untilstring date-time
descriptionstring
ephemeralboolean
fromstring
idstring required
is_blockedboolean
issue_typestring required
labelsstring[] nullable
metadataobject
needsstring[] nullable
no_historyboolean
parentstring
priorityinteger
refstring
statusstring required
titlestring required
updated_atstring date-time

Changes