{ "info": { "_postman_id": "8e1e5d0b-0d4d-4c86-a6d4-bf7c0340d1bb", "name": "Mistral AI Agents Chat Completions API", "description": "The Mistral AI Agents API provides a dedicated framework for building agentic applications. It complements the Chat Completion API by enabling AI agents to handle complex tasks, maintain context across interactions, and coordinate multiple actions. Developers can create agents with specific configurations, tools, and instructions, making it suitable for enterprise-grade agentic platforms and multi-step workflow automation.\n\nContact Support:\n Name: Mistral AI Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T02:14:34.000Z", "updatedAt": "2026-07-28T02:14:34.000Z", "lastUpdatedBy": "35240", "uid": "35240-8e1e5d0b-0d4d-4c86-a6d4-bf7c0340d1bb" }, "item": [ { "name": "chat", "item": [ { "name": "completions", "item": [ { "name": "Create chat completion", "id": "12b31d15-7f43-427e-a128-d324d73a307e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n },\n {\n \"role\": \"tool\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n }\n ],\n \"temperature\": 0.7,\n \"top_p\": 1,\n \"max_tokens\": \"\",\n \"stream\": false,\n \"stop\": \"\",\n \"random_seed\": \"\",\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tools\": [\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"description\": \"\",\n \"parameters\": {}\n }\n },\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"description\": \"\",\n \"parameters\": {}\n }\n }\n ],\n \"tool_choice\": \"any\",\n \"presence_penalty\": 0,\n \"frequency_penalty\": 0,\n \"safe_prompt\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/chat/completions", "host": [ "{{baseUrl}}" ], "path": [ "chat", "completions" ] }, "description": "Creates a model response for the given chat conversation. The endpoint accepts a list of messages comprising a conversation and returns a model-generated message as a response. Supports multi-turn conversations, function calling, JSON mode, and streaming." }, "response": [ { "id": "49a40d7e-660d-4d14-bfee-3cb59acc1a43", "name": "Successful chat completion response", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n },\n {\n \"role\": \"tool\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n }\n ],\n \"temperature\": 0.7,\n \"top_p\": 1,\n \"max_tokens\": \"\",\n \"stream\": false,\n \"stop\": \"\",\n \"random_seed\": \"\",\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tools\": [\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"description\": \"\",\n \"parameters\": {}\n }\n },\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"description\": \"\",\n \"parameters\": {}\n }\n }\n ],\n \"tool_choice\": \"any\",\n \"presence_penalty\": 0,\n \"frequency_penalty\": 0,\n \"safe_prompt\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/chat/completions", "host": [ "{{baseUrl}}" ], "path": [ "chat", "completions" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"object\": \"chat.completion\",\n \"created\": \"\",\n \"model\": \"\",\n \"choices\": [\n {\n \"index\": \"\",\n \"message\": {\n \"role\": \"system\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n },\n \"finish_reason\": \"tool_calls\"\n },\n {\n \"index\": \"\",\n \"message\": {\n \"role\": \"user\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n },\n \"finish_reason\": \"model_length\"\n }\n ],\n \"usage\": {\n \"prompt_tokens\": \"\",\n \"completion_tokens\": \"\",\n \"total_tokens\": \"\"\n }\n}", "createdAt": "2026-07-28T02:14:35.000Z", "updatedAt": "2026-07-28T02:14:35.000Z", "uid": "35240-49a40d7e-660d-4d14-bfee-3cb59acc1a43" }, { "id": "043eb7e5-cf24-4f28-b0c5-2469256eb678", "name": "Bad request due to invalid parameters", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n },\n {\n \"role\": \"tool\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n }\n ],\n \"temperature\": 0.7,\n \"top_p\": 1,\n \"max_tokens\": \"\",\n \"stream\": false,\n \"stop\": \"\",\n \"random_seed\": \"\",\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tools\": [\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"description\": \"\",\n \"parameters\": {}\n }\n },\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"description\": \"\",\n \"parameters\": {}\n }\n }\n ],\n \"tool_choice\": \"any\",\n \"presence_penalty\": 0,\n \"frequency_penalty\": 0,\n \"safe_prompt\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/chat/completions", "host": [ "{{baseUrl}}" ], "path": [ "chat", "completions" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\",\n \"type\": \"\",\n \"code\": \"\"\n}", "createdAt": "2026-07-28T02:14:35.000Z", "updatedAt": "2026-07-28T02:14:35.000Z", "uid": "35240-043eb7e5-cf24-4f28-b0c5-2469256eb678" }, { "id": "afe0eb88-9fbe-499a-8fd5-f0f94f600327", "name": "Unauthorized due to missing or invalid API key", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n },\n {\n \"role\": \"tool\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n }\n ],\n \"temperature\": 0.7,\n \"top_p\": 1,\n \"max_tokens\": \"\",\n \"stream\": false,\n \"stop\": \"\",\n \"random_seed\": \"\",\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tools\": [\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"description\": \"\",\n \"parameters\": {}\n }\n },\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"description\": \"\",\n \"parameters\": {}\n }\n }\n ],\n \"tool_choice\": \"any\",\n \"presence_penalty\": 0,\n \"frequency_penalty\": 0,\n \"safe_prompt\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/chat/completions", "host": [ "{{baseUrl}}" ], "path": [ "chat", "completions" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\",\n \"type\": \"\",\n \"code\": \"\"\n}", "createdAt": "2026-07-28T02:14:35.000Z", "updatedAt": "2026-07-28T02:14:35.000Z", "uid": "35240-afe0eb88-9fbe-499a-8fd5-f0f94f600327" }, { "id": "4b76808a-6780-4dad-99c2-53cd6d3e86d2", "name": "Rate limit exceeded", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"model\": \"\",\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n },\n {\n \"role\": \"tool\",\n \"content\": \"\",\n \"tool_calls\": [\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"arguments\": \"\"\n }\n }\n ],\n \"tool_call_id\": \"\"\n }\n ],\n \"temperature\": 0.7,\n \"top_p\": 1,\n \"max_tokens\": \"\",\n \"stream\": false,\n \"stop\": \"\",\n \"random_seed\": \"\",\n \"response_format\": {\n \"type\": \"json_object\"\n },\n \"tools\": [\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"description\": \"\",\n \"parameters\": {}\n }\n },\n {\n \"type\": \"function\",\n \"function\": {\n \"name\": \"\",\n \"description\": \"\",\n \"parameters\": {}\n }\n }\n ],\n \"tool_choice\": \"any\",\n \"presence_penalty\": 0,\n \"frequency_penalty\": 0,\n \"safe_prompt\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/chat/completions", "host": [ "{{baseUrl}}" ], "path": [ "chat", "completions" ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\",\n \"type\": \"\",\n \"code\": \"\"\n}", "createdAt": "2026-07-28T02:14:35.000Z", "updatedAt": "2026-07-28T02:14:35.000Z", "uid": "35240-4b76808a-6780-4dad-99c2-53cd6d3e86d2" } ], "createdAt": "2026-07-28T02:14:35.000Z", "updatedAt": "2026-07-28T02:14:35.000Z", "uid": "35240-12b31d15-7f43-427e-a128-d324d73a307e" } ], "id": "1f0c9a67-4628-4e2b-ac0b-66b92a317950", "createdAt": "2026-07-28T02:14:35.000Z", "updatedAt": "2026-07-28T02:14:35.000Z", "uid": "35240-1f0c9a67-4628-4e2b-ac0b-66b92a317950" } ], "id": "b79f23d2-df94-4bf9-9f6d-9754c12b1d44", "createdAt": "2026-07-28T02:14:35.000Z", "updatedAt": "2026-07-28T02:14:35.000Z", "uid": "35240-b79f23d2-df94-4bf9-9f6d-9754c12b1d44" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.mistral.ai/v1" } ] }