> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/operacoes-fgts/gerenciar-operacoes/cancelar-operacao.md).

# Cancelar Solicitação de Operação

Cancela uma **consulta** FGTS — de saldo, de valor reservado, de protocolos da reserva ou de status de protocolo — identificada pelo `requestId` retornado na admissão, **desde que ela ainda não tenha começado a ser processada**. É uma operação **síncrona**: a resposta já reflete o desfecho do cancelamento.

{% hint style="info" %}
O cancelamento só é possível **enquanto a operação ainda não começou a ser processada**. Uma vez que ela entrou em processamento ou já foi finalizada, não há mais o que cancelar e o endpoint responde `409`. Apenas o originator dono da operação pode cancelá-la.
{% endhint %}

{% hint style="warning" %}
**Averbação, manutenção de garantia e cancelamento de reserva não podem ser cancelados por este endpoint**, nem antes de começarem a ser processados. Essas operações alteram a reserva ou a garantia na Caixa, e o ciclo de vida delas é controlado pela Giro. Um `DELETE` sobre o `requestId` de uma delas responde `409 OPERATION_NOT_CANCELLABLE` — o mesmo `errorCode` e o mesmo `detail` do conflito por estado.

Vale para as submetidas pelas rotas de operação (`POST /api/v1/fgts/endorsements`, `/guarantee-maintenances`, `/reserve-cancellations` e a [retentativa de averbação](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/operacoes-fgts/submeter-operacoes/retentar-averbacao.md)) e pelas rotas de contrato (`/contracts/{contractNumber}/reserve-cancellations`, `/endorsement-retries`, `/guarantee-maintenances`). Para desfazer uma averbação, use o [Cancelamento de reserva](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/operacoes-fgts/submeter-operacoes/submeter-cancelamento-reserva.md) ou o [cancelamento do contrato](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/contratos/cancelar-contrato.md).

Única exceção: se a Giro já tiver cancelado a operação, o `DELETE` responde `200` com `status: CANCELLED`, como em qualquer cancelamento repetido.
{% endhint %}

{% hint style="warning" %}
Não confunda com o [Cancelamento de reserva](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/operacoes-fgts/submeter-operacoes/submeter-cancelamento-reserva.md): aquele endpoint **submete uma nova operação** de cancelamento de uma reserva FGTS junto à Caixa (gera um protocolo). Este aqui **cancela uma operação que você já submetiu**, pelo `requestId`, antes que ela comece a ser processada.
{% endhint %}

## Request

`DELETE /api/v1/fgts/operations/{requestId}`

Autenticado: `Authorization: Bearer {originatorToken}`.

### Parâmetros

| Parâmetro   | Local | Tipo            | Obrigatório | Descrição                                                                                                                              |
| ----------- | ----- | --------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `requestId` | path  | `string` (uuid) | Sim         | Identificador único da operação retornado na admissão (`202`) — o mesmo usado no polling em `GET /api/v1/fgts/operations/{requestId}`. |

## Response

| Campo         | Tipo                 | Descrição                                                              |
| ------------- | -------------------- | ---------------------------------------------------------------------- |
| `requestId`   | `string` (uuid)      | Identificador único da operação cancelada (o mesmo informado no path). |
| `status`      | `string`             | `CANCELLED` — operação cancelada antes de começar o processamento.     |
| `cancelledAt` | `string` (date-time) | Instante em que o cancelamento foi efetivado (ISO-8601 UTC).           |

* **200 OK** — operação cancelada. O `status` passa a `CANCELLED` e o mesmo desfecho aparece depois no polling (`GET /api/v1/fgts/operations/{requestId}`).

{% hint style="info" %}
O endpoint é **idempotente**: chamar `DELETE` novamente sobre uma operação **já cancelada** retorna `200` com o mesmo corpo (`status: CANCELLED` e o `cancelledAt` original). Não é necessário tratar a repetição como erro.
{% endhint %}

## Exemplo

```http
DELETE /api/v1/fgts/operations/f47ac10b-58cc-4372-a567-0e02b2c3d479 HTTP/1.1
Host: ingress.gtfgts.staging.giro.tech
Authorization: Bearer {originatorToken}
```

```json
{
  "requestId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "CANCELLED",
  "cancelledAt": "2026-06-17T12:00:00Z"
}
```

## Erros

| Código | Situação                                                                                                                                                                                                                                                |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 401    | Token ausente, inválido ou expirado — `errorCode = UNAUTHORIZED`                                                                                                                                                                                        |
| 404    | Não existe operação com esse `requestId` no seu escopo — `errorCode = OPERATION_NOT_FOUND`                                                                                                                                                              |
| 409    | A operação não pode ser cancelada: já está em processamento ou foi finalizada, **ou** é uma averbação, manutenção de garantia ou cancelamento de reserva (não canceláveis por este endpoint em nenhum estado) — `errorCode = OPERATION_NOT_CANCELLABLE` |
| 503    | Serviço temporariamente indisponível. Aguarde `Retry-After` segundos — `errorCode = DISPATCHER_UNAVAILABLE`                                                                                                                                             |

Estes erros seguem o formato `ProblemDetail` (RFC 7807), com o campo `errorCode`. Ver [Erros da API](https://docs.giro.tech/desenvolvedores/api-gtfgts/guias/erros.md).

### Conflito — operação não cancelável (`409`)

Dois casos respondem igual, com o mesmo `errorCode` e o mesmo `detail`:

* a operação já está em processamento ou já foi finalizada;
* a operação é uma averbação, manutenção de garantia ou cancelamento de reserva, que este endpoint nunca cancela.

Para distinguir os dois, use o que você já sabe sobre o `requestId` (a rota pela qual foi submetido) ou o `status` em `GET /api/v1/fgts/operations/{requestId}`. O `type` aponta para a seção [Conflito](https://docs.giro.tech/desenvolvedores/api-gtfgts/guias/erros.md#conflict) dos erros da API.

```json
{
  "type": "https://docs.giro.tech/desenvolvedores/api-gtfgts/guias/erros#conflict",
  "title": "Conflict",
  "status": 409,
  "detail": "Operation is not in a cancellable state: f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "errorCode": "OPERATION_NOT_CANCELLABLE",
  "timestamp": "2026-06-17T12:00:00Z"
}
```

### Operação não encontrada (`404`)

Não existe operação com esse `requestId` dentro do seu escopo. O `type` aponta para a seção [Recurso Não Encontrado](https://docs.giro.tech/desenvolvedores/api-gtfgts/guias/erros.md#resource-not-found).

```json
{
  "type": "https://docs.giro.tech/desenvolvedores/api-gtfgts/guias/erros#resource-not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "No operation found for the given requestId.",
  "errorCode": "OPERATION_NOT_FOUND",
  "timestamp": "2026-06-17T12:00:00Z"
}
```

## Cancela uma operação FGTS por requestId (síncrono)

> Cancela sincronamente a operação identificada pelo \`requestId\`.\
> \*\*Operação síncrona:\*\* o resultado (sucesso ou erro) é devolvido imediatamente na mesma chamada. Não há polling posterior para o cancelamento em si.\
> \*\*Idempotência:\*\* o cancelamento é idempotente — reenviar a mesma requisição para uma operação já cancelada retorna \`409\` (não cancellable), conforme o estado atual no dispatcher.\
> \*\*Restrição:\*\* apenas o originator dono da operação pode cancelá-la; o \`originatorId\` autenticado é enviado internamente ao dispatcher para verificação de posse. Acesso cruzado resulta em \`404\`.\
> \*\*Estados canceláveis:\*\* determinados pelo dispatcher. Operações em estados terminais (\`COMPLETED\`, \`FAILED\`, etc.) retornam \`409 OPERATION\_NOT\_CANCELLABLE\`.\
> \*\*Indisponibilidade temporária:\*\* \`503 Retry-After\`.

```json
{"openapi":"3.0.3","info":{"title":"gtfgts-ingress Public API","version":"0.0.1"},"tags":[{"name":"fgts-operations","description":"Submissão assíncrona de operações FGTS (balance-queries, endorsements, guarantee-maintenances, reserve-cancellations, reserve-value-queries, reserve-protocol-queries, protocol-status-queries), polling de status por `requestId` e cancelamento síncrono de operação. Todas protegidas por JWT do originator."}],"servers":[{"url":"https://ingress.gtfgts.staging.giro.tech","description":"Homologação (testes e validação da integração)"},{"url":"https://gtfgts.giro.tech","description":"Produção (operações reais)"},{"url":"http://localhost:8080","description":"Local (bootRun -Pprofiles=local)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT de originator fornecido pela GTLab no cadastro do originator. Identifica e autoriza o originator em todos os endpoints `/api/v1/**`.\nInclua no header: `Authorization: Bearer <token>`."}}},"paths":{"/api/v1/fgts/operations/{requestId}":{"delete":{"operationId":"cancelOperation","tags":["fgts-operations"],"summary":"Cancela uma operação FGTS por requestId (síncrono)","description":"Cancela sincronamente a operação identificada pelo `requestId`.\n**Operação síncrona:** o resultado (sucesso ou erro) é devolvido imediatamente na mesma chamada. Não há polling posterior para o cancelamento em si.\n**Idempotência:** o cancelamento é idempotente — reenviar a mesma requisição para uma operação já cancelada retorna `409` (não cancellable), conforme o estado atual no dispatcher.\n**Restrição:** apenas o originator dono da operação pode cancelá-la; o `originatorId` autenticado é enviado internamente ao dispatcher para verificação de posse. Acesso cruzado resulta em `404`.\n**Estados canceláveis:** determinados pelo dispatcher. Operações em estados terminais (`COMPLETED`, `FAILED`, etc.) retornam `409 OPERATION_NOT_CANCELLABLE`.\n**Indisponibilidade temporária:** `503 Retry-After`.","responses":{"200":{"description":"Operação cancelada com sucesso.","content":{"application/json":{"schema":{"type":"object","description":"Resposta de cancelamento síncrono de uma operação FGTS. Retornado por `DELETE /api/v1/fgts/operations/{requestId}`.","required":["requestId","status","cancelledAt"],"properties":{"requestId":{"type":"string","description":"Identificador único da operação cancelada."},"status":{"type":"string","enum":["CANCELLED"],"description":"Status fixo `CANCELLED` confirmando o cancelamento."},"cancelledAt":{"type":"string","format":"date-time","description":"Timestamp ISO-8601 de quando o cancelamento foi efetivado."}}}}}},"400":{"description":"Requisição inválida — falha de validação de Bean Validation (campos obrigatórios ausentes, formatos incorretos, CPF com dígitos errados, etc.). O campo `errors` contém um mapa `{ \"campo\": \"mensagem\" }` para cada campo inválido. O campo `title` é sempre `\"Bean validation error\"` e `detail` é sempre `\"One or more fields were invalid. See 'errors' for details.\"`.\nRejeições de regra de negócio também chegam como `400`, com `errorCode` próprio (ex.: `CONTRACT_INSTALLMENTS_MISMATCH`). Quando a rejeição aponta um campo do request, ela traz o mesmo `errors` e o mesmo `detail`; quando não há campo associado, `errors` é omitido e `detail` é o reason phrase do status.","content":{"application/problem+json":{"schema":{"type":"object","description":"Erro estruturado segundo RFC 7807 — Problem Details for HTTP APIs. Campos adicionais `errorCode` (código canônico GTLab estável) e `timestamp` (instante do erro no servidor) são extensões proprietárias. O campo `errors` (mapa campo→mensagem) é incluído nos erros que apontam para um campo do request: validação de Bean Validation (`errorCode: VALIDATION_ERROR`, HTTP 400) e rejeições de regra de negócio que identificam o campo culpado (ex.: `CONTRACT_INSTALLMENTS_MISMATCH`). Nos erros que não têm campo associado (`401`, `403`, `404`, `429`, `500`, `503`, e rejeições de negócio sem campo) o campo `errors` está ausente.","properties":{"type":{"type":"string","format":"uri","description":"URI de referência do tipo de problema."},"title":{"type":"string","description":"Título legível do tipo de problema."},"status":{"type":"integer","format":"int32","description":"HTTP status code do problema."},"detail":{"type":"string","description":"Descrição legível específica desta ocorrência do problema."},"instance":{"type":"string","description":"URI reference (relativa ou absoluta) que identifica esta ocorrência específica do problema. Geralmente o path do endpoint que gerou o erro."},"errorCode":{"type":"string","description":"Código de erro canônico GTLab estável para uso programático."},"timestamp":{"type":"string","format":"date-time","description":"Instante em que o erro ocorreu no servidor (ISO-8601 UTC)."},"errors":{"type":"object","nullable":true,"additionalProperties":{"type":"string"},"description":"Mapa de erros no formato `{ \"campo\": \"mensagem\" }`, onde cada chave nomeia um campo do **request enviado por você**. Presente quando `errorCode` é `VALIDATION_ERROR` (falha de Bean Validation — `@NotBlank`, `@NotNull`, `@Size`, `@Pattern`, etc.) e também em rejeições de regra de negócio que conseguem apontar o campo culpado, como `CONTRACT_INSTALLMENTS_MISMATCH`. Quando presente, `detail` é `\"One or more fields were invalid. See 'errors' for details.\"`. Ausente em erros sem campo associado (`401`, `403`, `404`, `429`, `500`, `503`) e em rejeições de negócio que não se referem a um campo do request."}}}}}},"401":{"description":"Não autenticado — JWT ausente, inválido ou expirado. Autentique-se e inclua o token no header `Authorization: Bearer <token>`.","content":{"application/problem+json":{"schema":{"type":"object","description":"Erro estruturado segundo RFC 7807 — Problem Details for HTTP APIs. Campos adicionais `errorCode` (código canônico GTLab estável) e `timestamp` (instante do erro no servidor) são extensões proprietárias. O campo `errors` (mapa campo→mensagem) é incluído nos erros que apontam para um campo do request: validação de Bean Validation (`errorCode: VALIDATION_ERROR`, HTTP 400) e rejeições de regra de negócio que identificam o campo culpado (ex.: `CONTRACT_INSTALLMENTS_MISMATCH`). Nos erros que não têm campo associado (`401`, `403`, `404`, `429`, `500`, `503`, e rejeições de negócio sem campo) o campo `errors` está ausente.","properties":{"type":{"type":"string","format":"uri","description":"URI de referência do tipo de problema."},"title":{"type":"string","description":"Título legível do tipo de problema."},"status":{"type":"integer","format":"int32","description":"HTTP status code do problema."},"detail":{"type":"string","description":"Descrição legível específica desta ocorrência do problema."},"instance":{"type":"string","description":"URI reference (relativa ou absoluta) que identifica esta ocorrência específica do problema. Geralmente o path do endpoint que gerou o erro."},"errorCode":{"type":"string","description":"Código de erro canônico GTLab estável para uso programático."},"timestamp":{"type":"string","format":"date-time","description":"Instante em que o erro ocorreu no servidor (ISO-8601 UTC)."},"errors":{"type":"object","nullable":true,"additionalProperties":{"type":"string"},"description":"Mapa de erros no formato `{ \"campo\": \"mensagem\" }`, onde cada chave nomeia um campo do **request enviado por você**. Presente quando `errorCode` é `VALIDATION_ERROR` (falha de Bean Validation — `@NotBlank`, `@NotNull`, `@Size`, `@Pattern`, etc.) e também em rejeições de regra de negócio que conseguem apontar o campo culpado, como `CONTRACT_INSTALLMENTS_MISMATCH`. Quando presente, `detail` é `\"One or more fields were invalid. See 'errors' for details.\"`. Ausente em erros sem campo associado (`401`, `403`, `404`, `429`, `500`, `503`) e em rejeições de negócio que não se referem a um campo do request."}}}}}},"404":{"description":"Operação não encontrada — `requestId` inexistente ou não pertence ao originator.","content":{"application/problem+json":{"schema":{"type":"object","description":"Erro estruturado segundo RFC 7807 — Problem Details for HTTP APIs. Campos adicionais `errorCode` (código canônico GTLab estável) e `timestamp` (instante do erro no servidor) são extensões proprietárias. O campo `errors` (mapa campo→mensagem) é incluído nos erros que apontam para um campo do request: validação de Bean Validation (`errorCode: VALIDATION_ERROR`, HTTP 400) e rejeições de regra de negócio que identificam o campo culpado (ex.: `CONTRACT_INSTALLMENTS_MISMATCH`). Nos erros que não têm campo associado (`401`, `403`, `404`, `429`, `500`, `503`, e rejeições de negócio sem campo) o campo `errors` está ausente.","properties":{"type":{"type":"string","format":"uri","description":"URI de referência do tipo de problema."},"title":{"type":"string","description":"Título legível do tipo de problema."},"status":{"type":"integer","format":"int32","description":"HTTP status code do problema."},"detail":{"type":"string","description":"Descrição legível específica desta ocorrência do problema."},"instance":{"type":"string","description":"URI reference (relativa ou absoluta) que identifica esta ocorrência específica do problema. Geralmente o path do endpoint que gerou o erro."},"errorCode":{"type":"string","description":"Código de erro canônico GTLab estável para uso programático."},"timestamp":{"type":"string","format":"date-time","description":"Instante em que o erro ocorreu no servidor (ISO-8601 UTC)."},"errors":{"type":"object","nullable":true,"additionalProperties":{"type":"string"},"description":"Mapa de erros no formato `{ \"campo\": \"mensagem\" }`, onde cada chave nomeia um campo do **request enviado por você**. Presente quando `errorCode` é `VALIDATION_ERROR` (falha de Bean Validation — `@NotBlank`, `@NotNull`, `@Size`, `@Pattern`, etc.) e também em rejeições de regra de negócio que conseguem apontar o campo culpado, como `CONTRACT_INSTALLMENTS_MISMATCH`. Quando presente, `detail` é `\"One or more fields were invalid. See 'errors' for details.\"`. Ausente em erros sem campo associado (`401`, `403`, `404`, `429`, `500`, `503`) e em rejeições de negócio que não se referem a um campo do request."}}}}}},"409":{"description":"Operação não está em estado cancelável (ex.: já `COMPLETED`, `FAILED`, `CANCELLED`).","content":{"application/problem+json":{"schema":{"type":"object","description":"Erro estruturado segundo RFC 7807 — Problem Details for HTTP APIs. Campos adicionais `errorCode` (código canônico GTLab estável) e `timestamp` (instante do erro no servidor) são extensões proprietárias. O campo `errors` (mapa campo→mensagem) é incluído nos erros que apontam para um campo do request: validação de Bean Validation (`errorCode: VALIDATION_ERROR`, HTTP 400) e rejeições de regra de negócio que identificam o campo culpado (ex.: `CONTRACT_INSTALLMENTS_MISMATCH`). Nos erros que não têm campo associado (`401`, `403`, `404`, `429`, `500`, `503`, e rejeições de negócio sem campo) o campo `errors` está ausente.","properties":{"type":{"type":"string","format":"uri","description":"URI de referência do tipo de problema."},"title":{"type":"string","description":"Título legível do tipo de problema."},"status":{"type":"integer","format":"int32","description":"HTTP status code do problema."},"detail":{"type":"string","description":"Descrição legível específica desta ocorrência do problema."},"instance":{"type":"string","description":"URI reference (relativa ou absoluta) que identifica esta ocorrência específica do problema. Geralmente o path do endpoint que gerou o erro."},"errorCode":{"type":"string","description":"Código de erro canônico GTLab estável para uso programático."},"timestamp":{"type":"string","format":"date-time","description":"Instante em que o erro ocorreu no servidor (ISO-8601 UTC)."},"errors":{"type":"object","nullable":true,"additionalProperties":{"type":"string"},"description":"Mapa de erros no formato `{ \"campo\": \"mensagem\" }`, onde cada chave nomeia um campo do **request enviado por você**. Presente quando `errorCode` é `VALIDATION_ERROR` (falha de Bean Validation — `@NotBlank`, `@NotNull`, `@Size`, `@Pattern`, etc.) e também em rejeições de regra de negócio que conseguem apontar o campo culpado, como `CONTRACT_INSTALLMENTS_MISMATCH`. Quando presente, `detail` é `\"One or more fields were invalid. See 'errors' for details.\"`. Ausente em erros sem campo associado (`401`, `403`, `404`, `429`, `500`, `503`) e em rejeições de negócio que não se referem a um campo do request."}}}}}},"500":{"description":"Erro interno inesperado no servidor.","content":{"application/problem+json":{"schema":{"type":"object","description":"Erro estruturado segundo RFC 7807 — Problem Details for HTTP APIs. Campos adicionais `errorCode` (código canônico GTLab estável) e `timestamp` (instante do erro no servidor) são extensões proprietárias. O campo `errors` (mapa campo→mensagem) é incluído nos erros que apontam para um campo do request: validação de Bean Validation (`errorCode: VALIDATION_ERROR`, HTTP 400) e rejeições de regra de negócio que identificam o campo culpado (ex.: `CONTRACT_INSTALLMENTS_MISMATCH`). Nos erros que não têm campo associado (`401`, `403`, `404`, `429`, `500`, `503`, e rejeições de negócio sem campo) o campo `errors` está ausente.","properties":{"type":{"type":"string","format":"uri","description":"URI de referência do tipo de problema."},"title":{"type":"string","description":"Título legível do tipo de problema."},"status":{"type":"integer","format":"int32","description":"HTTP status code do problema."},"detail":{"type":"string","description":"Descrição legível específica desta ocorrência do problema."},"instance":{"type":"string","description":"URI reference (relativa ou absoluta) que identifica esta ocorrência específica do problema. Geralmente o path do endpoint que gerou o erro."},"errorCode":{"type":"string","description":"Código de erro canônico GTLab estável para uso programático."},"timestamp":{"type":"string","format":"date-time","description":"Instante em que o erro ocorreu no servidor (ISO-8601 UTC)."},"errors":{"type":"object","nullable":true,"additionalProperties":{"type":"string"},"description":"Mapa de erros no formato `{ \"campo\": \"mensagem\" }`, onde cada chave nomeia um campo do **request enviado por você**. Presente quando `errorCode` é `VALIDATION_ERROR` (falha de Bean Validation — `@NotBlank`, `@NotNull`, `@Size`, `@Pattern`, etc.) e também em rejeições de regra de negócio que conseguem apontar o campo culpado, como `CONTRACT_INSTALLMENTS_MISMATCH`. Quando presente, `detail` é `\"One or more fields were invalid. See 'errors' for details.\"`. Ausente em erros sem campo associado (`401`, `403`, `404`, `429`, `500`, `503`) e em rejeições de negócio que não se referem a um campo do request."}}}}}},"503":{"description":"Serviço temporariamente indisponível. Aguarde `Retry-After` segundos antes de tentar novamente.","content":{"application/problem+json":{"schema":{"type":"object","description":"Erro estruturado segundo RFC 7807 — Problem Details for HTTP APIs. Campos adicionais `errorCode` (código canônico GTLab estável) e `timestamp` (instante do erro no servidor) são extensões proprietárias. O campo `errors` (mapa campo→mensagem) é incluído nos erros que apontam para um campo do request: validação de Bean Validation (`errorCode: VALIDATION_ERROR`, HTTP 400) e rejeições de regra de negócio que identificam o campo culpado (ex.: `CONTRACT_INSTALLMENTS_MISMATCH`). Nos erros que não têm campo associado (`401`, `403`, `404`, `429`, `500`, `503`, e rejeições de negócio sem campo) o campo `errors` está ausente.","properties":{"type":{"type":"string","format":"uri","description":"URI de referência do tipo de problema."},"title":{"type":"string","description":"Título legível do tipo de problema."},"status":{"type":"integer","format":"int32","description":"HTTP status code do problema."},"detail":{"type":"string","description":"Descrição legível específica desta ocorrência do problema."},"instance":{"type":"string","description":"URI reference (relativa ou absoluta) que identifica esta ocorrência específica do problema. Geralmente o path do endpoint que gerou o erro."},"errorCode":{"type":"string","description":"Código de erro canônico GTLab estável para uso programático."},"timestamp":{"type":"string","format":"date-time","description":"Instante em que o erro ocorreu no servidor (ISO-8601 UTC)."},"errors":{"type":"object","nullable":true,"additionalProperties":{"type":"string"},"description":"Mapa de erros no formato `{ \"campo\": \"mensagem\" }`, onde cada chave nomeia um campo do **request enviado por você**. Presente quando `errorCode` é `VALIDATION_ERROR` (falha de Bean Validation — `@NotBlank`, `@NotNull`, `@Size`, `@Pattern`, etc.) e também em rejeições de regra de negócio que conseguem apontar o campo culpado, como `CONTRACT_INSTALLMENTS_MISMATCH`. Quando presente, `detail` é `\"One or more fields were invalid. See 'errors' for details.\"`. Ausente em erros sem campo associado (`401`, `403`, `404`, `429`, `500`, `503`) e em rejeições de negócio que não se referem a um campo do request."}}}}},"headers":{"Retry-After":{"description":"Segundos recomendados até a próxima tentativa.","schema":{"type":"integer","format":"int64"}}}}}}}}}
```

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
