Openi DeveloperDeveloper
Items

Solicitar reconexão

Pede uma nova autorização do usuário para um item existente, sem criar outro item.

Use quando o consentimento de um item expirou ou foi negado, ou quando o link de autorização venceu. O item volta a pedir ação do usuário e emite um novo auth.authUrl / auth.consentUrl.

Endpoint

POST /v1/items/:id/request-reconnect

Parâmetros da URL:

  • id (string, obrigatório): ID do item

Corpo (opcional):

  • parameters (object): novos parâmetros de conexão (ex.: { "cpf": "111.444.777-35" }), validados pelas rules do conector. Omita para reaproveitar os atuais.

Exemplo

curl -X POST https://of.openi.com.br/v1/items/$ITEM_ID/request-reconnect \
  -H "Authorization: Bearer $OPENI_API_KEY"

Resposta de sucesso (200):

{ "status": "success" }

Depois, consulte Buscar Item (ou aguarde o webhook ITEM_WAITING_USER_INPUT) e envie o usuário para a nova URL de autorização.

Erros

StatusCausa
400A última execução teve erro de login: o usuário precisa atualizar os parâmetros de conexão antes. Envie parameters corrigidos.
400parameters não passam nas rules do conector.
404Item inexistente ou de outra aplicação.

Sandbox

No sandbox, o link de consentimento vale uma hora e aceita uma única decisão. Depois disso, chame este endpoint para emitir um novo.

On this page