🚀 Simplify your work by integrating Haufe Copilot via API
Chat Completions

Stream a chat completion

Streams an assistant response by sending one or more user messages. Returns an NDJSON stream.

POST/v1/chat/completions/stream

Authorization

APIKeyHeader
api-key<token>

In: header

Query Parameters

thread_id?|null

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/chat/completions/stream" \  -H "Content-Type: application/json" \  -d '{    "assistant_id": "a1b2c3d4-5678-9abc-def0-1234567890ab",    "messages": [      {        "content": "Welche Kündigungsfristen gelten während der Probezeit?",        "role": "user"      }    ],    "user_id": "f8e7d6c5-4321-fedc-ba98-765432109876"  }'
{  "created_at": "2025-03-15T09:13:02.654321Z",  "delta": {    "content": "Während der Probezeit beträgt die Kündigungsfrist ",    "role": "assistant",    "sources": []  },  "message_id": "5e6f7081-9012-def0-1234-556677889900",  "thread_id": "1a2b3c4d-5678-9abc-def0-112233445566"}

{  "error_code": "incorrect_stack_ending",  "detail": "The last message in the stack must be a user, tool, or system message."}

{  "error_code": "unauthorized",  "detail": "Missing or invalid API key"}
{  "error_code": "attachment_access_forbidden",  "detail": "You do not have permission to access this attachment."}
{  "error_code": "assistant_not_found",  "detail": "Assistant not found"}

{  "error_code": "conflict",  "detail": "Conflict - File is infected with a virus or it's still being processed"}

{  "error_code": "attachment_not_unique",  "detail": "A thread can contain only a single attachment."}

{  "message": "Rate limit exceeded!"}

{  "error_code": "internal_server_error",  "detail": "Internal Server Error"}
{  "error_code": "attachment_document_not_reachable",  "detail": "The file attachment service does not respond as expected. Please try again later."}
{  "error_code": "internal_service_error",  "detail": "An internal service required for processing the request is currently unavailable. Please try again later."}