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

Mixedbread files API

The files API from Mixedbread — 7 operation(s) for files.

Mixedbread files API is one of 14 APIs that Mixedbread publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include File. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 3 JSON Schemas.

This API exposes 11 operations across 7 paths, and defines 16 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against 4 base URLs: https://api.mixedbread.com, https://api.dev.mixedbread.com, http://127.0.0.1:8000, http://localhost:8000.

11 operations 7 paths 16 schemas 1 DELETE5 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://api.mixedbread.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Mixedbread files API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (ApiKeyAuth).

  • ApiKeyAuth — Api key to access Mixedbreads API

Paths & Operations 11

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

files 11
POST
/v1/files
Upload file
create_file body → 201422
GET
/v1/files
List files
list_files 5 params → 200422
GET
/v1/files/uploads
List in-progress multipart uploads
list_multipart_uploads → 200
POST
/v1/files/uploads
Create multipart upload
create_multipart_upload body → 201422
POST
/v1/files/uploads/{upload_id}/complete
Complete multipart upload
complete_multipart_upload 1 param body → 200422
POST
/v1/files/uploads/{upload_id}/abort
Abort multipart upload
abort_multipart_upload 1 param → 200422
GET
/v1/files/uploads/{upload_id}
Get multipart upload details
get_multipart_upload 1 param → 200422
GET
/v1/files/{file_id}
Get file details
retrieve_file 1 param → 200422
POST
/v1/files/{file_id}
Update file
update_file 1 param body → 200422
DELETE
/v1/files/{file_id}
Delete file
delete_file 1 param → 200422
GET
/v1/files/{file_id}/content
Download file
download_file 1 param → 200422

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are MultipartUploadDetailResponse (8 properties), FileObject (7 properties), MultipartUploadObject (6 properties), ValidationError (5 properties). Each schema is shown below with its type and property counts.

ValidationError
object
5 properties 3 required
MultipartUploadPartUrl
object
2 properties 2 required
CreateMultipartUploadResponse
object
2 properties 2 required
CursorPaginationResponse
object
Response model for cursor-based pagination.
4 properties 3 required
Body_create_file
object
1 property 1 required
FileListResponse
object
3 properties 2 required
MultipartUploadPart
object
2 properties 2 required
MultipartUploadDetailResponse
object
8 properties 8 required
MultipartUploadListResponse
object
1 property 1 required
FileDeleted
object
3 properties 1 required
CompleteMultipartUploadRequest
object
1 property 1 required
MultipartUploadObject
object
6 properties 6 required
FileObject
object
A model representing a file object in the system. This model contains metadata about files stored in the system, including identifiers, size information, and t…
7 properties 7 required
CreateMultipartUploadRequest
object
4 properties 3 required
HTTPValidationError
object
1 property
Body_update_file
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mixedbread-ai-files-api-openapi.yml Raw ↑

Other APIs Mixedbread publishes across the network.

Mixedbread admin API
Mixedbread api_keys API
Mixedbread billing API
Mixedbread completions API
Mixedbread data_sources API
Mixedbread deprecated_vector_stores API
Mixedbread Embeddings API
Mixedbread extractions API
Mixedbread Mixedbread Embeddings API API
Mixedbread parsing API
Mixedbread Reranking API
Mixedbread schemas API
Where this information came from

This is an independent, third-party profile of Mixedbread files 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.