---
title: "POST Sign file"
method: POST
path: "/api/files/sign"
---

# POST Sign file

`POST /api/files/sign`

Assina um documento via API com a conta de um dos usuários cadastrados.

Esta assinatura é indicada para usuários que possuam certificado digital cadastrado na plataforma. Neste caso, o sistema irá utilizar o certificado da conta informada no processo de assinatura.

A assinatura via API é uma assinatura invisível, o sistema não vai inserir representações gráficas da assinatura no documento, apenas realizar a assinatura eletrônica que poderá ser validada posteriormente via ITI.

Para realizar o processo é necessário definir a página e a posição da assinatura visual, que vai conter os dados do signatário e do seu certificado.

## Request body

- object
  - `document_key` string, required — Document Key do arquivo que será assinado via API, deve ser da empresa para o qual o token foi enviado
  - `page` integer — Página na qual a assinatura será inserida. Não obrigatório quando rubric for true.
  - `user_id` integer — Usuário para assinar o documento, caso não seja informado o sistema vai assinar pelo administrador da empresa
  - `xPos` number, float, required — Posição no eixo X no documento onde a assinatura será inserida
  - `yPos` number, float, required — Posição no eixo Y no documento onde a assinatura será inserida
  - `rubric` boolean — Quando definido como True, todas as páginas do documento serão assinadas na posição especificada, não sendo necessário fornecer o campo "page"
  - `editablevalidate` integer — Tipo de validação/QR Code aplicado ao documento.

## Response `200`

200

- object
  - `message` string — Mensagem de confirmação retornada pela API.
  - `file_url` string — URL para download do documento assinado.

---

[API](https://skmtc.net/plugsign/apis/endpoints-manuais.md) · [All operations](https://skmtc.net/plugsign/apis/endpoints-manuais/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plugsign/endpoints-manuais/revisions/41e10c7c691b/schema)