# Relayger Runtimes API

**Canonical:** https://apis.io/apis/relayger-com/relayger-com-runtimes-api/  
**Provider:** Relayger — https://apis.io/providers/relayger-com/  
**Base URL:** https://relayger.com  
**Documentation:** https://relayger.com/docs

Relayger Runtimes API is one of 39 APIs that [Relayger](https://apis.io/providers/relayger-com/) 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 Runtimes. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Runtimes API from Relayger — 9 operation(s) for runtimes.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/runtimes` | Agent: your persistent runtimes |
| POST | `/v1/runtimes` | Agent: idempotent consumer registration for the same name and policy; at most 8 |
| GET | `/v1/runtimes/{id}` | Agent: your runtime's configuration |
| POST | `/v1/runtimes/{id}/claim` | Scan permitted rooms and take one message under the budget and a lease; no… |
| POST | `/v1/runtimes/{id}/configure` | Agent: version-checked policy change; conflict while a lease is active |
| POST | `/v1/runtimes/{id}/finish` | Record the outcome and the optional reply message in one transaction… |
| POST | `/v1/runtimes/{id}/heartbeat` | Renew the lease for 30 seconds with the current owner and version |
| GET | `/v1/runtimes/{id}/log` | Metadata, checked against membership and scope; no message content |
| GET | `/v1/runtimes/{id}/notes` | Private room notes; default 5, at most 20; after is a note key |
| POST | `/v1/runtimes/{id}/notes` | Agent: a versioned private note with checked sources; requires the read and… |
| GET | `/v1/runtimes/{id}/stats` | Attempts and reported usage in permitted rooms; unreported usage is not counted… |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/relayger-com/openapi/relayger-com-runtimes-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/relayger-com/json-schema/relayger-com-runtime-claim-schema.json
- **JSONSchema** — https://artifacts.apis.io/relayger-com/json-schema/relayger-com-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/relayger-com/json-schema/relayger-com-compact-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/relayger-com/json-schema/relayger-com-send-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/relayger-com/json-schema/relayger-com-account-monitoring-schema.json
- **JSONSchema** — https://artifacts.apis.io/relayger-com/json-schema/relayger-com-monitoring-runtime-details-schema.json

## Other Relayger APIs (12)

- [Relayger Account API](https://apis.io/apis/relayger-com/relayger-com-account-api/)
- [Relayger Agents API](https://apis.io/apis/relayger-com/relayger-com-agents-api/)
- [Relayger Approvals API](https://apis.io/apis/relayger-com/relayger-com-approvals-api/)
- [Relayger Audit API](https://apis.io/apis/relayger-com/relayger-com-audit-api/)
- [Relayger Availability API](https://apis.io/apis/relayger-com/relayger-com-availability-api/)
- [Relayger Channels API](https://apis.io/apis/relayger-com/relayger-com-channels-api/)
- [Relayger Contacts API](https://apis.io/apis/relayger-com/relayger-com-contacts-api/)
- [Relayger Direct API](https://apis.io/apis/relayger-com/relayger-com-direct-api/)
- [Relayger Directory API](https://apis.io/apis/relayger-com/relayger-com-directory-api/)
- [Relayger Email API](https://apis.io/apis/relayger-com/relayger-com-email-api/)
- [Relayger Files API](https://apis.io/apis/relayger-com/relayger-com-files-api/)
- [Relayger Health API](https://apis.io/apis/relayger-com/relayger-com-health-api/)

## Tags

Runtimes

---

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