# Azure AI API > Azure AI API on Apizie: 42 endpoints (Gets a list of agents that were previously created., Creates a new agent., Retrieves an existing agent., Modifies an existing agent., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month. - Project key: `cloud:azure-ai-aiagents` - Category: Cloud - Status: byok - Source: https://learn.microsoft.com/rest/api/azure/ - Page: https://zieapi.vercel.app/api/cloud/azure-ai-aiagents - OpenAPI: https://zieapi.vercel.app/api/cloud/azure-ai-aiagents/openapi.json ## Endpoints ### Gets a list of agents that were previously created. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/list-agents` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | limit | integer | no | A limit on the number of objects to be returned on one page. Limit can range between 1 and 100, and the default is 20. | | order | string | no | Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. | | after | string | no | A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and… | | before | string | no | A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and… | ### Creates a new agent. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/create-agent` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | body | object | yes | JSON request body | ### Retrieves an existing agent. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/get-agent` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | assistantId | string | yes | Identifier of the agent. | ### Modifies an existing agent. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/update-agent` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | assistantId | string | yes | The ID of the agent to modify. | | body | object | yes | JSON request body | ### Deletes an agent. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/delete-agent` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | assistantId | string | yes | Identifier of the agent. | ### Gets a list of previously uploaded files. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/files-list-files` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | purpose | string | no | The purpose of the file. | ### Uploads a file for use by other operations. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/files-upload-file` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | body | object | no | Form fields as a JSON object | ### Returns information about a specific file. Does not retrieve file content. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/files-get-file` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | fileId | string | yes | The ID of the file to retrieve. | ### Delete a previously uploaded file. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/files-delete-file` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | fileId | string | yes | The ID of the file to delete. | ### Retrieves the raw content of a specific file. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/files-get-file-content` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | fileId | string | yes | The ID of the file to retrieve. | ### Gets a list of threads that were previously created. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/threads-list-threads` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | limit | integer | no | A limit on the number of objects to be returned on one page. Limit can range between 1 and 100, and the default is 20. | | order | string | no | Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. | | after | string | no | A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and… | | before | string | no | A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and… | ### Creates a new thread. Threads contain messages and can be run by agents. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/threads-create-thread` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | body | object | yes | JSON request body | ### Gets information about an existing thread. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/threads-get-thread` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | ### Modifies an existing thread. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/threads-update-thread` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | The ID of the thread to modify. | | body | object | yes | JSON request body | ### Deletes an existing thread. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/threads-delete-thread` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | ### Gets a list of messages that exist on a thread. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/messages-list-messages` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | threadId | string | yes | Identifier of the thread. | | run_id | string | no | Filter messages by the run ID that generated them. | | api-version | string | no | The API version to use for this operation. | | limit | integer | no | A limit on the number of objects to be returned on one page. Limit can range between 1 and 100, and the default is 20. | | order | string | no | Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. | | after | string | no | A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and… | | before | string | no | A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and… | ### Creates a new message on a specified thread. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/messages-create-message` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | | body | object | yes | JSON request body | ### Retrieves an existing message. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/messages-get-message` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | | messageId | string | yes | Identifier of the message. | ### Modifies an existing message on an existing thread. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/messages-update-message` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | | messageId | string | yes | Identifier of the message. | | body | object | yes | JSON request body | ### Deletes an existing message on an existing thread. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/messages-delete` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | | messageId | string | yes | Identifier of the message. | ### Gets a list of runs for a specified thread. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/runs-list-runs` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | threadId | string | yes | Identifier of the thread. | | api-version | string | no | The API version to use for this operation. | | limit | integer | no | A limit on the number of objects to be returned on one page. Limit can range between 1 and 100, and the default is 20. | | order | string | no | Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. | | after | string | no | A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and… | | before | string | no | A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and… | ### Creates a new run for an agent thread. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/runs-create-run` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | | include[] | array | no | A list of additional fields to include in the response. Currently the only supported value is… | | body | object | yes | JSON request body | ### Gets an existing run from an existing thread. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/runs-get-run` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | | runId | string | yes | Identifier of the run. | ### Modifies an existing thread run. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/runs-update-run` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | | runId | string | yes | Identifier of the run. | | body | object | yes | JSON request body | ### Cancels a run of an in‐progress thread. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/runs-cancel-run` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | | runId | string | yes | Identifier of the run. | ### Gets a list of run steps from a thread run. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/run-steps-list-run-steps` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | threadId | string | yes | Identifier of the thread. | | runId | string | yes | Identifier of the run. | | include[] | array | no | A list of additional fields to include in the response. Currently the only supported value is… | | api-version | string | no | The API version to use for this operation. | | limit | integer | no | A limit on the number of objects to be returned on one page. Limit can range between 1 and 100, and the default is 20. | | order | string | no | Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. | | after | string | no | A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and… | | before | string | no | A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and… | ### Retrieves a single run step from a thread run. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/run-steps-get-run-step` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | | runId | string | yes | Identifier of the run. | | stepId | string | yes | Identifier of the run step. | | include[] | array | no | A list of additional fields to include in the response. Currently the only supported value is… | ### Submits outputs from tools as requested by tool calls in a run. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/runs-submit-tool-outputs-to-run` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | threadId | string | yes | Identifier of the thread. | | runId | string | yes | Identifier of the run. | | body | object | yes | JSON request body | ### Creates a new agent thread and immediately starts a run using that new thread. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/create-thread-and-run` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | body | object | yes | JSON request body | ### Returns a list of vector stores. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-stores-list-vector-stores` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | limit | integer | no | A limit on the number of objects to be returned on one page. Limit can range between 1 and 100, and the default is 20. | | order | string | no | Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. | | after | string | no | A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and… | | before | string | no | A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and… | ### Creates a vector store. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-stores-create-vector-store` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | body | object | yes | JSON request body | ### Returns the vector store object matching the specified ID. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-stores-get-vector-store` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | vectorStoreId | string | yes | Identifier of the vector store. | ### Modifies an existing vector store. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-stores-modify-vector-store` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | vectorStoreId | string | yes | Identifier of the vector store. | | body | object | yes | JSON request body | ### Deletes the vector store object matching the specified ID. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-stores-delete-vector-store` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | vectorStoreId | string | yes | Identifier of the vector store. | ### Create a vector store file batch. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-store-file-batches-create-vector-store-file-batch` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | vectorStoreId | string | yes | Identifier of the vector store. | | body | object | yes | JSON request body | ### Retrieve a vector store file batch. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-store-file-batches-get-vector-store-file-batch` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | vectorStoreId | string | yes | Identifier of the vector store. | | batchId | string | yes | Identifier of the file batch. | ### Cancel a vector store file batch. This attempts to cancel the processing of files in this batch as soon as… `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-store-file-batches-cancel-vector-store-file-batch` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | vectorStoreId | string | yes | Identifier of the vector store. | | batchId | string | yes | Identifier of the file batch. | ### Returns a list of vector store files in a batch. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-store-file-batches-list-vector-store-file-batch-files` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | vectorStoreId | string | yes | Identifier of the vector store. | | batchId | string | yes | Identifier of the file batch. | | filter | string | no | Filter by file status. | | api-version | string | no | The API version to use for this operation. | | limit | integer | no | A limit on the number of objects to be returned on one page. Limit can range between 1 and 100, and the default is 20. | | order | string | no | Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. | | after | string | no | A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and… | | before | string | no | A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and… | ### Returns a list of vector store files. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-store-files-list-vector-store-files` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | vectorStoreId | string | yes | Identifier of the vector store. | | filter | string | no | Filter by file status. | | api-version | string | no | The API version to use for this operation. | | limit | integer | no | A limit on the number of objects to be returned on one page. Limit can range between 1 and 100, and the default is 20. | | order | string | no | Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. | | after | string | no | A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and… | | before | string | no | A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and… | ### Create a vector store file by attaching a file to a vector store. `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-store-files-create-vector-store-file` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | vectorStoreId | string | yes | Identifier of the vector store. | | body | object | yes | JSON request body | ### Retrieves a vector store file. `GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-store-files-get-vector-store-file` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | vectorStoreId | string | yes | Identifier of the vector store. | | fileId | string | yes | Identifier of the file. | ### Deletes a vector store file. This removes the file‐to‐store link (does not delete the file itself). `POST https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/vector-store-files-delete-vector-store-file` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | endpoint | string | yes | Project endpoint in the form of: https:// .services.ai.azure.com/api/projects/ | | api-version | string | no | The API version to use for this operation. | | vectorStoreId | string | yes | Identifier of the vector store. | | fileId | string | yes | Identifier of the file. | ## Example ``` curl "https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/list-agents" \ -H "x-api-key: $APIZIE_KEY" \ -H "x-upstream-key: $PROVIDER_KEY" ``` ## FAQ ### How do I call the Azure AI API? Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:azure-ai-aiagents/list-agents with the header x-api-key. Every endpoint returns { project, data, timestamp }. ### Is the Azure AI API free on Apizie? Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Azure AI itself also needs your own key from azure.com. ### Can AI agents use the Azure AI API? Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-ai-aiagents. ### What is the status of the Azure AI API? Needs your own provider key (bring your own key)