Skip to main content
POST
/
api
/
v1
/
dev
/
render
/
markdown
Render a document from Extended Markdown (temporary)
curl --request POST \
  --url https://api.autype.com/api/v1/dev/render/markdown \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "content": "# Hello ${companyName}\n\nThis is a **professional** document.\n\n## Features\n\n- Item 1\n- Item 2\n",
  "document": {
    "type": "pdf",
    "size": "A4",
    "orientation": "portrait"
  },
  "variables": {
    "name": "Acme Inc",
    "date": "2024-01-01"
  },
  "abbreviations": {
    "API": "Application Programming Interface"
  },
  "defaults": {},
  "citations": [
    {}
  ],
  "style": {},
  "webhook": {
    "webhookUrl": "https://example.com/webhook",
    "webhookAuth": {
      "headerName": "X-API-Key",
      "headerValue": "my-secret-key",
      "basicAuthUsername": "user",
      "basicAuthPassword": "pass"
    }
  }
}
'
{
  "jobId": "<string>",
  "status": "PENDING",
  "format": "PDF",
  "creditCost": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "downloadUrl": "<string>",
  "filename": "<string>",
  "error": "<string>",
  "completedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
X-API-Key
string
header
required

API Key (starts with ak_...)

Query Parameters

​
strict
boolean

Enable strict validation mode (validates anchors, references, citations, abbreviations)

Body

application/json
​
content
string
required

Extended Markdown content. Will be converted to document sections automatically. Supports all Autype extended Markdown syntax (directives, charts, math, etc.)

Example:

"# Hello ${companyName}\n\nThis is a **professional** document.\n\n## Features\n\n- Item 1\n- Item 2\n"

​
document
object
required

Document settings (page size, margins, orientation, metadata). Must include "type" field.

Example:
{
  "type": "pdf",
  "size": "A4",
  "orientation": "portrait"
}
​
variables
object
Example:
{ "name": "Acme Inc", "date": "2024-01-01" }
​
abbreviations
object

Abbreviations map. Keys are abbreviations, values are full text

Example:
{
  "API": "Application Programming Interface"
}
​
defaults
object

Default styles and formatting options (fontFamily, fontSize, styles, header, footer, etc.)

​
citations
object[]

Citations array (CSL-JSON format) for bibliography

​
style
object

Style configuration for the document

​
webhook
object

Optional webhook configuration. Receives a POST when the job completes or fails.

Response

Render job created

​
jobId
string
required

Render job ID for status polling

​
status
enum<string>
required
Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
​
format
enum<string>
required
Available options:
PDF,
DOCX,
ODT
​
creditCost
number
required

Credit cost for this render job

​
createdAt
string<date-time>
required
​
downloadUrl
string

Autype API download URL with signed token (only when completed). Supports direct browser download.

​
filename
string

Filename for download

​
error
string

Error message if failed

​
completedAt
string<date-time>