# OnlyWorlds Account API

**Canonical:** https://apis.io/apis/onlyworlds-com/onlyworlds-com-account-api/  
**Provider:** OnlyWorlds — https://apis.io/providers/onlyworlds-com/  
**Base URL:** https://www.onlyworlds.com  
**Documentation:** https://www.onlyworlds.com/api/docs

OnlyWorlds Account API is one of 33 APIs that [OnlyWorlds](https://apis.io/providers/onlyworlds-com/) 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 Account. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Your account, worlds, keys, members and invites, with an `ow_a_` account token. A page signed in with the site's own session cookie sends the `csrftoken` cookie's value in the `X-CSRFToken` header on every write.

## Operations (46)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v2/account/ask` | Ask |
| POST | `/api/v2/account/sort` | Sort Notes |
| GET | `/api/v2/account/allowance` | Read this account's daily token rating |
| GET | `/api/v2/account` | Get Profile |
| PATCH | `/api/v2/account` | Patch Profile |
| GET | `/api/v2/account/worlds` | List Worlds |
| POST | `/api/v2/account/worlds` | Create World |
| POST | `/api/v2/account/worlds/handover` | Handover World |
| GET | `/api/v2/account/worlds/holding/{element_id}` | Holding World |
| GET | `/api/v2/account/worlds/made` | Made World |
| POST | `/api/v2/account/worlds/{world_id}/keys` | Mint World Key |
| GET | `/api/v2/account/worlds/{world_id}/keys` | List World Keys |
| GET | `/api/v2/account/worlds/{world_id}/keys/made` | Made World Key |
| DELETE | `/api/v2/account/worlds/{world_id}/keys/{key_id}` | Revoke World Key |
| POST | `/api/v2/account/worlds/{world_id}/invites` | Create Invite |
| DELETE | `/api/v2/account/worlds/{world_id}/invites/{invite_id}` | Cancel Invite |
| GET | `/api/v2/account/worlds/{world_id}/members` | List Members |
| DELETE | `/api/v2/account/worlds/{world_id}/members/{member_id}` | Remove Member |
| PATCH | `/api/v2/account/worlds/{world_id}/members/{member_id}` | Change Member Role |
| POST | `/api/v2/account/worlds/{world_id}/seats` | Create World Seat |
| GET | `/api/v2/account/worlds/{world_id}/seats` | List World Seats |
| DELETE | `/api/v2/account/worlds/{world_id}/seats/{seat_id}` | Remove World Seat |
| POST | `/api/v2/account/worlds/{world_id}/seats/{seat_id}/key` | Rekey World Seat |
| POST | `/api/v2/account/worlds/{world_id}/leave` | Leave World |
| POST | `/api/v2/account/worlds/{world_id}/read` | Mark messages read (your Read mark) |
| POST | `/api/v2/account/worlds/{world_id}/messages` | Send a message (as your own Character) |
| POST | `/api/v2/account/worlds/{world_id}/links` | Create World Link |
| GET | `/api/v2/account/worlds/{world_id}/links` | List World Links |
| DELETE | `/api/v2/account/worlds/{world_id}/links/{link_id}` | Revoke World Link |
| GET | `/api/v2/account/invites` | List My Invites |
| POST | `/api/v2/account/invites/{invite_id}/accept` | Accept Invite |
| POST | `/api/v2/account/join` | Accept Link |
| POST | `/api/v2/account/invites/{invite_id}/refuse` | Refuse Invite |
| GET | `/api/v2/account/watched` | List Watched |
| POST | `/api/v2/account/watched` | Add Watched |
| DELETE | `/api/v2/account/watched/{watch_id}` | Remove Watched |
| POST | `/api/v2/account/tokens` | Mint Token |
| GET | `/api/v2/account/tokens` | List Tokens |
| DELETE | `/api/v2/account/tokens/{token_id}` | Revoke Token |
| DELETE | `/api/v2/account/clients/{client_id}` | Disconnect Client |
| GET | `/api/v2/account/ai` | List the AI uses |
| POST | `/api/v2/account/ai/ask` | Ask a question about a world (the ask use) |
| POST | `/api/v2/account/ai/sort` | Sort notes into proposed changes (the sort use) |
| POST | `/api/v2/account/ai/subs-jev` | One decision by Jev for a Subs seat (the subs-jev use) |
| POST | `/api/v2/account/ai/subs-captain` | One order from a model for a Subs captain (the subs-captain use) |
| POST | `/api/v2/account/ai/lens` | Propose a lens from a sentence (the lens use) |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/onlyworlds-com/openapi/onlyworlds-com-account-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/onlyworlds-com/json-schema/onlyworlds-com-narrative-schema.json

## Other OnlyWorlds APIs (12)

- [OnlyWorlds Ability API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-ability-api/)
- [OnlyWorlds Bulk API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-bulk-api/)
- [OnlyWorlds Changes API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-changes-api/)
- [OnlyWorlds Character API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-character-api/)
- [OnlyWorlds Collective API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-collective-api/)
- [OnlyWorlds Construct API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-construct-api/)
- [OnlyWorlds Creature API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-creature-api/)
- [OnlyWorlds Event API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-event-api/)
- [OnlyWorlds Family API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-family-api/)
- [OnlyWorlds Files API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-files-api/)
- [OnlyWorlds Health API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-health-api/)
- [OnlyWorlds Institution API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-institution-api/)

## Tags

Account

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/onlyworlds-com` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

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