# amber Developer Portal

- [Introduction](https://developers.ambersearch.de/api-reference/introduction.md): Welcome to amber Beta Public REST API
- [Authentication](https://developers.ambersearch.de/api-reference/authentication.md): Learn how to authenticate with the amber API using OAuth 2.0
- [Search full text](https://developers.ambersearch.de/api-reference/endpoint/search.md): Perform a full text search across documents.
- [Web search](https://developers.ambersearch.de/api-reference/endpoint/web-search.md): Perform a web search using the provided queries and parameters.
- [Get document metadata](https://developers.ambersearch.de/api-reference/endpoint/get-document-metadata.md): Retrieve metadata for a specific document.
- [Download document](https://developers.ambersearch.de/api-reference/endpoint/download-document.md): Download a document by its ID.
- [Upload File](https://developers.ambersearch.de/api-reference/endpoint/upload-file.md): Upload a file for use with AI chat completions.
- [Introduction](https://developers.ambersearch.de/api-reference/openai/introduction.md): This document provides an overview of the OpenAI API compatible endpoints provided by amber.
- [List models](https://developers.ambersearch.de/api-reference/openai/list-models.md): Retrieve a list of available AI models.
- [Retrieve model](https://developers.ambersearch.de/api-reference/openai/retrieve-model.md): Retrieve details about a specific model by its identifier.
- [Create chat completion](https://developers.ambersearch.de/api-reference/openai/create-chat-completion.md): Create a chat completion based on the provided messages and parameters.
- [Create chat completion (OpenAI format)](https://developers.ambersearch.de/api-reference/openai/create-chat-completion-openai-format.md): Creates a chat completion in OpenAI-compatible format.
- [List models (OpenAI format)](https://developers.ambersearch.de/api-reference/openai/list-models-openai-format.md): Retrieves a list of available models in OpenAI format.
- [Introduction](https://developers.ambersearch.de/mcp/introduction.md): This document provides an overview of the amber MCP Server, its purpose, and how to get started.
- [Indexing API Overview](https://developers.ambersearch.de/indexing-api/introduction.md): Push custom content into amber to make it searchable alongside your other data sources.
- [Datasource & custom properties](https://developers.ambersearch.de/indexing-api/setup-datasource.md): Create a custom datasource, declare object types, property schemas, and the sub-datasource hierarchy used to filter results.
- [Index Documents](https://developers.ambersearch.de/indexing-api/index-documents.md): Push documents into amber to make them searchable through the Indexing API.
- [Custom Properties](https://developers.ambersearch.de/indexing-api/custom-properties.md): Custom properties are documented together with datasource setup.
- [Permissions](https://developers.ambersearch.de/indexing-api/permissions.md): Control who can see indexed documents using the permissions block on each document.
- [Example: Odoo Integration](https://developers.ambersearch.de/indexing-api/odoo-integration.md): A complete, runnable example of pushing Odoo records into amber via the Indexing API.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)