Sources

Create a source

Create a new document ingest source. Returns the source details plus a dedicated api_key for uploading documents into this source.

post/v1/sources

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/sources
  • Auth: HTTP bearer

Request body

namestring required

Source name.

default_schema_idstring uuid

Optional schema ID to apply by default to documents in this source.

Example request

{
  "name": "Invoices Ingest",
  "default_schema_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Response

Source created with a dedicated API key.

idstring uuid required
namestring required
typestring required
status'active' | 'syncing' | 'error' required
document_countinteger
endpointstring

URL path for uploading documents to this source.

created_atstring date-time
api_keystring

Dedicated API key for this source. Only returned at creation time.

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Invoices Ingest",
  "type": "api",
  "status": "completed",
  "document_count": 42,
  "default_schema": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "endpoint": "/v1/sources/abc-123/documents",
  "created_at": "2026-04-25T14:30:00.000Z",
  "api_key": "tlnc_live_src_a1b2c3d4..."
}

Changes

No recorded changes to this operation across all 1 revision of this API.