How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Microsoft Azure Threads API

The Threads API from Microsoft Azure — 16 operation(s) for threads.

Microsoft Azure Threads 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 Threads. 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 26 operations across 16 paths, and defines 34 schemas. It is described by OpenAPI 3.2.0, at version 2020-08-01-preview.

26 operations 16 paths 34 schemas 2 DELETE12 GET1 PATCH11 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 26

Across 16 paths, the API surfaces 26 operations — 2 DELETE, 12 GET, 1 PATCH, 11 POST. Each is listed below with its method, path, parameters, and response codes.

Threads 26
GET
/chat/threads/{chatThreadId}/readReceipts
Microsoft Azure Gets Chat Message Read Receipts For A Thread
microsoftAzureChatthreadListchatreadreceipts 4 params → 200401403429503
POST
/chat/threads/{chatThreadId}/readReceipts
Microsoft Azure Sends A Read Receipt Event To A Thread, On Behalf Of A User
microsoftAzureChatthreadSendchatreadreceipt 2 params body → 200401403429503
POST
/chat/threads
Microsoft Azure Creates A Chat Thread
microsoftAzureChatCreatechatthread 2 params body → 201401403429503
GET
/chat/threads
Microsoft Azure Gets The List Of Chat Threads Of A User
microsoftAzureChatListchatthreads 3 params → 200401403429503
PATCH
/chat/threads/{chatThreadId}
Microsoft Azure Updates A Thread S Properties
microsoftAzureChatthreadUpdatechatthreadproperties 2 params body → 204401403429503
GET
/chat/threads/{chatThreadId}
Microsoft Azure Gets A Chat Thread S Properties
microsoftAzureChatthreadGetchatthreadproperties 2 params → 200401403429503
DELETE
/chat/threads/{chatThreadId}
Microsoft Azure Deletes A Thread
microsoftAzureChatDeletechatthread 2 params → 204401403429503
POST
/threads
Microsoft Azure Post Threads
microsoftAzureCreatethread body → 200
GET
/threads/{threadId}
Microsoft Azure Get Threads Threadid
microsoftAzureGetthread 1 param → 200
POST
/threads/{threadId}
Microsoft Azure Post Threads Threadid
microsoftAzureModifythread 1 param body → 200
DELETE
/threads/{threadId}
Microsoft Azure Delete Threads Threadid
microsoftAzureDeletethread 1 param → 200
GET
/threads/{threadId}/messages
Microsoft Azure Get Threads Threadid Messages
microsoftAzureListmessages 5 params → 200
POST
/threads/{threadId}/messages
Microsoft Azure Post Threads Threadid Messages
microsoftAzureCreatemessage 1 param body → 200
GET
/threads/{threadId}/messages/{messageId}
Microsoft Azure Get Threads Threadid Messages Messageid
microsoftAzureGetmessage 2 params → 200
POST
/threads/{threadId}/messages/{messageId}
Microsoft Azure Post Threads Threadid Messages Messageid
microsoftAzureModifymessage 2 params body → 200
GET
/threads/{threadId}/messages/{messageId}/files
Microsoft Azure Get Threads Threadid Messages Messageid Files
microsoftAzureListmessagefiles 6 params → 200
GET
/threads/{threadId}/messages/{messageId}/files/{fileId}
Microsoft Azure Get Threads Threadid Messages Messageid Files Fileid
microsoftAzureGetmessagefile 3 params → 200
GET
/threads/{threadId}/runs
Microsoft Azure Get Threads Threadid Runs
microsoftAzureListruns 5 params → 200
POST
/threads/{threadId}/runs
Microsoft Azure Post Threads Threadid Runs
microsoftAzureCreaterun 1 param body → 200
GET
/threads/{threadId}/runs/{runId}
Microsoft Azure Get Threads Threadid Runs Runid
microsoftAzureGetrun 2 params → 200
POST
/threads/{threadId}/runs/{runId}
Microsoft Azure Post Threads Threadid Runs Runid
microsoftAzureModifyrun 2 params body → 200
POST
/threads/{threadId}/runs/{runId}/cancel
Microsoft Azure Post Threads Threadid Runs Runid Cancel
microsoftAzureCancelrun 2 params → 200
GET
/threads/{threadId}/runs/{runId}/steps
Microsoft Azure Get Threads Threadid Runs Runid Steps
microsoftAzureListrunsteps 6 params → 200
GET
/threads/{threadId}/runs/{runId}/steps/{stepId}
Microsoft Azure Get Threads Threadid Runs Runid Steps Stepid
microsoftAzureGetrunstep 3 params → 200
POST
/threads/{threadId}/runs/{runId}/submit_tool_outputs
Microsoft Azure Post Threads Threadid Runs Runid Submit Tool Outputs
microsoftAzureSubmittooloutputstorun 2 params body → 200
POST
/threads/runs
Microsoft Azure Post Threads Runs
microsoftAzureCreatethreadandrun body → 200

Schemas 34

The contract defines 34 schemas that model the data the API accepts and returns. The most detailed are ThreadRun (18 properties), RunStep (15 properties), ThreadMessage (10 properties), ChatThreadProperties (7 properties). Each schema is shown below with its type and property counts.

ToolOutput
object
The data provided during a tool outputs submission to resolve pending tool calls and allow the model to continue.
2 properties
RunStepErrorCode
string
Possible error code values attributable to a failed run step.
ChatMessageReadReceipt
object
A chat message read receipt indicates the time a chat message was read by a recipient.
3 properties 3 required
CommunicationIdentifierModel
SendReadReceiptRequest
object
Request payload for sending a read receipt.
1 property 1 required
ChatRetentionPolicy
object
Data retention policy for auto deletion.
1 property 1 required
MessageFile
object
Information about a file attached to an assistant thread message.
4 properties 4 required
ChatMessageReadReceiptsCollection
object
A paged collection of chat message read receipts.
2 properties 1 required
AssistantThreadCreationOptions
object
The details used to create a new assistant thread.
2 properties
ThreadMessage
object
A single message within an assistant thread.
10 properties 8 required
RunError
object
The details of an error as encountered by an assistant thread run.
2 properties 2 required
CommunicationError
ToolDefinition
object
An abstract representation of an input tool definition that an assistant can use.
1 property 1 required
RunStepStatus
string
Possible values for the status of a run step.
RunStatus
string
Possible values for the status of an assistant thread run.
CreateChatThreadRequest
object
Request payload for creating a chat thread.
4 properties 1 required
ChatThreadProperties
object
Chat thread.
7 properties 4 required
ThreadDeletionStatus
object
The status of a thread deletion operation.
3 properties 3 required
MessageRole
string
The possible values for roles attributed to messages in a thread.
RunStepError
object
The error information associated with a failed run step.
2 properties 2 required
MessageContent
object
An abstract representation of a single item of thread message content.
1 property 1 required
RunStepType
string
The possible types of run steps.
RequiredAction
object
An abstract representation of a required action for an assistant thread run to continue.
1 property 1 required
RunStep
object
Detailed information about a single step of an assistant thread run.
15 properties 15 required
ChatThreadItem
object
Summary information of a chat thread.
4 properties 2 required
UpdateChatThreadRequest
object
Request payload for updating a chat thread.
3 properties
ChatThreadsItemCollection
object
Collection of chat threads.
2 properties 1 required
CreateAndRunThreadOptions
object
The details used when creating and immediately running a new assistant thread.
6 properties 1 required
CommunicationErrorResponse
ThreadRun
object
Data representing a single evaluation run of an assistant thread.
18 properties 17 required
ChatParticipant
object
A participant of the chat thread.
4 properties 1 required
CreateChatThreadResult
object
Result of the create chat thread operation.
2 properties
RunStepDetails
object
An abstract representation of the details for a run step.
1 property 1 required
AssistantThread
object
Information about a single thread associated with an assistant.
4 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

microsoft-azure-threads-api-openapi.yml Raw ↑

Other APIs Microsoft Azure publishes across the network.

Microsoft Azure AI Search API
Microsoft Azure Communication Services API
Microsoft Azure Event Grid API
Microsoft Azure Functions API
Microsoft Azure DevOps REST API
Microsoft Azure AI Foundry API
Microsoft Azure Resource JSON Schema
Microsoft Azure JSON-LD Context
Microsoft Azure AccessConnector API
Microsoft Azure AccessControlRecords API
Microsoft Azure AccessPolicies API
Microsoft Azure AccessReviewInstanceAcceptRecommmendations API
Where this information came from

This is an independent, third-party profile of Microsoft Azure Threads 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.