Document Generation API

This page documents the REST API endpoints for creating, retrieving, regenerating, and updating documents produced by AI Employees.

All endpoints are prefixed with /api/document-generation/{ai_employee_id}/.

Create Document

Submit a document generation request.

Headers

Request Body

Example

curl -X POST https://your-instance.ema.co/api/document-generation/<ai_employee_id>/documents \
 -H "Authorization: Bearer <access_token>" \
 -H "Content-Type: application/json" \
 -d '{
 "persona_id": "<persona-uuid>",
 "input": {
 "topic": "Q4 2025 Sales Summary",
 "data_source": "salesforce",
 "date_range": "2025-10-01 to 2025-12-31"
 }
 }'

Response

Retrieve Document

Retrieve the current status and content of a document. Use this endpoint to poll for completion.

Headers

Request Body

Example

curl -X POST https://your-instance.ema.co/api/document-generation/<ai_employee_id>/documents/retrieve \
 -H "Authorization: Bearer <access_token>" \
 -H "Content-Type: application/json" \
 -d '{
 "document_id": "<document-uuid>"
 }'

Response

Polling Pattern

# Poll every 5 seconds until status is COMPLETED or FAILED
while true; do
 RESPONSE=$(curl -s -X POST https://your-instance.ema.co/api/document-generation/<ai_employee_id>/documents/retrieve \
 -H "Authorization: Bearer <access_token>" \
 -H "Content-Type: application/json" \
 -d '{"document_id": "<document-uuid>"}')

 STATUS=$(echo $RESPONSE | jq -r '.status')

 if [ "$STATUS" = "COMPLETED" ] || [ "$STATUS" = "FAILED" ]; then
 echo $RESPONSE | jq .
 break
 fi

 echo "Status: $STATUS. Waiting..."
 sleep 5
done

Regenerate Document (Preview)

Regenerate a document without replacing the original. This creates a preview that can be reviewed before finalizing.

Headers

Request Body

Example

curl -X POST https://your-instance.ema.co/api/document-generation/<ai_employee_id>/documents/regenerate \
 -H "Authorization: Bearer <access_token>" \
 -H "Content-Type: application/json" \
 -d '{
 "document_id": "<document-uuid>",
 "input": {
 "topic": "Q4 2025 Sales Summary - Revised",
 "include_forecast": true
 }
 }'

Response

Update Document

Finalize changes to a document (e.g., after reviewing a preview).

Headers

Request Body

Example

curl -X POST https://your-instance.ema.co/api/document-generation/<ai_employee_id>/documents/update \
 -H "Authorization: Bearer <access_token>" \
 -H "Content-Type: application/json" \
 -d '{
 "document_id": "<document-uuid>",
 "content": "Updated document content here..."
 }'

Document Status Values

Related

• Document Generation Overview -- Concepts and lifecycle
• AI Employee API -- AI Employee management
• Miscellaneous APIs -- File upload and pre-signed URL endpoints