Microsoft Azure Files: API

The Files: API from Microsoft Azure — 17 operation(s) for files:.

Documentation GitHub OpenAPI

Operations 27

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /files List files owned by an Azure OpenAI resource · Microsoft Azure Gets A List Of All Files Owned By The Azure Openai Resource… #

Ask an LLM

“Which training and validation files have I uploaded to my Azure OpenAI resource?”

“Can I see every file my OpenAI resource owns, including fine-tune result files?”

Tell an agent

List all files on my Azure OpenAI resource using API version {api-version}.

Show me the fine-tune files currently stored on the OpenAI resource.

POST /files Upload a local file for fine-tuning · Microsoft Azure Creates A New File Entity By Uploading Data From A Local… #

Ask an LLM

“How do I upload a JSONL training file from my machine to Azure OpenAI?”

“Can I push a local validation dataset to be used by a fine-tune job?”

Tell an agent

Upload {file} to Azure OpenAI with purpose {purpose}.

Send local file {file} up as a fine-tune training file ({purpose}).

GET /files/{file_id} Get an OpenAI file's status and size (file_id route) · Microsoft Azure Gets Details For A Single File Specified By The Given File Id… #

Ask an LLM

“What is the processing status, size and purpose of one uploaded OpenAI file, looked up by file_id?”

“Has my fine-tune training file finished importing, using the underscore file_id route?”

Tell an agent

Get details for OpenAI file {file_id} via the file_id route.

Check status and byte size of training file {file_id} using the underscore file_id path.

DELETE /files/{file_id} Delete an OpenAI file (file_id route) · Microsoft Azure Deletes The File With The Given File Id deletion Is Also… #

Ask an LLM

“Can I remove an uploaded file by file_id even after a fine-tune job trained on it?”

“What happens if I delete a training file that was used by a finished fine-tune, via the file_id route?”

Tell an agent destructive · confirm first

Delete OpenAI file {file_id} using the underscore file_id path.

Remove old training upload {file_id} through the file_id endpoint.

GET /files/{file_id}/content Download an OpenAI file's content (file_id route) · Microsoft Azure Gets The Content Of The File Specified By The Given File Id… #

Ask an LLM

“Can I download the result metrics a fine-tune job produced, using the file_id content route?”

“Where do I fetch the raw bytes of an uploaded file by its underscore file_id?”

Tell an agent

Download the content of file {file_id} from the file_id content route.

Fetch the fine-tune results file {file_id} body via /files/{file_id}/content.

POST /files/import Import a file into Azure OpenAI from a URL · Microsoft Azure Creates A New File Entity By Importing Data From A Provided Url… #

Ask an LLM

“Can I bring a training file into Azure OpenAI straight from a blob URL instead of uploading it?”

“How do I import a fine-tune dataset hosted at a remote URL?”

Tell an agent

Import {content_url} as {filename} with purpose {purpose}.

Pull the dataset at URL {content_url} into OpenAI and name it {filename} for {purpose}.

GET /files/{file-id} Get an OpenAI file's details (file-id route) · Microsoft Azure Gets Details For A Single File Specified By The Given File Id… #

Ask an LLM

“Which purpose and size does an uploaded file report on the hyphenated file-id path?”

“Is a given file still processing when I query it through the hyphenated file-id path?”

Tell an agent

Look up file metadata for {file-id} on the hyphenated file-id route.

Read status, purpose and size of {file-id} through the file-id path variant.

DELETE /files/{file-id} Delete an OpenAI file (file-id route) · Microsoft Azure Deletes The File With The Given File Id deletion Is Also… #

Ask an LLM

“Can I erase a file through the hyphenated file-id delete path?”

“Does deleting via the hyphenated file-id route still work for files a fine-tune consumed?”

Tell an agent destructive · confirm first

Erase file {file-id} using the hyphenated file-id delete route.

Permanently drop upload {file-id} via the file-id variant.

GET /files/{file-id}/content Download an OpenAI file's content (file-id route) · Microsoft Azure Gets The Content Of The File Specified By The Given File Id… #

Ask an LLM

“Can I read back what a service-generated file contains via the hyphenated file-id content path?”

“Which route returns file bytes when my client uses file-id rather than file_id?”

Tell an agent

Stream the bytes of file {file-id} from the file-id content endpoint.

Save the contents of generated file {file-id} using the hyphenated route.

GET /files/{fileId} Retrieve file information by fileId · Microsoft Azure Get Files Fileid #

Ask an LLM

“Can I get information about a file by fileId without pulling down its contents?”

“What metadata comes back from the camel-case fileId file lookup?”

Tell an agent

Retrieve file info for {fileId} without downloading its content.

Show the record for camel-case fileId {fileId}.

DELETE /files/{fileId} Delete a previously uploaded file by fileId · Microsoft Azure Delete Files Fileid #

Ask an LLM

“Can I delete a previously uploaded file addressed by camel-case fileId?”

“Is there a delete for files on the camel-case fileId path?”

Tell an agent destructive · confirm first

Delete previously uploaded file {fileId}.

Get rid of the upload with camel-case fileId {fileId}.

DELETE /jobs/{jobId}/tasks/{taskId}/files/{filePath} Delete a Batch task's file from its node · Microsoft Azure Deletes The Specified Task File From The Compute Node Where The… #

Ask an LLM

“Can I clean up an output file a task left on the compute node where it ran?”

“Is it possible to recursively delete a directory in a task's working folder?”

Tell an agent destructive · confirm first

Delete task file {filePath} for task {taskId} in job {jobId}.

Recursively remove directory {filePath} from task {taskId} of job {jobId} (recursive={recursive}).

GET /jobs/{jobId}/tasks/{taskId}/files/{filePath} Download a file a Batch task wrote · Microsoft Azure Get Jobs Jobid Tasks Taskid Files Filepath #

Ask an LLM

“How do I read the stdout.txt a Batch task produced on its compute node?”

“Can I fetch only a byte range of a task's output file?”

Tell an agent

Download {filePath} from task {taskId} in Batch job {jobId}.

Get bytes {ocp-range} of task file {filePath} for task {taskId} in job {jobId}.

HEAD /jobs/{jobId}/tasks/{taskId}/files/{filePath} Get properties of a Batch task file · Microsoft Azure Head Jobs Jobid Tasks Taskid Files Filepath #

Ask an LLM

“What size and last-modified time does a task's output file have, without downloading it?”

“Can I check whether a task file changed since a given date using only its headers?”

Tell an agent

Get the properties of {filePath} for task {taskId} in job {jobId}.

Check if task file {filePath} on task {taskId}, job {jobId} was modified since {If-Modified-Since}.

DELETE /pools/{poolId}/nodes/{nodeId}/files/{filePath} Delete a file from a Batch compute node · Microsoft Azure Deletes The Specified File From The Compute Node #

Ask an LLM

“Can I free disk space by deleting a file directly on a pool node?”

“Does removing a folder on a compute node support a recursive flag?”

Tell an agent destructive · confirm first

Delete {filePath} from compute node {nodeId} in pool {poolId}.

Wipe folder {filePath} on node {nodeId} of pool {poolId} with recursive set to {recursive}.

GET /pools/{poolId}/nodes/{nodeId}/files/{filePath} Download a file from a Batch compute node · Microsoft Azure Get Pools Poolid Nodes Nodeid Files Filepath #

Ask an LLM

“How do I pull a log file straight off a compute node in a Batch pool?”

“Can I read part of a node file by byte range rather than the whole thing?”

Tell an agent

Download {filePath} from node {nodeId} in pool {poolId}.

Read range {ocp-range} of node file {filePath} on compute node {nodeId}, pool {poolId}.

HEAD /pools/{poolId}/nodes/{nodeId}/files/{filePath} Get properties of a file on a compute node · Microsoft Azure Head Pools Poolid Nodes Nodeid Files Filepath #

Ask an LLM

“What is the size and timestamp of a file sitting on a Batch pool node?”

“Can I tell whether a node file is unchanged since a date without fetching it?”

Tell an agent

Get the properties of node file {filePath} on {nodeId} in pool {poolId}.

Check node {nodeId} (pool {poolId}) file {filePath} headers only, unmodified since {If-Unmodified-Since}.

GET /jobs/{jobId}/tasks/{taskId}/files List the files in a Batch task's directory · Microsoft Azure Lists The Files In A Task S Directory On Its Compute Node #

Ask an LLM

“Which files did a Batch task write into its working directory?”

“Can I list a task's files recursively and filter by name?”

Tell an agent

List files for task {taskId} in job {jobId}.

Recursively list task {taskId} files in job {jobId} matching {filter}.

GET /pools/{poolId}/nodes/{nodeId}/files List task directory files on a compute node · Microsoft Azure Lists All Of The Files In Task Directories On The Specified… #

Ask an LLM

“What files exist across all task directories on one Batch node?”

“Can I cap how many node files come back in one listing?”

Tell an agent

List all files on compute node {nodeId} in pool {poolId}.

Show up to {maxresults} files from node {nodeId} of pool {poolId}.

GET /subscriptions/{subscriptionId}/providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}/files List files in a support file workspace · Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Support… #

Ask an LLM

“Which files have I attached to a support file workspace in my subscription?”

“Can I see everything uploaded to a support ticket workspace scoped to one subscription?”

Tell an agent

List files in support workspace {fileWorkspaceName} under subscription {subscriptionId}.

Show the attachments in subscription {subscriptionId}'s support workspace {fileWorkspaceName}.

GET /providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}/files List support workspace files without a subscription · Microsoft Azure Get Providers Microsoft Support Fileworkspaces… #

Ask an LLM

“Can I list the files in a support workspace when I have no subscription to scope it to?”

“What attachments are in a tenant-level support file workspace?”

Tell an agent

List files in tenant-level support workspace {fileWorkspaceName}.

Show attachments in no-subscription workspace {fileWorkspaceName}.

GET /subscriptions/{subscriptionId}/providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}/files/{fileName} Get a support workspace file in a subscription · Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Support… #

Ask an LLM

“What are the details of one file in my subscription's support workspace?”

“Can I check the size of a support attachment I uploaded under a subscription?”

Tell an agent

Get support file {fileName} in workspace {fileWorkspaceName} for subscription {subscriptionId}.

Show details of attachment {fileName} from subscription {subscriptionId} workspace {fileWorkspaceName}.

PUT /subscriptions/{subscriptionId}/providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}/files/{fileName} Create a support file in a subscription workspace · Microsoft Azure Put Subscriptions Subscriptionid Providers Microsoft Support… #

Ask an LLM

“How do I register a new file in a support workspace before uploading its content?”

“Can I create a support attachment entry scoped to my subscription?”

Tell an agent

Create file {fileName} in support workspace {fileWorkspaceName} for subscription {subscriptionId}.

Register attachment {fileName} under subscription {subscriptionId} workspace {fileWorkspaceName} with properties {properties}.

GET /providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}/files/{fileName} Get a support file without a subscription · Microsoft Azure Get Providers Microsoft Support Fileworkspaces… #

Ask an LLM

“What does a support attachment look like in a workspace that isn't tied to a subscription?”

“Can I look up one file in a tenant-level support workspace?”

Tell an agent

Get file {fileName} from tenant-level support workspace {fileWorkspaceName}.

Look up no-subscription attachment {fileName} in {fileWorkspaceName}.

PUT /providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}/files/{fileName} Create a support file without a subscription · Microsoft Azure Put Providers Microsoft Support Fileworkspaces… #

Ask an LLM

“Can I create a support attachment in a workspace when I have no Azure subscription?”

“Which call adds a new file entry to a tenant-level support workspace?”

Tell an agent

Create file {fileName} in tenant-level support workspace {fileWorkspaceName}.

Add no-subscription attachment {fileName} to {fileWorkspaceName} with properties {properties}.

POST /subscriptions/{subscriptionId}/providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}/files/{fileName}/upload Upload content to a support file in a subscription · Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Support… #

Ask an LLM

“How do I upload the bytes of a support attachment in chunks under my subscription?”

“Can I send file content to a support workspace one chunk index at a time?”

Tell an agent

Upload content to support file {fileName} in {fileWorkspaceName} for subscription {subscriptionId}.

Send chunk {chunkIndex} of {fileName} to workspace {fileWorkspaceName} in subscription {subscriptionId}.

POST /providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}/files/{fileName}/upload Upload content to a support file without a subscription · Microsoft Azure Post Providers Microsoft Support Fileworkspaces… #

Ask an LLM

“Can I upload attachment content to a tenant-level support workspace with no subscription?”

“Which endpoint accepts chunked content for a no-subscription support file?”

Tell an agent

Upload content to tenant-level support file {fileName} in {fileWorkspaceName}.

Push chunk number {chunkIndex} of no-subscription file {fileName} into {fileWorkspaceName}.

Microsoft Azure Files: API

Operations 27

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification