Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

nexos.ai Files API

Upload and manage files used by other endpoints.

nexos.ai Files API is one of 16 APIs that nexos.ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Files. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 5 operations across 3 paths, and defines 5 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://api.nexos.ai.

5 operations 3 paths 5 schemas 1 DELETE3 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://api.nexos.ai
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

nexos.ai Files API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). An API key is passed in the header as X-Api-Key (apiKeyHeader). By default, every request must be authenticated.

  • apiKeyHeader — Authenticate by sending your nexos API key in the X-Api-Key header (e.g. X-Api-Key: nexos-... for a user key or X-Api-Key: nexos-team-... for a team key). This…

Paths & Operations 5

Across 3 paths, the API surfaces 5 operations — 1 DELETE, 3 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Files 5

Upload and manage files used by other endpoints.

GET
/v1/files
List files
get-files-v1 4 params → 2005004XX
POST
/v1/files
Upload file
post-files-v1 body → 200400500
GET
/v1/files/{file_id}
Get file
get-file-v1 1 param → 200404500
DELETE
/v1/files/{file_id}
Delete file
delete-file-v1 1 param → 200404500
GET
/v1/files/{file_id}/content
Get file contents
get-file-contents-v1 1 param → 200404500

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are FileResponse (8 properties), ListFilesResponse (5 properties), DeletionStatusResponse (3 properties), UploadFileRequest (2 properties). Each schema is shown below with its type and property counts.

FilePurposeType
string
The intended purpose of the file. Only "batch" is supported — uploaded files may only be used as input for the Batch API.
DeletionStatusResponse
object
The status of a file deletion.
3 properties 3 required
ListFilesResponse
object
A list of uploaded files.
5 properties 2 required
FileResponse
object
A document that has been uploaded and can be referenced by other endpoints.
8 properties
UploadFileRequest
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nexosai-files-api-openapi.yml Raw ↑

Other APIs nexos.ai publishes across the network.

nexos.ai Agent Management API
nexos.ai Assistant Management API
nexos.ai Audio API
nexos.ai Batches API
nexos.ai Budget Limit Management API
nexos.ai Chat API
nexos.ai Company Management API
nexos.ai Embeddings API
nexos.ai Images API
nexos.ai Messages API
nexos.ai Models API
nexos.ai Responses API