---
title: "POST | Reexecutar um job do IAM por [id]"
slug: "api-v2-post-retry-an-iam-job"
updated: 2026-11-03T14:57:58Z
published: 2026-11-03T14:57:58Z
canonical: "docs.senhasegura.io/api-v2-post-retry-an-iam-job"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# POST | Reexecutar um job do IAM por [id]

## Descrição

Rode novamente um job em segundo plano do IAM que falhou na plataforma Segura™. O job é enfileirado mais uma vez no mesmo registro: seu código de identificação permanece o mesmo, `retry_count` aumenta em um, e o resultado e o erro anteriores são apagados.

Apenas um job no estado `failed` pode ser reexecutado. Para verificar o estado antes, acesse [GET | Listar um job do IAM por [id]](/v4-2/docs/api-v2-get-list-an-iam-job).

---

## Pré-requisitos

- Uma aplicação com a autorização **Users** concedida pelo administrador no A2A, com a permissão do recurso definida como **Leitura e escrita**. Para mais informações, acesse [Como gerenciar autorizações no A2A](/v4-2/docs/how-to-manage-authorizations-in-a2a).
- Um token de acesso OAuth 2.0 válido. Para mais informações, acesse [Como autenticar uma aplicação A2A](/v4-2/docs/how-to-authenticate-an-application-in-a2a).
- O job deve estar no estado `failed` e deve ter sido iniciado pela mesma aplicação ou pelo mesmo usuário que faz esta requisição.

---

## Requisição

`POST` `/api/v2/iam/jobs/{id}/retry`

### Parâmetros de caminho

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | string | Sim | Código de identificação único do job, no formato UUID. **Nota:** este valor é retornado pelo endpoint que iniciou o job. |

A requisição não leva corpo.

---

### Exemplo de requisição

`POST` `{{url}}/api/v2/iam/jobs/019e0a01-b7b8-7062-82dd-43a8aa0ed6f8/retry`

---

## Resposta

```
HTTP/1.1 202 Accepted
Location: /api/v2/iam/jobs/019e0a01-b7b8-7062-82dd-43a8aa0ed6f8
```

O cabeçalho `Location` contém o caminho do job, que é o mesmo job que foi reexecutado.

### Exemplo de corpo da resposta

```
{
    "data": {
        "job": {
            "id": "019e0a01-b7b8-7062-82dd-43a8aa0ed6f8",
            "type": "ldap.test_connection",
            "state": "queued",
            "retry_count": 1,
            "created_at": "2026-05-08 23:52:25",
            "started_at": null,
            "finished_at": null
        }
    },
    "meta": {
        "links": { "self": "/api/v2/iam/jobs/019e0a01-b7b8-7062-82dd-43a8aa0ed6f8" }
    }
}
```

---

## Campos do corpo da resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `data` | object | A requisição aceita. |
| `data.job` | object | Job que foi enfileirado novamente. |
| `data.job.id` | string | Código de identificação único do job, inalterado pela nova execução. |
| `data.job.type` | string | Tipo do job. |
| `data.job.state` | string | Estado do job. Um job reexecutado retorna `queued`. |
| `data.job.retry_count` | integer | Número de vezes que o job foi reexecutado, aumentado em um por esta requisição. |
| `data.job.created_at` | datetime | Data e hora em que o job foi criado pela primeira vez. A nova execução não altera este valor. |
| `data.job.started_at` | datetime | Reiniciado para `null` até que um worker processe o job novamente. |
| `data.job.finished_at` | datetime | Reiniciado para `null` até que o job termine. |
| `meta` | object | Metadados da resposta. |
| `meta.links` | object | Links de navegação para o job. |
| `meta.links.self` | string | Caminho do job. |

              Info

              

A nova execução reaproveita o registro do job, então o resultado da tentativa anterior é perdido. Leia o objeto `error` com [GET | Listar um job do IAM por [id]](/v4-2/docs/api-v2-get-list-an-iam-job) antes de reexecutar, caso a falha anterior ainda seja importante.

---

## Erros

| Código HTTP | Mensagem | Causa possível | Solução |
| --- | --- | --- | --- |
| `401` | `api.auth.unauthorized` | O token de acesso está ausente ou expirou. | Solicite um novo token de acesso. |
| `404` | `api.resource.not_found` | O job não existe, tem mais de 24 horas ou foi iniciado por outro usuário por meio de outra aplicação. | Verifique o código de identificação e envie a requisição com a aplicação ou o usuário que iniciou o job. |
| `409` | `api.job.invalid_transition` | O job não está no estado `failed`. | Leia o job e reexecute-o apenas depois que ele falhar. |
| `429` | `api.rate_limit.exceeded` | O limite de requisições foi excedido. | Reduza a frequência de requisições e tente novamente. |

A plataforma também responde `503 Service Unavailable` (`api.service.unavailable`) quando a fila de workers em segundo plano está cheia e o job não pode ser enfileirado. O corpo da resposta informa em `details.retry_after` o número de segundos a aguardar antes de reenviar a requisição. A partir da versão 4.2.15, a plataforma também envia o mesmo valor no cabeçalho `Retry-After`.

Para mensagens de erros de autenticação e a política de `403` versus `404`, acesse [API v2 - Convenções e comportamentos compartilhados](/v4-2/docs/api-v2-conventions-and-shared-behaviors).