# Minikai API

> Build on the Minikai API. Read and write records, Minis, labels and users in your workspace, with typed Python and TypeScript SDKs.

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.minikai.com/_mcp/server

## Docs

- [Introduction](https://docs.minikai.com/guides/get-started/introduction.md): Make your first request to the Minikai API.
- [Authentication](https://docs.minikai.com/guides/get-started/authentication.md): Authenticate every request with a workspace-scoped API key.
- [Data regions](https://docs.minikai.com/guides/get-started/data-regions.md): Your workspace belongs to one data region, and that region sets the base URL you call.
- [External URIs](https://docs.minikai.com/guides/core-concepts/external-ur-is.md): Reference Minis and Records by an identifier from your own system.
- [Pagination](https://docs.minikai.com/guides/core-concepts/pagination.md): Page through list endpoints with cursors.
- [Errors](https://docs.minikai.com/guides/core-concepts/errors.md): How the API signals problems, and what to do about them.
- [SDKs](https://docs.minikai.com/sd-ks/sd-ks/overview.md): Typed Python and TypeScript clients for the Minikai API.
- [Python SDK](https://docs.minikai.com/sd-ks/sd-ks/python.md): A typed Python client for the Minikai API.
- [TypeScript SDK](https://docs.minikai.com/sd-ks/sd-ks/type-script.md): A typed TypeScript client for the Minikai API.
- [Changelog](https://docs.minikai.com/changelog.md): What's new in the Minikai API.
- [Changelog (all entries)](https://docs.minikai.com/changelog/llms.txt)

## API Docs

- API Reference > Label Groups [Create a label group](https://docs.minikai.com/api-reference/api-reference/label-groups/create-label-group.md)
- API Reference > Labels [List labels](https://docs.minikai.com/api-reference/api-reference/labels/list-labels.md)
- API Reference > Labels [Create a label](https://docs.minikai.com/api-reference/api-reference/labels/create-label.md)
- API Reference > Labels [Update a label](https://docs.minikai.com/api-reference/api-reference/labels/update-label.md)
- API Reference > Labels [Delete a label](https://docs.minikai.com/api-reference/api-reference/labels/delete-label.md)
- API Reference > Minis [List Minis](https://docs.minikai.com/api-reference/api-reference/minis/get-minis.md)
- API Reference > Minis [Create a Mini](https://docs.minikai.com/api-reference/api-reference/minis/create-mini.md)
- API Reference > Minis [Search Minis](https://docs.minikai.com/api-reference/api-reference/minis/search-minis.md)
- API Reference > Minis [Get a Mini by external URI](https://docs.minikai.com/api-reference/api-reference/minis/get-external-mini.md)
- API Reference > Minis [Upsert a Mini by external URI](https://docs.minikai.com/api-reference/api-reference/minis/upsert-external-mini.md)
- API Reference > Minis [Get a Mini](https://docs.minikai.com/api-reference/api-reference/minis/get-mini.md)
- API Reference > Minis [Update a Mini](https://docs.minikai.com/api-reference/api-reference/minis/update-mini.md)
- API Reference > Minis [Delete a Mini](https://docs.minikai.com/api-reference/api-reference/minis/delete-mini.md)
- API Reference > Minis [Partially update a Mini](https://docs.minikai.com/api-reference/api-reference/minis/patch-mini.md)
- API Reference > Minis [Update a Mini's labels](https://docs.minikai.com/api-reference/api-reference/minis/update-mini-labels.md)
- API Reference > Minis [List a Mini's versions](https://docs.minikai.com/api-reference/api-reference/minis/get-mini-versions.md)
- API Reference > Minis [Get a Mini version](https://docs.minikai.com/api-reference/api-reference/minis/get-mini-version.md)
- API Reference > Minis [Upload a Mini's profile picture](https://docs.minikai.com/api-reference/api-reference/minis/upload-mini-profile-picture.md)
- API Reference > Minis [Delete a Mini's profile picture](https://docs.minikai.com/api-reference/api-reference/minis/delete-mini-profile-picture.md)
- API Reference > Minis [Download a Mini's profile picture](https://docs.minikai.com/api-reference/api-reference/minis/download-mini-profile-picture.md)
- API Reference > Records [List Records](https://docs.minikai.com/api-reference/api-reference/records/get-records.md)
- API Reference > Records [Create a Record](https://docs.minikai.com/api-reference/api-reference/records/create-record.md)
- API Reference > Records [Export a Mini's Records as CSV (deprecated)](https://docs.minikai.com/api-reference/api-reference/records/export-records.md)
- API Reference > Records [Export Records as CSV](https://docs.minikai.com/api-reference/api-reference/records/export-records-for-minis.md)
- API Reference > Records [Search Records](https://docs.minikai.com/api-reference/api-reference/records/search-records.md)
- API Reference > Records [List a Record's versions](https://docs.minikai.com/api-reference/api-reference/records/get-record-versions.md)
- API Reference > Records [Update a Record](https://docs.minikai.com/api-reference/api-reference/records/update-record.md)
- API Reference > Records [Delete a Record](https://docs.minikai.com/api-reference/api-reference/records/delete-record.md)
- API Reference > Records [Restore a Record](https://docs.minikai.com/api-reference/api-reference/records/restore-record.md)
- API Reference > Records [Create a draft Record](https://docs.minikai.com/api-reference/api-reference/records/create-draft-record.md)
- API Reference > Records [Update a draft Record](https://docs.minikai.com/api-reference/api-reference/records/update-draft-record.md)
- API Reference > Records [Discard a draft Record](https://docs.minikai.com/api-reference/api-reference/records/dispose-draft-record.md)
- API Reference > Records [Submit a draft Record](https://docs.minikai.com/api-reference/api-reference/records/submit-draft-record.md)
- API Reference > Records [Batch create or update Records](https://docs.minikai.com/api-reference/api-reference/records/batch-upsert-records.md)
- API Reference > Records [Batch add attachments](https://docs.minikai.com/api-reference/api-reference/records/batch-add-attachments.md)
- API Reference > Records [Batch replace attachments](https://docs.minikai.com/api-reference/api-reference/records/batch-update-attachments.md)
- API Reference > Records [Batch upload Records with attachments](https://docs.minikai.com/api-reference/api-reference/records/batch-upload-records.md)
- API Reference > Records [List Records by external URI](https://docs.minikai.com/api-reference/api-reference/records/get-records-by-external.md)
- API Reference > Records [Batch upsert Records by external URI](https://docs.minikai.com/api-reference/api-reference/records/upsert-records-by-external-uri.md)
- API Reference > Records [Add attachments to a Record](https://docs.minikai.com/api-reference/api-reference/records/add-attachments.md)
- API Reference > Records [Replace a Record's attachments](https://docs.minikai.com/api-reference/api-reference/records/update-attachments.md)
- API Reference > Records [Remove attachments from a Record](https://docs.minikai.com/api-reference/api-reference/records/remove-attachments.md)
- API Reference > Records [Download a Record attachment](https://docs.minikai.com/api-reference/api-reference/records/download-attachment.md)
- API Reference > Records [Add relations to a Record](https://docs.minikai.com/api-reference/api-reference/records/add-relations.md)
- API Reference > Records [Replace a Record's relations](https://docs.minikai.com/api-reference/api-reference/records/update-relations.md)
- API Reference > Records [Remove relations from a Record](https://docs.minikai.com/api-reference/api-reference/records/remove-relations.md)
- API Reference > Records [List Record labels](https://docs.minikai.com/api-reference/api-reference/records/get-labels.md)
- API Reference > Records [List Record authors](https://docs.minikai.com/api-reference/api-reference/records/get-created-by.md)
- API Reference > Records [List Record editors](https://docs.minikai.com/api-reference/api-reference/records/get-updated-by.md)
- API Reference > Records [List Record states](https://docs.minikai.com/api-reference/api-reference/records/get-states.md)
- API Reference > Skills [List skills](https://docs.minikai.com/api-reference/api-reference/skills/get-skills.md)
- API Reference > Skills [Create a skill](https://docs.minikai.com/api-reference/api-reference/skills/create-skill.md)
- API Reference > Skills [Get a skill](https://docs.minikai.com/api-reference/api-reference/skills/get-skill.md)
- API Reference > Skills [Update a skill](https://docs.minikai.com/api-reference/api-reference/skills/update-skill.md)
- API Reference > Skills [Delete a skill](https://docs.minikai.com/api-reference/api-reference/skills/delete-skill.md)
- API Reference > Skills [Submit a draft skill](https://docs.minikai.com/api-reference/api-reference/skills/submit-draft-skill.md)
- API Reference > Skills [Restore a skill](https://docs.minikai.com/api-reference/api-reference/skills/restore-skill.md)
- API Reference > Skills [Dispose a draft skill](https://docs.minikai.com/api-reference/api-reference/skills/dispose-draft-skill.md)
- API Reference > Skills [Upload skill assets](https://docs.minikai.com/api-reference/api-reference/skills/upload-skill-assets.md)
- API Reference > Skills [Delete all skill assets](https://docs.minikai.com/api-reference/api-reference/skills/delete-skill-assets.md)
- API Reference > Skills [Delete a skill asset](https://docs.minikai.com/api-reference/api-reference/skills/delete-skill-asset.md)
- API Reference > Skills [Download a skill asset](https://docs.minikai.com/api-reference/api-reference/skills/download-skill-asset.md)
- API Reference > Users [List users](https://docs.minikai.com/api-reference/api-reference/users/get-users.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.minikai.com/openapi.json)
- [OpenAPI YAML](https://docs.minikai.com/openapi.yaml)