> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.labric.co/api-reference/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.labric.co/_mcp/server.

# API Reference


## API Docs

- Labric API > Instruments [Get an instrument's device status history](https://docs.labric.co/api-reference/labric-api/instruments/get-device-status-history.md)
- Labric API > Files [List files](https://docs.labric.co/api-reference/labric-api/files/list.md)
- Labric API > Files [Upload a small file in one request](https://docs.labric.co/api-reference/labric-api/files/upload.md)
- Labric API > Files [Create an upload URL](https://docs.labric.co/api-reference/labric-api/files/create-upload-url.md)
- Labric API > Files [Confirm an upload](https://docs.labric.co/api-reference/labric-api/files/confirm-upload.md)
- Labric API > Files [Get a file's content](https://docs.labric.co/api-reference/labric-api/files/get-content.md)
- Labric API > Agent [Run](https://docs.labric.co/api-reference/labric-api/agent/run.md)
- Labric API > Jobs [List jobs](https://docs.labric.co/api-reference/labric-api/jobs/list.md)
- Labric API > Jobs [Create a job](https://docs.labric.co/api-reference/labric-api/jobs/create.md)
- Labric API > Jobs [Update a job](https://docs.labric.co/api-reference/labric-api/jobs/update.md)
- Labric API > Jobs [Start a job execution](https://docs.labric.co/api-reference/labric-api/jobs/start.md)
- Labric API > Jobs [Close a job execution](https://docs.labric.co/api-reference/labric-api/jobs/close.md)
- Labric API > Jobs [Revert a job execution](https://docs.labric.co/api-reference/labric-api/jobs/revert.md)
- Labric API > Tools [Write](https://docs.labric.co/api-reference/labric-api/tools/write.md)
- Labric API > Tools [Read](https://docs.labric.co/api-reference/labric-api/tools/read.md)
- Labric API > Tools [Execute Sql](https://docs.labric.co/api-reference/labric-api/tools/execute-sql.md)
- Labric API > Tools [Get Schema](https://docs.labric.co/api-reference/labric-api/tools/get-schema.md)
- Labric API > Tools [Batch Write](https://docs.labric.co/api-reference/labric-api/tools/batch-write.md)
- Labric API > Images [List annotations on an image](https://docs.labric.co/api-reference/labric-api/images/list-annotations.md)
- Labric API > Images [Save annotations on an image](https://docs.labric.co/api-reference/labric-api/images/annotate.md)
- Labric API > Data [Write data](https://docs.labric.co/api-reference/labric-api/data/write.md)
- Labric API > Notifications [Send a notification](https://docs.labric.co/api-reference/labric-api/notifications/send.md)
- Labric API > Models [Run predictions](https://docs.labric.co/api-reference/labric-api/models/predict.md)
- Labric API > Models [Get a model](https://docs.labric.co/api-reference/labric-api/models/get.md)
- Labric API > Models [List models](https://docs.labric.co/api-reference/labric-api/models/list.md)
- Labric API > Models [Train a model](https://docs.labric.co/api-reference/labric-api/models/train.md)
- Labric API > Models [Cancel training](https://docs.labric.co/api-reference/labric-api/models/cancel-training.md)

## OpenAPI Specification

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


> **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.labric.co/api-reference/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.labric.co/_mcp/server.

# API reference

The Labric API is a REST API served from:

```
https://platform.labric.co/api
```

Every endpoint authenticates with a Bearer API key (`lbk_...`) in the `Authorization` header. Keys are scoped to **read**, **write**, or **admin** — each endpoint's documentation notes the scope it requires. See the [Introduction](/welcome) for how to create a key.

The [Python SDK](https://pypi.org/project/labric/) wraps these endpoints one-to-one:

```python
from labric import Labric

client = Labric(api_key="lbk_your_api_key")
```

Inside a [Labric Job](https://platform.labric.co/jobs), `Labric()` picks up the pre-provisioned `LABRIC_API_KEY` automatically.