Skip to content
Soteriaa
THE SAME MAKER. YOUR OWN WORKFLOW.

Documents, without the clicking.

Discover a template, generate a document and download the result from your own tools. The API and MCP share the website’s templates, account and credits.

Create a connection ↗View template catalogue

Early access: scoped tokens

In My documents, create a connection and copy its token. Tokens expire after 90 days and can be revoked. Choose read-only access or allow editing and generation.

The initial MCP connection uses bearer tokens. It works with clients that support custom authorization headers. A one-click ChatGPT connection requires the OAuth consent integration to be configured and verified; that is not advertised as available yet.

REST API

Base: https://www.soteriaa.com/api/v1/maker
Authorization: Bearer YOUR_CONNECTION_TOKEN
Content-Type: application/json

GET  /templates
GET  /usage
GET  /documents
GET  /documents/{id}
POST /generate
POST /documents
GET  /jobs/{requestId}
GET  /documents/{id}/export?format=docx

Generate a document

{
  "templateId": "meeting-minutes",
  "requestId": "a-new-UUID-for-this-generation",
  "instructions": "Meeting: 9 September. Attendees: Jo and Sam. Decision: launch the pilot. Sam owns the checklist, due Friday."
}

POST this object to /generate. The response includes document.id, document.content, document.version, jobId and credits. Generation is synchronous. If a connection times out, read the job status before starting again. An identical request ID returns the original result; changing its inputs is rejected.

Failed jobs return their reservation. Abandoned jobs are recovered on a later generation request after ten minutes.

MCP

{
  "mcpServers": {
    "soteriaa": {
      "url": "https://www.soteriaa.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_CONNECTION_TOKEN"
      }
    }
  }
}

Streamable HTTP, stateless. Tools: list_templates, get_usage, list_documents, get_document, generate_document, save_document and export_document. Exports return a base64 file resource. Keep tokens in secret configuration, never prompts or shared files.

Inputs and costs

  • Instructions: 20,000 characters. Edited document: 100,000 characters.
  • Image/PDF reconstruction: PNG, JPEG, WebP or PDF; base64 in an image object with data and mediaType.
  • Standard generation: 1 credit. Reconstruction: 3. Presentation: 5.
  • Presentations: up to ten slides. Dense content should be exported as Word or PDF.
  • Manual saving and repeat exports: no credits.
  • General and specialist generation use your free account allowance; no purchaseId is required.

Errors

401 INVALID_TOKEN — authenticate or replace the connection
402 INSUFFICIENT_CREDITS / PURCHASE_REQUIRED — no generation started
403 SCOPE_REQUIRED / READ_ONLY — missing permission
404 DOCUMENT_NOT_FOUND — document is not in this account
409 IDEMPOTENCY_CONFLICT / VERSION_CONFLICT — reconcile the request or saved version
413 INPUT_TOO_LARGE — reduce request size
502 GENERATION_FAILED — reservation returned
503 GENERATION_UNAVAILABLE / STORAGE_UNAVAILABLE — service unavailable

Private by default

Connections are restricted to an account or company workspace. Removing workspace membership invalidates its connections. Documents are data: tools cannot execute embedded instructions, send email or monitor an inbox. Your client decides what to do with downloaded files.