Docs

Reference of the REST API and the MCP server for registered users.

API

Create a key in Connections, send a job, read its status, download the result.

OpenAPI description (YAML)

API keys →

MCP

Add the Orisigil server to an MCP client and authorize it with your account.

MCP server address: https://orisigil.com/mcp

MCP applications →

Authentication

Send an API key in the header Authorization: Bearer <key>. Create keys in Connections. Each key has the permissions sign, read and download.

Sign a file in three requests

# 1. Upload one file (multipart field "file")
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" \
  -F file=@image.jpg https://orisigil.com/api/v1/assets

# 2. Create a batch of signing jobs (202 Accepted)
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" \
  -H "Idempotency-Key: 7d1c3f62-run-42" -H "Content-Type: application/json" \
  -d '{"asset_ids":["<asset id>"],"options":{"creation_method":"ai_generated","tool":"Model X"}}' \
  https://orisigil.com/api/v1/signing-batches

# 3. Read the job; download the result when it is completed
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" https://orisigil.com/api/v1/signing-jobs/<job id>
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" -o signed.jpg \
  https://orisigil.com/api/v1/signing-jobs/<job id>/result

Errors

Errors have a stable error_code. A file above the limit gives 413 file_too_large with max_size_bytes. A repeated Idempotency-Key with a different request gives 409 idempotency_conflict.