spaces

Patch Space Custom Fields

Changed on

Update custom field values on an account or project space. Send a values map keyed by custom field ID (UUID) — fields you omit are left untouched, and a null value clears the field. A Link (url) field takes the URL as a string, or an object {"url": "...", "display_text": "OPTY0012345"} to show that text as the link. A plain string sets the URL with no display text.

The response returns the full field collection after the update plus changed_field_ids, listing only the fields whose value actually changed. An audit event (account.updated / project.updated) is recorded when at least one field changed.

Errors: 422 when a key is not a valid UUID, names a field the space's template does not define, or the value fails the field's validation (for example clearing a required field); 404 when the space does not exist in your organization; 409 when the space has no custom fields to update; 502 when the custom fields service is unavailable.

patch/v2/spaces/{space_id}/custom-fields

Request

  • Base URL
    https://api.getauctor.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.getauctor.com/v2/spaces/{space_id}/custom-fields
  • Auth
    none declared

Path parameters

space_idstring required

Request body

valuesobject required

Map of custom field ID (UUID) to new value. null clears the field. url fields also take an object with url and display_text.

Response

Successful Response

totalinteger required
changed_field_idsstring[] required

IDs of the fields whose value actually changed as a result of the request.

Changes