---
title: "Criar Vínculo"
method: POST
path: "/entries/"
tags: ["Directory"]
---

# Criar Vínculo

`POST /entries/`

Cria um novo vínculo de chave com conta transacional.

### Idempotência
A operação de criação de vínculo é idempotente. Isso significa que é seguro realizar uma nova tentativa em caso de falhas
temporárias, como erros de conexão ou término abrupto de processos. A resposta retornada para uma requisição repetida é
equivalente à resposta dada à primeira requisição processada.

Para garantir a idempotência da operação, a requisição tem um campo `RequestId`. Esse campo é um
[UUID versão 4](https://tools.ietf.org/html/rfc4122#section-4.4) e deve ser único no contexto de um mesmo participante.
O `RequestId` fica associado ao vínculo criado e é usado no cálculo do seu CID (ver seção de reconciliação).

Uma requisição de criação é considerada repetida quando o CID do vínculo contido na requisição já existe no DICT.
Caso seja feita uma requisição com um `RequestId` previamente usado, mas com parâmetros diferentes para o vínculo,
será retornado o erro `RequestIdAlreadyUsed`.

## Response `201`

Created

## Other responses

- `400` — unresolved $ref
- `403` — unresolved $ref
- `503` — unresolved $ref

---

[API](https://skmtc.dev/bacen/apis/dict-api.md) · [All operations](https://skmtc.dev/bacen/apis/dict-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bacen/dict-api/revisions/509ab4f55204/schema)