Synupv1
Criar chave
v1Recursos/Custom Fields/patchAtualizar uma definição de campo personalizado

Atualizar uma definição de campo personalizado

Edita o label, a flag required, as opções ou a ordem de exibição de uma definição de campo personalizado. O type e a key do campo não podem ser alterados após a criação.

patch/api/v1/custom-fields/definitions
custom-fields:write
Corpo da solicitação
definitionIdstringobrigatório
ID da definição de campo personalizado a ser atualizada.
labelstringopcional
O rótulo de exibição do campo personalizado.
requiredbooleanopcional
Se o campo deve ser marcado como required. Opcional; o padrão é false.
optionsarray of stringopcional
As opções selecionáveis do campo. Obrigatório (pelo menos uma) para campos single_select e multi_select; ignorado para outros tipos.
ordernumberopcional
Nova ordem de exibição para esta definição em relação a outras do mesmo tipo de entidade.
Resposta
dataobjectopcional
definitionobjectopcional
idstringopcional
Identificador único da definição de campo personalizado.
entityTypestring (location | client)opcional
O tipo de entidade ao qual esta definição se aplica: "location" ou "client".
keystringopcional
Slug imutável identificando este campo, derivado do seu label na criação. Use isto para referenciar o campo ao definir valores.
labelstringopcional
O rótulo de exibição do campo personalizado.
typestring (text | number | date | single_select | multi_select)opcional
O tipo de valor do campo.
requiredbooleanopcional
Se o campo está marcado como required. Isto não é aplicado pela API — é apenas uma dica para a interface.
optionsarray of stringopcional
As opções selecionáveis do campo, para campos single_select e multi_select. Null para outros tipos.
createdBystringopcional
Quem criou esta definição de campo: "user" ou "agent".
ordernumberopcional
A ordem de exibição do campo em relação a outras definições do mesmo tipo de entidade, a menor primeiro.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
patch/api/v1/custom-fields/definitions
Sua chave de API
Corpo da solicitação*
{
  "data": {
    "definition": {
      "id": "cm_def_abc123",
      "entityType": "location",
      "key": "parking_notes",
      "label": "Parking notes",
      "type": "text",
      "required": true,
      "options": null,
      "createdBy": "user",
      "order": 0
    }
  }
}