Assistants

AI assistant endpoints

gethttps://app.meingpt.com/api/assistants/v1/

Get available assistants

Retrieves all assistants available to the authenticated user

🔒 ApiKeyAuth

Parameter

ParameterInTypBeschreibung
Authorization*headerstringAPI key for authentication. Use 'Bearer <your-api-key>' format.

Responses

200Successfully retrieved assistants
FeldTypBeschreibung
assistantsArray<object>
500Internal server error
FeldTypBeschreibung
statusstring
messagestring
posthttps://app.meingpt.com/api/assistants/v1/{assistantId}/run

Run an assistant

Executes an assistant with the provided messages and returns the assistant's response with tool calls and reasoning. Alternatively, you can use `multipart/form-data` to include files. In that case, send `messages` as a JSON string and upload files via `files`.

🔒 ApiKeyAuth

Parameter

ParameterInTypBeschreibung
Authorization*headerstringAPI key for authentication. Use 'Bearer <your-api-key>' format.
assistantId*pathstringThe assistant ID

Request Body · application/json

FeldTypBeschreibung
messages*Array<ChatMessage>

Responses

200Assistant executed successfully
FeldTypBeschreibung
textstringThe assistant's response text
modelstringThe model used for generation
messagesArray<object>The assistant's response messages including tool calls and reasoning
usageobject
citationsArray<string>Citations from tool usage
400Bad request - invalid input or missing assistant ID
FeldTypBeschreibung
statusstring
messagestring
403Forbidden - assistant not available
FeldTypBeschreibung
statusstring
messagestring
500Internal server error
FeldTypBeschreibung
statusstring
messagestring

Attaching files to an assistant run

You can attach files to an assistant run. The size limit actually enforced today is 50 MB per file — the 150 MB figure mentioned in parts of the API reference is not the value checked server-side. Check the API reference for the current value if in doubt, since it can change.

Attention

Connectors (e.g. Outlook, SharePoint) are not available on an assistant run via the external API — they only work in interactive chat.

Was this page helpful?