v1Resources/Approvals/postUpdate task fields
Update task fields
Creates, renames or archives a custom field on Tasks, or sets values on tasks the key's creator can see. Send a mutationId and one command. Fields are shared across the whole workspace. Errors use the Tasks & Approvals error shape.
post
approvals:write/api/v1/work-management/tasks/fieldsRequest body
mutationIdstringrequired
A UUID you choose for this change. Resending it with the same command returns the first result without applying the change again; reusing it with a different command returns 409.
commandobjectrequired
One change. field_create adds a field with label, type and options. field_update renames a field, changes its options, or archives or restores it, and needs the field's current version as expectedVersion. values_update sets 1 to 1000 values, each with recordId, fieldId, value and expectedVersion, and applies all or none. An option that records still hold can't be removed; archive it instead. A field set holds at most 40 fields, archived ones included.
Errors
400The request is invalid, for example a malformed command, a body over 1 MB, or a value that doesn't fit the field.
401Missing, invalid, expired, or revoked API key.
403The key's creator isn't allowed to use task fields.
404The task or field isn't available to the key's creator.
409A field or one of its stored values changed since you read it, a field with that name already exists, or the mutationId was already used with a different command.
429Too many requests. Retry after the number of seconds in the Retry-After header.
500The request couldn't be completed because of a problem on our side.
503The service is temporarily unavailable. Try again later.
post/api/v1/work-management/tasks/fields
Your API key
Request body*
{}