aid: mixedbread-ai url: https://raw.githubusercontent.com/api-evangelist/mixedbread-ai/refs/heads/main/apis.yml apis: - aid: mixedbread-ai:mixedbread-embeddings-api name: Mixedbread Embeddings API tags: - AI - Embeddings - Vectors - Multimodal humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-embeddings-api-openapi.yml type: OpenAPI - url: json-schema/mixedbread-embedding-schema.json type: JSONSchema - url: json-ld/mixedbread-ai-context.jsonld type: JSONLD - type: NaftikoCapability url: capabilities/embeddings-embeddings.yaml description: POST /v1/embeddings creates dense or multi-encoding embeddings for text and images using mxbai embedding models (mxbai-embed-large-v1, deepset-mxbai-embed-de-large-v1, mxbai-embed-xsmall-v1, Wholembed v3). Supports Matryoshka dimensions, binary/int8/float32 encodings, and prompt instructions. Returns Embedding objects with token usage. - aid: mixedbread-ai:mixedbread-reranking-api name: Mixedbread Reranking API tags: - AI - Reranking - Search - Retrieval humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-reranking-api-openapi.yml type: OpenAPI - url: json-schema/mixedbread-rerank-schema.json type: JSONSchema - type: NaftikoCapability url: capabilities/reranking-reranking.yaml description: POST /v1/reranking reorders a candidate document list against a query using the mxbai-rerank family (xsmall-v1, base-v1, large-v1, base-v2, large-v2, plus the v3-listwise instruction-following reranker). Documents can be raw strings or structured objects with a return_input flag. Top-K results returned with relevance scores. - aid: mixedbread-ai:mixedbread-stores-api name: Mixedbread Stores API tags: - AI - Search - Vector Database - RAG - Retrieval humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/docs/stores/overview type: Documentation - url: openapi/mixedbread-stores-api-openapi.yml type: OpenAPI - url: json-schema/mixedbread-store-schema.json type: JSONSchema - type: NaftikoCapability url: capabilities/stores-stores.yaml - type: NaftikoCapability url: capabilities/stores-files.yaml - type: NaftikoCapability url: capabilities/stores-search.yaml description: Stores are AI-powered multimodal search indexes. CRUD for stores plus file upload, semantic search, grep, list-chunks, question-answering, query enhancement, metadata facets, search rules, and events. Replaces the deprecated /v1/vector_stores surface; deprecated endpoints kept for backward compatibility. - aid: mixedbread-ai:mixedbread-parsing-api name: Mixedbread Parsing API tags: - AI - Parsing - Documents - Chunking - OCR humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-parsing-api-openapi.yml type: OpenAPI - type: NaftikoCapability url: capabilities/parsing-jobs.yaml description: Asynchronous document parsing as jobs. POST /v1/parsing/jobs starts a parse over an uploaded file with configurable chunking strategy, return format (markdown/HTML/text), and element extraction. GET/PATCH/DELETE on /v1/parsing/jobs/{job_id} for retrieval, cancellation, and deletion. Produces structured chunks with type metadata for text, code, tables, images, audio, video. - aid: mixedbread-ai:mixedbread-extractions-api name: Mixedbread Extractions API tags: - AI - Extraction - Structured Output - JSON Schema humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-extractions-api-openapi.yml type: OpenAPI - type: NaftikoCapability url: capabilities/extractions-jobs.yaml - type: NaftikoCapability url: capabilities/extractions-schema.yaml description: Schema-guided structured extraction. POST /v1/extractions/jobs runs an extraction job against a file; POST /v1/extractions/content extracts from raw strings. The /v1/extractions/schema family creates, enhances, and validates JSON Schema definitions used by the extraction pipeline. - aid: mixedbread-ai:mixedbread-files-api name: Mixedbread Files API tags: - AI - Files - Storage - Multipart Upload humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-files-api-openapi.yml type: OpenAPI - type: NaftikoCapability url: capabilities/files-files.yaml - type: NaftikoCapability url: capabilities/files-uploads.yaml description: Workspace file management for files used across stores, parsing, and extraction. Single-shot upload via POST /v1/files plus multipart upload via /v1/files/uploads (create, complete, abort, list). Standard CRUD on /v1/files/{file_id} including content download. - aid: mixedbread-ai:mixedbread-completions-api name: Mixedbread Chat Completions API tags: - AI - Chat - Completions - LLM humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-completions-api-openapi.yml type: OpenAPI - type: NaftikoCapability url: capabilities/completions-chat.yaml description: POST /v1/chat/completions exposes an OpenAI-compatible chat completion surface that grounds responses in Mixedbread Stores. Used to drive question-answering and agentic flows on top of indexed multimodal content. - aid: mixedbread-ai:mixedbread-data-sources-api name: Mixedbread Data Sources API tags: - AI - Data Sources - Connectors - Integrations - OAuth2 humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-data-sources-api-openapi.yml type: OpenAPI - type: NaftikoCapability url: capabilities/data-sources-data-sources.yaml - type: NaftikoCapability url: capabilities/data-sources-connectors.yaml description: Manage external data sources and their connectors, including OAuth2 authorization/callback flows. Lets stores ingest content from third-party SaaS systems through reusable connector definitions. - aid: mixedbread-ai:mixedbread-api-keys-api name: Mixedbread API Keys API tags: - AI - Administration - API Keys - Security humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-api-keys-api-openapi.yml type: OpenAPI - type: NaftikoCapability url: capabilities/api-keys-api-keys.yaml description: Programmatic management of workspace API keys. CRUD plus rotation (reroll) and revocation under /v1/api-keys. - aid: mixedbread-ai:mixedbread-billing-api name: Mixedbread Billing API tags: - AI - Billing - Usage - FinOps - Cost humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-billing-api-openapi.yml type: OpenAPI - type: NaftikoCapability url: capabilities/billing-billing.yaml description: Read-only billing telemetry. GET /v1/billing/summary returns workspace-level spend; /v1/billing/stores breaks cost down per store; histogram endpoints chart store and parsing costs over time. Aligns with the workspace's usage-based pricing. - aid: mixedbread-ai:mixedbread-schemas-api name: Mixedbread Schemas API tags: - AI - JSON Schema - Discovery humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-schemas-api-openapi.yml type: OpenAPI description: GET /v1/schemas/mxjson returns the mxbai JSON schema definition. Used by clients and the CLI to validate Mixedbread-flavored JSON payloads. - aid: mixedbread-ai:mixedbread-admin-api name: Mixedbread Admin API tags: - AI - Administration - Operations humanURL: https://www.mixedbread.com/api-reference baseURL: https://api.mixedbread.com properties: - url: https://www.mixedbread.com/api-reference type: Documentation - url: openapi/mixedbread-admin-api-openapi.yml type: OpenAPI description: Reserved operations for Mixedbread platform administrators. POST /v1/admin/stores/{organization_id}/{store_identifier}/reingest triggers a full reingest of a tenant store. name: Mixedbread tags: - AI - Artificial Intelligence - Embeddings - Reranking - Search - Retrieval - RAG - Vector Database - Multimodal - Parsing - Open Weights kind: contract image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg access: 3rd-Party common: - type: Portal url: https://www.mixedbread.com/ name: Mixedbread Home - type: Documentation url: https://www.mixedbread.com/docs name: Mixedbread Docs - type: Documentation url: https://www.mixedbread.com/api-reference name: API Reference - type: SignUp url: https://platform.mixedbread.com/ name: Mixedbread Platform - type: Pricing url: https://www.mixedbread.com/pricing name: Pricing - type: Blog url: https://www.mixedbread.com/blog name: Blog - type: GitHub url: https://github.com/mixedbread-ai name: Mixedbread GitHub - type: HuggingFace url: https://huggingface.co/mixedbread-ai name: Mixedbread on Hugging Face - type: SDK url: https://github.com/mixedbread-ai/mixedbread-python name: Python SDK - type: SDK url: https://github.com/mixedbread-ai/mixedbread-ts name: TypeScript SDK - type: SDK url: https://github.com/mixedbread-ai/python-sdk name: Python SDK (legacy) - type: SDK url: https://github.com/mixedbread-ai/typescript-sdk name: TypeScript SDK (legacy) - type: CLI url: https://www.mixedbread.com/docs/cli name: Mixedbread CLI - type: Tools url: https://github.com/mixedbread-ai/skills name: Agent Skills (npx skills add mixedbread-ai/skills) - type: Tools url: https://github.com/mixedbread-ai/mxbai-rerank name: mxbai-rerank (open-weight reranking models) - type: Tools url: https://github.com/mixedbread-ai/baguetter name: Baguetter (search engine library) - type: Tools url: https://github.com/mixedbread-ai/batched name: Batched (dynamic batching for inference) - type: Tools url: https://github.com/mixedbread-ai/maxsim-cpu name: maxsim-cpu (CPU late-interaction kernels) - type: Tools url: https://github.com/mixedbread-ai/mgrep name: mgrep (semantic CLI grep) - type: Integration url: https://github.com/mixedbread-ai/mixedbread-ai-langchain name: LangChain Integration - type: Integration url: https://github.com/mixedbread-ai/mixedbread-ai-haystack name: Haystack Integration - type: Integration url: https://github.com/mixedbread-ai/vercel-marketplace-mixedbread name: Vercel Marketplace Integration - type: Integration url: https://www.mixedbread.com/docs/mcp name: Model Context Protocol (MCP) - type: Authentication url: https://www.mixedbread.com/api-reference name: API Key (Bearer) - type: LinkedIn url: https://www.linkedin.com/company/mixedbread-ai/ name: LinkedIn - type: Twitter url: https://x.com/mixedbreadai name: X (Twitter) - type: Discord url: https://discord.gg/mixedbread name: Discord - type: Plans url: plans/mixedbread-ai-plans-pricing.yml name: Plans (API Commons) - type: RateLimits url: rate-limits/mixedbread-ai-rate-limits.yml name: Rate Limits (API Commons) - type: FinOps url: finops/mixedbread-ai-finops.yml name: FinOps (FOCUS-aligned) created: '2026-05-25' modified: '2026-05-25' specificationVersion: '0.20' description: Mixedbread is a Berlin-based AI search and retrieval platform. It provides embeddings (mxbai-embed, Wholembed v3), rerankers (mxbai-rerank v1/v2/v3-listwise), multimodal stores, document parsing, structured extraction, and connector-based ingestion. Models are published as open weights on Hugging Face and consumed via a hosted REST API at api.mixedbread.com. The platform powers RAG and agent retrieval over text, PDFs, images, audio, and video across 100+ languages.