> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Models for Assistant API
> Retrieve all available models for use with the Assistant API.
**The Assistants API will be deprecated on 30 April.**
For new projects, we recommend using the [Agents API](/en/developer/agents-api/agent-models). The Agents API provides native Vercel AI SDK compatibility and removes custom transformations.
See the [migration guide](/en/developer/assistants-api/assistant-to-agent-migration) to learn about the differences.
Retrieve the list of models and their ids, available for use with the Assistant API. This endpoint is useful when you want to see which models you can use when creating a temporary assistant.
## Example Request
```javascript theme={null}
const axios = require("axios");
async function getAvailableModels() {
try {
const response = await axios.get("https://api.langdock.com/assistant/v1/models", {
headers: {
Authorization: "Bearer YOUR_API_KEY",
},
});
console.log("Available models:", response.data.data);
} catch (error) {
console.error("Error fetching models:", error);
}
}
```
## Response Format
The API returns a list of available models in the following format:
### Response Fields
Always 'list', indicating the top-level JSON object type.
Array containing available model objects.
Unique identifier of the model (e.g., gpt-5).
Always 'model', indicating the object type.
Unix timestamp (ms) when the model was created.
Region where the model is available (e.g., "eu", "us", "global").
Whether this model supports extended thinking mode.
```json Example response theme={null}
{
"object": "list",
"data": [
{
"id": "gpt-5",
"object": "model",
"created": 1686935735000,
"region": "eu",
"supportsExtendedThinking": false
}
// …other models
]
}
```
## Error Handling
```javascript theme={null}
try {
const response = await axios.get("https://api.langdock.com/assistant/v1/models", {
headers: {
Authorization: "Bearer YOUR_API_KEY",
},
});
} catch (error) {
if (error.response) {
switch (error.response.status) {
case 400:
console.error("Invalid request parameters");
break;
case 500:
console.error("Internal server error");
break;
}
}
}
```
You can use any of these model IDs when creating a temporary Assistant through the assistant API. Simply specify the model ID in the `model` field of your assistant configuration:
```javascript Assistant.js theme={null}
const response = await axios.post("https://api.langdock.com/assistant/v1/chat/completions", {
assistant: {
name: "Custom Assistant",
instructions: "You are a helpful Assistant",
model: "gpt-5", // Specify the model ID here
},
messages: [
{ role: "user", content: "Hello!" },
],
});
```
```bash Assistant.sh theme={null}
curl https://api.langdock.com/assistant/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"assistant": {
"name": "Custom Assistant",
"instructions": "You are a helpful assistant",
"model": "gpt-5"
},
"messages": [
{ "role": "user", "content": "Hello!" }
]
}'
```
## Migrating to Agents API
The new Agents API offers improved compatibility with modern AI SDKs. The models endpoint has identical functionality.
See the equivalent endpoint in the Agents API:
* [Agent Models API](/en/developer/agents-api/agent-models)
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on [API Key Best Practices](/en/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
## OpenAPI
````yaml GET /assistant/v1/models
openapi: 3.0.0
info:
title: Langdock API
version: 3.0.0
servers:
- url: https://api.langdock.com
security:
- bearerAuth: []
paths:
/assistant/v1/models:
get:
tags:
- Assistant
summary: '[Deprecated] Lists the available models'
description: >-
This endpoint is deprecated. Please use /agent/v1/models for new
integrations. Returns a list of models that are available for use with
the API.
parameters: []
responses:
'200':
description: List of available models
content:
application/json:
schema:
type: object
required:
- object
- data
properties:
object:
type: string
enum:
- list
data:
type: array
items:
type: object
required:
- id
- object
- created
- owned_by
properties:
id:
type: string
description: The model identifier
object:
type: string
enum:
- model
description: The object type, which is always "model"
created:
type: integer
format: int64
description: >-
Unix timestamp (in milliseconds) of when the model
was created
owned_by:
type: string
enum:
- system
description: The organization that owns the model
example:
object: list
data:
- id: gpt-5
object: model
created: 1686935735000
owned_by: system
- id: gpt-5-mini
object: model
created: 1686935735000
owned_by: system
'400':
description: Invalid request parameters
content:
application/json:
schema:
type: object
properties:
message:
type: array
items:
type: object
description: Validation error details
'429':
description: Rate limit exceeded
content:
application/json:
schema:
type: object
properties:
message:
type: string
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: Internal Server Error
deprecated: true
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API Key
description: API key as Bearer token. Format "Bearer YOUR_API_KEY"
````