# codai Lists API

**Canonical:** https://apis.io/apis/codai-ro/codai-ro-lists-api/  
**Provider:** codai — https://apis.io/providers/codai-ro/  
**Base URL:** https://ai.codai.ro  
**Documentation:** https://docs.codai.ro/docs/api

codai Lists API is one of 35 APIs that [codai](https://apis.io/providers/codai-ro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include List. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Lists and Share to codai: Inbox, Wishlist, Notes (presets, created on first use) and your own lists, filled from the OS share sheet, the desktop, the hub, MCP or the API. Sharing is instant; link unfurling (title, image, price, availability) and the Inbox list suggestion run in the background and are announced on `GET /v1/lists/stream`. Images, video and PDFs (at most 10 MB) are uploaded first with tus (`/v1/uploads`, metadata `purpose=list`) and attached by `media_key`. Every route needs an API key and only sees your lists.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/lists` | List lists |
| POST | `/v1/lists` | Create a list |
| PATCH | `/v1/lists/order` | Reorder lists |
| GET | `/v1/lists/stream` | Stream list changes |
| PATCH | `/v1/lists/items/{itemId}` | Update a list item |
| DELETE | `/v1/lists/items/{itemId}` | Delete a list item |
| GET | `/v1/lists/items/{itemId}/image` | Get an item image |
| PATCH | `/v1/lists/{id}` | Update a list |
| DELETE | `/v1/lists/{id}` | Delete a list |
| GET | `/v1/lists/{id}/items` | List items of a list |
| POST | `/v1/lists/{id}/items` | Add an item to a list |
| GET | `/v1/lists/{id}/export.md` | Export a list as Markdown |
| POST | `/v1/share` | Share to codai |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/codai-ro/openapi/codai-ro-lists-api-openapi.yml
- **Documentation** — https://docs.codai.ro/docs/gateway
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-list-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-list-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-share-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-list-item-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-list-create-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-list-item-patch-input-schema.json

## Other codai APIs (12)

- [codai Account API](https://apis.io/apis/codai-ro/codai-ro-account-api/)
- [codai Agents API](https://apis.io/apis/codai-ro/codai-ro-agents-api/)
- [codai Attestations API](https://apis.io/apis/codai-ro/codai-ro-attestations-api/)
- [codai Authorization API](https://apis.io/apis/codai-ro/codai-ro-authorization-api/)
- [codai Chat & Completions API](https://apis.io/apis/codai-ro/codai-ro-chat-completions-api/)
- [codai Connect API](https://apis.io/apis/codai-ro/codai-ro-connect-api/)
- [codai Devices API](https://apis.io/apis/codai-ro/codai-ro-devices-api/)
- [codai Discovery API](https://apis.io/apis/codai-ro/codai-ro-discovery-api/)
- [codai Embeddings & Audio API](https://apis.io/apis/codai-ro/codai-ro-embeddings-audio-api/)
- [codai Feed API](https://apis.io/apis/codai-ro/codai-ro-feed-api/)
- [codai Guest chat API](https://apis.io/apis/codai-ro/codai-ro-guest-chat-api/)
- [codai Health API](https://apis.io/apis/codai-ro/codai-ro-health-api/)

## Tags

List

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/codai-ro/codai-ro-lists-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/codai-ro/.
