Tags

URL base da API

https://crm.vdgestaobranding.com/api/v1

A documentação fica em developers.vdgestaobranding.com, mas todas as chamadas vão para crm.vdgestaobranding.com/api/v1.

GET/tags

settings:manage

Listar tags

curl -X GET "https://crm.vdgestaobranding.com/api/v1/tags" \
  -H "Authorization: Bearer $VDCRM_API_KEY"

Resposta 200

{
  "data": [
    {
      "id": "x1…",
      "name": "vip",
      "color": "amber"
    }
  ]
}

POST/tags

settings:manage

Idempotency-Key

Criar

curl -X POST "https://crm.vdgestaobranding.com/api/v1/tags" \
  -H "Authorization: Bearer $VDCRM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "vip",
  "color": "amber"
}'

Resposta 201

{
  "id": "x1…",
  "name": "vip",
  "color": "amber"
}

PATCH/tags/{id}

settings:manage

Atualizar

curl -X PATCH "https://crm.vdgestaobranding.com/api/v1/tags/{id}" \
  -H "Authorization: Bearer $VDCRM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "vip",
  "color": "amber"
}'

DELETE/tags/{id}

settings:manage

Excluir

curl -X DELETE "https://crm.vdgestaobranding.com/api/v1/tags/{id}" \
  -H "Authorization: Bearer $VDCRM_API_KEY"