Integration APIs
Assistants API
Use our OpenAI-compatible Assistants API to build conversational assistants.
POST
Assistants API
Pathors provides OpenAI-compatible Assistants API endpoints for building assistant experiences. This interface follows a subset of the OpenAI Assistants API specification.
Supported Features
Currently, the Assistants API supports the following operations:
- Retrieving assistants (your project acts as the assistant)
- Creating threads
- Adding messages to threads
- Running assistants on threads
- Creating threads and running assistants in one call
Note: Some OpenAI Assistants API features are not yet supported, including streaming responses and structured tool outputs.
Base URL
Authentication
All Assistants API requests require authentication using an API key.
Available Endpoints
Assistants
Method | Endpoint | Description |
---|---|---|
GET | /v1/assistants/{assistant_id} | Retrieve an assistant |
GET | /v1/assistants | List assistants |
Threads
Method | Endpoint | Description |
---|---|---|
POST | /v1/threads | Create a thread |
GET | /v1/threads/{thread_id} | Retrieve a thread |
Messages
Method | Endpoint | Description |
---|---|---|
POST | /v1/threads/{thread_id}/messages | Create a message |
GET | /v1/threads/{thread_id}/messages | List messages |
GET | /v1/threads/{thread_id}/messages/{message_id} | Retrieve a message |
Runs
Method | Endpoint | Description |
---|---|---|
POST | /v1/threads/{thread_id}/runs | Create a run |
GET | /v1/threads/{thread_id}/runs/{run_id} | Retrieve a run |
POST | /v1/threads/runs | Create a thread and run in one operation |
Example Usage
Basic Conversational Flow
Error Responses
Status Code | Description |
---|---|
400 | Invalid request body |
401 | Invalid authentication |
500 | Internal server error |
Setup Guide
- Enable the API integration in your Pathors project settings
- Generate an API key in your project’s integration settings
- Use the API key in the Authorization header for your requests