# OnlyWorlds Narrative API

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

OnlyWorlds Narrative 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 Narrative. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

The Narrative API from OnlyWorlds — 13 operation(s) for narrative.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v2/narrative` | List narrative elements |
| POST | `/api/v2/narrative` | Create a narrative |
| GET | `/api/v2/narrative/{id}` | Get one narrative |
| PUT | `/api/v2/narrative/{id}` | Create or replace a narrative by id |
| PATCH | `/api/v2/narrative/{id}` | Update part of a narrative |
| DELETE | `/api/v2/narrative/{id}` | Delete a narrative |
| POST | `/api/v2/narrative/{id}/links/{field}` | Add or remove ids on one of a narrative's multi-link fields |
| POST | `/api/v2/narrative/{id}/adopt` | Change who made a narrative |
| GET | `/api/v2/narrative/{id}/files` | List a narrative's files |
| POST | `/api/v2/narrative/{id}/files` | Get a ticket to attach a file to a narrative |
| GET | `/api/v2/narrative/{id}/files/{file_id}/download` | Get a download link for a narrative's file |
| DELETE | `/api/v2/narrative/{id}/files/{file_id}` | Remove a narrative's file |
| PUT | `/api/v2/narrative/{id}/hidden` | Hide a narrative |
| DELETE | `/api/v2/narrative/{id}/hidden` | Unhide a narrative |
| GET | `/api/v2/narrative/{id}/proposals` | List the proposals on narrative |
| POST | `/api/v2/narrative/{id}/proposals` | Propose a change to narrative |
| POST | `/api/v2/narrative/{id}/proposals/{pid}/accept` | Accept a proposal on narrative |
| POST | `/api/v2/narrative/{id}/proposals/{pid}/decline` | Decline a proposal on narrative |
| DELETE | `/api/v2/narrative/{id}/proposals/{pid}` | Withdraw a proposal on narrative |
| POST | `/api/v2/narrative/{id}/review` | Accept or decline a proposed new narrative |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/onlyworlds-com/openapi/onlyworlds-com-narrative-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 Account API](https://apis.io/apis/onlyworlds-com/onlyworlds-com-account-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/)

## Tags

Narrative

## 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-narrative-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/onlyworlds-com/.
