Create Input

Create a new input source and receive a source-scoped API key. The key is only shown once in the creation response — store it securely.

Create a new source to start ingesting documents. The response includes a source-scoped API key (tlnc_sk_*) that authenticates uploads to this source's endpoint. This key is shown only once — store it securely immediately after creation.

The typical workflow is: create a source, store the returned api_key securely, then use it to authenticate document uploads to the source's endpoint URL. Optionally pass a default_schema_id to automatically apply an extraction schema to all documents ingested through this source.

The response returns the source with status: active, document_count: 0, and the one-time api_key field. The endpoint URL is the path for POST document uploads. The links object includes URLs for the source detail, document list, and dashboard view.

Store the api_key immediately — it cannot be retrieved again. If lost, delete the source and create a new one. The source type defaults to api (programmatic ingestion); use upload for manual file uploads or connector for third-party integrations like Google Drive or SharePoint.

Response

{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "name": "Contract Pipeline",
  "type": "api",
  "status": "active",
  "document_count": 0,
  "default_schema": null,
  "endpoint": "/v1/sources/b2c3d4e5-f6a7-8901-bcde-f12345678901/documents",
  "api_key": "tlnc_sk_live_9a8b7c6d5e4f3g2h1i0j",
  "created_at": "2024-09-14T12:30:00.000Z",
  "links": {
    "self": "/v1/sources/b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "documents": "/v1/sources/b2c3d4e5-f6a7-8901-bcde-f12345678901/documents",
    "dashboard": "https://app.talonic.com/sources/b2c3d4e5-f6a7-8901-bcde-f12345678901"
  }
}

Errors