# RomM States API

**Canonical:** https://apis.io/apis/romm/romm-states-api/  
**Provider:** RomM — https://apis.io/providers/romm/  
**Base URL:** https://demo.romm.app  
**Documentation:** https://docs.romm.app/latest/developers/api-reference/

RomM States API is one of 33 APIs that [RomM](https://apis.io/providers/romm/) 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 states. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The states API from RomM — 9 operation(s) for states.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/states` | Add State |
| GET | `/api/states` | Get States |
| GET | `/api/states/identifiers` | Get State Identifiers |
| GET | `/api/states/{id}` | Get State |
| PUT | `/api/states/{id}` | Update State |
| GET | `/api/states/{id}/content` | Download State |
| PUT | `/api/states/{id}/visibility` | Update State Visibility |
| PUT | `/api/states/{id}/favorite` | Update State Favorite |
| PUT | `/api/states/{id}/labels` | Update State Labels |
| PUT | `/api/states/{id}/file-name` | Rename State |
| POST | `/api/states/delete` | Delete States |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/romm/openapi/romm-states-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/romm/json-schema/romm-detailed-rom-schema-schema.json
- **JSONSchema** — https://artifacts.apis.io/romm/json-schema/romm-simple-rom-schema-schema.json
- **JSONSchema** — https://artifacts.apis.io/romm/json-schema/romm-config-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/romm/json-schema/romm-body-update-rom-api-roms-id-put-schema.json
- **JSONSchema** — https://artifacts.apis.io/romm/json-schema/romm-platform-schema-schema.json
- **JSONSchema** — https://artifacts.apis.io/romm/json-schema/romm-search-rom-schema-schema.json

## Other RomM APIs (12)

- [RomM Activity API](https://apis.io/apis/romm/romm-activity-api/)
- [RomM Audit API](https://apis.io/apis/romm/romm-audit-api/)
- [RomM Auth API](https://apis.io/apis/romm/romm-auth-api/)
- [RomM Client Tokens API](https://apis.io/apis/romm/romm-client-tokens-api/)
- [RomM Collections API](https://apis.io/apis/romm/romm-collections-api/)
- [RomM Config API](https://apis.io/apis/romm/romm-config-api/)
- [RomM Device Auth API](https://apis.io/apis/romm/romm-device-auth-api/)
- [RomM Devices API](https://apis.io/apis/romm/romm-devices-api/)
- [RomM Export API](https://apis.io/apis/romm/romm-export-api/)
- [RomM Feeds API](https://apis.io/apis/romm/romm-feeds-api/)
- [RomM Firmware API](https://apis.io/apis/romm/romm-firmware-api/)
- [RomM Logs API](https://apis.io/apis/romm/romm-logs-api/)

## Tags

states

---

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