# codai Prompts API

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

codai Prompts 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 1 JSON Schema definition. Tagged areas include Prompts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

Pending prompts: ready-to-paste prompts an agent (or you) leaves for a future chat — the handoff at the end of a goal, a follow-up that must wait until a date, or an idea to pick up later. Capture paths (the Copilot Stop hook, the desktop handoff tool, the phone, the hub) all POST here; the same text is stored once (sha256 of the whitespace-normalised prompt) and a `goal_key` supersedes older open prompts for the same goal. A prompt with `not_before` is swept once that moment passes: you get a `prompt.due` notification (url `codai://prompts/<id>`, plus push) and, with `auto_run`, it is launched on `target_device_id` (or your freshest desktop/Android device). `launch` opens a new shared session and sends the prompt to a device as a `send` control; the prompt moves to `launched`. Every route needs a `codai_` key and only sees your prompts.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/prompts` | List pending prompts |
| POST | `/v1/prompts` | Save a prompt for later |
| GET | `/v1/prompts/export` | Export prompts as CSV or Markdown |
| POST | `/v1/prompts/bulk` | Apply one action to many prompts |
| GET | `/v1/prompts/{id}` | Get a prompt |
| PATCH | `/v1/prompts/{id}` | Edit, snooze or close a prompt |
| DELETE | `/v1/prompts/{id}` | Delete a prompt |
| GET | `/v1/prompts/{id}/events` | Prompt history |
| POST | `/v1/prompts/{id}/instantiate` | Create a prompt from a template |
| POST | `/v1/prompts/{id}/launch` | Start a chat from a prompt |
| GET | `/v1/prompts/stream` | Stream prompt changes (SSE) |
| POST | `/v1/prompts/verify` | Verify several prompts |
| POST | `/v1/prompts/{id}/match` | Record that a prompt was sent in a chat |
| POST | `/v1/prompts/{id}/verify` | Verify that a prompt was done |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/codai-ro/openapi/codai-ro-prompts-api-openapi.yml
- **Documentation** — https://docs.codai.ro/docs/gateway
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-prompt-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

Prompts

---

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