curl --request POST \
  --url https://api.{environment}.corti.app/v2/documents/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-Name: <tenant-name>' \
  --data '{
  "outputLanguage": "<string>",
  "context": [
    {
      "type": "text",
      "text": "<string>"
    }
  ],
  "labels": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "templateRef": {
    "templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "templateVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "overrides": {
      "instructions": {
        "prompt": "<string>"
      },
      "sections": [
        {
          "sectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "generation": {
            "heading": "<string>",
            "instructions": {
              "contentPrompt": "<string>",
              "writingStylePrompt": "<string>",
              "miscPrompt": "<string>"
            },
            "outputSchema": {
              "type": "string",
              "description": "<string>",
              "default": "<string>",
              "enum": [
                "<string>"
              ],
              "pattern": "<string>"
            }
          }
        }
      ]
    }
  }
}'

{
  "document": {
    "name": "<string>",
    "templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "templateVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "outputLanguage": "<string>",
    "stringDocument": {},
    "labels": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ],
    "interactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "structuredDocument": {},
    "sections": [
      {
        "sectionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "heading": "Chief Complaint",
        "labels": [
          {
            "key": "inlineTemplate",
            "value": "true"
          }
        ]
      },
      {
        "sectionId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "heading": "Assessment and Plan",
        "labels": [
          {
            "key": "inlineTemplate",
            "value": "true"
          }
        ]
      }
    ]
  },
  "usageInfo": {
    "creditsConsumed": 123
  }
}

{
  "document": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "templateVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "outputLanguage": "<string>",
    "stringDocument": {},
    "labels": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "interactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "structuredDocument": {},
    "sections": [
      {
        "sectionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "heading": "Chief Complaint",
        "labels": [
          {
            "key": "inlineTemplate",
            "value": "true"
          }
        ]
      },
      {
        "sectionId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "heading": "Assessment and Plan",
        "labels": [
          {
            "key": "inlineTemplate",
            "value": "true"
          }
        ]
      }
    ]
  },
  "usageInfo": {
    "creditsConsumed": 123
  }
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

Guided Documents

Generate a structured document

Generates a structured document using one of three template-supply paths: a stored template reference (optionally with runtime overrides), an ad-hoc assembly of stored sections, or a fully inline dynamic template. Exactly one of templateRef, assemblyTemplate, or dynamicTemplate must be provided. Context can combine different types or reference an interactionId to automatically fetch existing context to pass to the LLM. Note that discarded facts are not passed to the LLM. With the exception of the plain templateRef path (no overrides), every call creates a new auto-generated template aggregate that snapshots the resolved prompts as a drift-proof receipt, persisted for 30 days.

POST

documents

curl --request POST \
  --url https://api.{environment}.corti.app/v2/documents/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-Name: <tenant-name>' \
  --data '{
  "outputLanguage": "<string>",
  "context": [
    {
      "type": "text",
      "text": "<string>"
    }
  ],
  "labels": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "templateRef": {
    "templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "templateVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "overrides": {
      "instructions": {
        "prompt": "<string>"
      },
      "sections": [
        {
          "sectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "generation": {
            "heading": "<string>",
            "instructions": {
              "contentPrompt": "<string>",
              "writingStylePrompt": "<string>",
              "miscPrompt": "<string>"
            },
            "outputSchema": {
              "type": "string",
              "description": "<string>",
              "default": "<string>",
              "enum": [
                "<string>"
              ],
              "pattern": "<string>"
            }
          }
        }
      ]
    }
  }
}'

{
  "document": {
    "name": "<string>",
    "templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "templateVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "outputLanguage": "<string>",
    "stringDocument": {},
    "labels": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ],
    "interactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "structuredDocument": {},
    "sections": [
      {
        "sectionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "heading": "Chief Complaint",
        "labels": [
          {
            "key": "inlineTemplate",
            "value": "true"
          }
        ]
      },
      {
        "sectionId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "heading": "Assessment and Plan",
        "labels": [
          {
            "key": "inlineTemplate",
            "value": "true"
          }
        ]
      }
    ]
  },
  "usageInfo": {
    "creditsConsumed": 123
  }
}

{
  "document": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "templateVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "outputLanguage": "<string>",
    "stringDocument": {},
    "labels": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "interactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "structuredDocument": {},
    "sections": [
      {
        "sectionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "heading": "Chief Complaint",
        "labels": [
          {
            "key": "inlineTemplate",
            "value": "true"
          }
        ]
      },
      {
        "sectionId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "heading": "Assessment and Plan",
        "labels": [
          {
            "key": "inlineTemplate",
            "value": "true"
          }
        ]
      }
    ]
  },
  "usageInfo": {
    "creditsConsumed": 123
  }
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

{
  "requestid": "<string>",
  "status": 123,
  "type": "<string>",
  "detail": "<string>",
  "validationErrors": [
    {}
  ]
}

Authorizations

Authorization

string

header

required

Input your token

Headers

Tenant-Name

string

required

Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

Example:

"base"

X-Corti-Retention-Policy

enum<string>

Pass the optional X-Corti-Retention-Policy: none header to generate and return the document without saving it to the database. The response will be 200 with GuidedDocumentsCreateEphemeralResponse. Without the header the document is saved and the response is 201 with GuidedDocumentsCreateResponse.

Available options:

none

Body

application/json

templateRef
assemblyTemplate
dynamicTemplate

Generate a document using a stored template. Optionally supply runtime overrides to patch instructions or sections without mutating the base template. At least one of context or interactionId must be supplied as input context for the model.

outputLanguage

string

required

The language in which the document will be generated as a BCP 47 tag.

templateRef

object

required

Reference an existing stored template, optionally with overrides.

Show child attributes

context

(CommonTextContext · object | CommonTranscriptContext · object | CommonFactsContext · object)[]

Ordered list of context items the model reasons over. Each item is one of text, a transcript (with optional metadata and segments), or a single fact. Items are interleaved by timestamps where present on transcript segments; otherwise array order is preserved.

CommonTextContext
CommonTranscriptContext
CommonFactsContext

Show child attributes

interactionId

string<uuid>

When supplied, all facts and transcripts already attached to the referenced interaction are passed implicitly as input context. Facts with isDiscarded: true are not passed on.

labels

object[]

Key/value labels attached to the document. Used for filtering in the LIST /documents endpoint.

Show child attributes

Response

OK — document was generated but not saved (retention policy none).

Response when a document is generated but not saved (retention policy none).

document

object

required

A generated document that was not saved to the database.

Show child attributes

usageInfo

object

required

Credits consumed for this request.

Show child attributes

Corti Models APIs

Agentic APIs

Web Socket APIs

REST APIs

Admin APIs

Errors

Agentic APIs v1 (deprecated)

Generate a structured document

Authorizations

Headers

Body

Response