Skip to main content
PUT
Update a field

Authorizations

x-token
string
header
required

Headers

x-company-id
string

Required with a partner bearer token (board-admin): the company that owns the board. Standard boards such as unit share one board UUID across companies, so the board is looked up by UUID within this company. companyId in the request body or query string is also accepted. A partner request without a company is rejected with MISSING_DATA (400), and a board the company does not own is BOARD_NOT_FOUND (404). Ignored for API keys, whose company comes from the key.

Path Parameters

boardId
string
required
fieldUuid
string
required

Body

application/json
name
string
optional
boolean
pinned
boolean
startCard
boolean

Show the field on the form when a card is created.

defaultValue
string

Default for new cards; empty string clears it. A dropdown uses an exact option label, not its UUID. Renaming that option carries its default to the new label; removing it requires a new default or an explicit empty default.

data
object[]

Response

The updated field.

data
object