Creates a model response for a given Assistant.
Parameter | Type | Required | Description |
---|---|---|---|
assistantId | string | One of assistantId/assistant required | ID of an existing assistant to use |
assistant | object | One of assistantId/assistant required | Configuration for a new assistant |
messages | array | Yes | Array of message objects with role and content |
output | object | No | Structured output format specification |
messages
array should contain:
role
(required) - One of: “user”, “assistant”, or “tool”content
(required) - The message content as a stringattachmentIds
(optional) - Array of UUID strings identifying attachments for this messagename
(required) - Name of the assistant (max 64 chars)instructions
(required) - System instructions (max 16384 chars)description
- Optional description (max 256 chars)temperature
- Temperature between 0-1model
- Model ID to use (see Available Models for options)capabilities
- Enable features like web search, data analysis, image generationactions
- Custom API integrationsvectorDb
- Vector database connectionsknowledgeFolderIds
- IDs of knowledge folders to useattachmentIds
- Array of UUID strings identifying attachments to useoutput
parameter:
Field | Type | Description |
---|---|---|
type | ”object” | “array” | “enum” | The type of structured output |
schema | object | JSON Schema definition for the output (for object/array types) |
enum | string[] | Array of allowed values (for enum type) |
output
parameter behavior depends on the specified type:
type: "object"
with no schema: Forces the response to be a single JSON object (no specific structure)type: "object"
with schema: Forces the response to match the provided JSON Schematype: "array"
with schema: Forces the response to be an array of objects matching the provided schematype: "enum"
: Forces the response to be one of the values specified in the enum
arrayattachmentId
for each file, which you can then include in the attachmentIds
array in your assistant or message configuration.
429 Too Many Requests
response.
Please note that the rate limits are subject to change, refer to this documentation for the most up-to-date information.
In case you need a higher rate limit, please contact us at support@langdock.com.
result
array contains the message exchange between user and assistant, including any tool calls that were made. This is always present in the response.
output
parameter, the response will also include an output
field. The type of this field depends on the requested output format:
output.type
was “object”: Returns a JSON object (with schema validation if schema was provided)output.type
was “array”: Returns an array (with schema validation if schema was provided)output.type
was “enum”: Returns a string matching one of the provided enum valuesAPI key as Bearer token. Format "Bearer YOUR_API_KEY"
Successful chat completion
The response is of type object
.