# codai Hosts API

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

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

Host relay for remote sessions: a phone (or any client) runs terminal and file operations on one of your desktop devices that has codai desktop open — no SSH, no inbound port. Best-effort and NOT part of the public shared-sessions protocol spec: nothing is persisted, an offline host fails fast and an unanswered request fails at the client's timeout.

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/hosts` | List your devices currently connected as hosts |
| GET | `/v1/hosts/stream` | Announce this device as a host (SSE) |
| POST | `/v1/hosts/{deviceId}/exec` | Run one operation on a connected host |
| POST | `/v1/hosts/exec/{reqId}/result` | Deliver the result of an exec request |

## Machine-readable artifacts (6)

- **OpenAPI** — https://artifacts.apis.io/codai-ro/openapi/codai-ro-hosts-api-openapi.yml
- **Documentation** — https://docs.codai.ro/docs/gateway
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-host-presence-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-host-exec-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-host-exec-result-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-host-exec-response-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

Hosts

---

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