Microsoft Azure Assistants API is one of 1667 APIs that Microsoft Azure publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Assistants. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, pricing, a JSON-LD context, and a getting-started guide.
This API exposes
34 operations
across 20 paths,
and defines 47 schemas.
It is described by OpenAPI 3.2.0, at version 2020-08-01-preview.
34 operations20 paths47 schemas5 DELETE16 GET13 POST
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.2.0
API Version
2020-08-01-preview
Resource Areas
1
Paths & Operations 34
Across 20 paths, the API surfaces 34 operations — 5 DELETE, 16 GET, 13 POST. Each is listed below with its method, path, parameters, and response codes.
Assistants 34
GET
/assistants
Microsoft Azure Get Assistants
microsoftAzureListassistants4 params→ 200
POST
/assistants
Microsoft Azure Post Assistants
microsoftAzureCreateassistantbody→ 200
GET
/assistants/{assistantId}
Microsoft Azure Get Assistants Assistantid
microsoftAzureGetassistant1 param→ 200
POST
/assistants/{assistantId}
Microsoft Azure Post Assistants Assistantid
microsoftAzureModifyassistant1 parambody→ 200
DELETE
/assistants/{assistantId}
Microsoft Azure Delete Assistants Assistantid
microsoftAzureDeleteassistant1 param→ 200
GET
/assistants/{assistantId}/files
Microsoft Azure Get Assistants Assistantid Files
microsoftAzureListassistantfiles5 params→ 200
POST
/assistants/{assistantId}/files
Microsoft Azure Post Assistants Assistantid Files
microsoftAzureCreateassistantfile1 parambody→ 200
GET
/assistants/{assistantId}/files/{fileId}
Microsoft Azure Get Assistants Assistantid Files Fileid
microsoftAzureGetassistantfile2 params→ 200
DELETE
/assistants/{assistantId}/files/{fileId}
Microsoft Azure Delete Assistants Assistantid Files Fileid
microsoftAzureDeleteassistantfile2 params→ 200
GET
/assistants/{assistant_id}
Microsoft Azure Retrieves An Assistant
microsoftAzureGetAssistant2 params→ 200
DELETE
/assistants/{assistant_id}
Microsoft Azure Delete An Assistant
microsoftAzureDeleteAssistant2 params→ 200
POST
/threads
Microsoft Azure Create A Thread
microsoftAzureCreateThread1 parambody→ 200
GET
/threads/{thread_id}
Microsoft Azure Retrieves A Thread
microsoftAzureGetThread2 params→ 200
POST
/threads/{thread_id}
Microsoft Azure Modifies A Thread
microsoftAzureModifyThread2 paramsbody→ 200
DELETE
/threads/{thread_id}
Microsoft Azure Delete A Thread
microsoftAzureDeleteThread2 params→ 200
GET
/threads/{thread_id}/messages
Microsoft Azure Returns A List Of Messages For A Given Thread
microsoftAzureListMessages6 params→ 200
POST
/threads/{thread_id}/messages
Microsoft Azure Create A Message
microsoftAzureCreateMessage2 paramsbody→ 200
GET
/threads/{thread_id}/messages/{message_id}
Microsoft Azure Retrieve A Message
microsoftAzureGetMessage3 params→ 200
POST
/threads/{thread_id}/messages/{message_id}
Microsoft Azure Modifies A Message
microsoftAzureModifyMessage3 paramsbody→ 200
POST
/threads/runs
Microsoft Azure Create A Thread And Run It In One Request
microsoftAzureCreateThreadAndRun1 parambody→ 200
GET
/threads/{thread_id}/runs
Microsoft Azure Returns A List Of Runs Belonging To A Thread
Microsoft Azure When A Run Has The status: "requires Action" And required Action Type Is submit Tool Outputs, This Endpoint Can Be Used To Submit The Outputs From The Tool Calls Once They Re All Comp…
The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are runObject (18 properties), runStepObject (15 properties), Assistant (10 properties), assistantObject (10 properties). Each schema is shown below with its type and property counts.
listRunsResponse
object
5 properties5 required
modifyRunRequest
object
1 property
runStepObject
object
Represents a step in execution of a run.
15 properties15 required
createRunRequest
object
5 properties2 required
createMessageRequest
object
4 properties2 required
messageContentImageFileObject
object
References an image [File](/docs/api-reference/files) in the content of a message.
2 properties2 required
runStepDetailsToolCallsFunctionObject
object
3 properties3 required
listMessageFilesResponse
object
5 properties6 required
AssistantFileDeletionStatus
object
The status of an assistant file deletion operation.
3 properties3 required
AssistantCreationOptions
object
The request details to use when creating a new assistant.
7 properties1 required
deleteThreadResponse
object
3 properties3 required
modifyMessageRequest
object
1 property
Assistant
object
Represents an assistant that can call the model and use tools.
10 properties10 required
runStepDetailsMessageCreationObject
object
Details of the message creation by the run step.
2 properties2 required
createAssistantFileRequest
object
1 property1 required
assistantToolsFunction
object
2 properties2 required
listAssistantFilesResponse
object
5 properties6 required
createThreadAndRunRequest
object
6 properties2 required
threadObject
object
Represents a thread that contains [messages](/docs/api-reference/messages).
4 properties4 required
assistantToolsCode
object
1 property1 required
AssistantModificationOptions
object
The request details to use when modifying an existing assistant.
7 properties
ToolDefinition
object
An abstract representation of an input tool definition that an assistant can use.
1 property1 required
assistantFileObject
object
A list of [Files](/docs/api-reference/files) attached to an assistant.
4 properties4 required
chatCompletionFunctionParameters
object
The parameters the functions accepts, described as a JSON Schema object. See the [guide](/docs/guides/gpt/function-calling) for examples, and the [JSON Schema…
messageContentTextObject
object
The text content that is part of a message.
2 properties2 required
runStepDetailsToolCallsCodeOutputImageObject
object
2 properties2 required
modifyThreadRequest
object
1 property
submitToolOutputsRunRequest
object
1 property1 required
deleteAssistantFileResponse
object
Deletes the association between the assistant and the file, but does not delete the [File](/docs/api-reference/files) object itself.
3 properties3 required
listRunStepsResponse
object
5 properties5 required
messageContentTextAnnotationsFileCitationObject
object
A citation within the message that points to a specific quote from a specific File associated with the assistant or the message. Generated when the assistant u…
5 properties5 required
runObject
object
Represents an execution run on a [thread](/docs/api-reference/threads).
18 properties18 required
AssistantDeletionStatus
object
The status of an assistant deletion operation.
3 properties3 required
listMessagesResponse
object
5 properties5 required
runToolCallObject
object
Tool call objects
3 properties3 required
runStepDetailsToolCallsCodeObject
object
Details of the Code Interpreter tool call the run step was involved in.
3 properties3 required
runStepDetailsToolCallsCodeOutputLogsObject
object
Text output from the Code Interpreter tool call as part of a run step.
2 properties2 required
assistantToolsRetrieval
object
1 property1 required
messageContentTextAnnotationsFilePathObject
object
A URL for the file that's generated when the assistant used the codeinterpreter tool to generate a file.
5 properties5 required
messageObject
object
Represents a message within a [thread](/docs/api-reference/threads).
10 properties10 required
assistantObject
object
Represents an assistant that can call the model and use tools.
10 properties10 required
runStepDetailsToolCallsObject
object
Details of the tool call.
2 properties2 required
runStepDetailsToolCallsRetrievalObject
object
3 properties3 required
messageFileObject
object
A list of files attached to a message.
4 properties4 required
AssistantFile
object
Information about a file attached to an assistant, as used by tools that can read files.
4 properties4 required
deleteAssistantResponse
object
3 properties3 required
createThreadRequest
object
2 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Microsoft Azure Assistants API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
