# codai Triggers API

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

codai Triggers 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. Tagged areas include Triggers. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Event triggers: an inbound webhook source you own (GitHub, Sentry, GCP Cloud Monitoring, a generic signed JSON sender, a form, or a manual fire) that turns each delivery into a normalized event card and runs it through a policy — `notify` (inbox only, the default), `assisted`, `autopilot`, or `smart` (severity, keywords and subject decide). A started event opens a shared session `trigger:<id>:<delivery>` and dispatches a `send` control to your freshest online desktop or Android device; with nobody online it degrades to a notification. Deliveries are idempotent per (trigger, delivery id), repeated dedupe keys append to the open session, resolved events close it, and failed deliveries are retried every 60 s (at most 5 attempts). The owner API needs a `codai_` key and only ever sees your own triggers — a foreign or malformed id is 404. The signing secret is shown exactly once, on create and on rotate; it is stored sealed and never returned again.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/triggers` | List your triggers |
| POST | `/v1/triggers` | Create a trigger |
| PATCH | `/v1/triggers/{id}` | Rename, enable/disable or re-configure a trigger |
| DELETE | `/v1/triggers/{id}` | Delete a trigger |
| POST | `/v1/triggers/{id}/rotate-secret` | Rotate a trigger's signing secret |
| PUT | `/v1/triggers/{id}/secret` | Set a source-issued signing secret |
| POST | `/v1/triggers/{id}/test` | Fire a test event through the full pipeline |
| GET | `/v1/triggers/{id}/events` | Recent deliveries of a trigger and their decisions |
| GET | `/v1/notifications` | Your notification inbox |
| POST | `/v1/notifications/read` | Mark notifications as read |
| DELETE | `/v1/notifications/{id}` | Delete a notification |
| POST | `/v1/notifications/delete` | Delete notifications in bulk |
| POST | `/v1/hooks/{id}` | Webhook ingress (signature-authenticated) |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/codai-ro/openapi/codai-ro-triggers-api-openapi.yml
- **Documentation** — https://docs.codai.ro/docs/gateway

## 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

Triggers

---

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