# Balladic Narrative API

**Canonical:** https://apis.io/apis/balladic-com/balladic-com-narrative-api/  
**Provider:** Balladic — https://apis.io/providers/balladic-com/  
**Base URL:** https://api.balladic.com  
**Documentation:** https://api.balladic.com

Balladic Narrative API is one of 42 APIs that [Balladic](https://apis.io/providers/balladic-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 Narrative. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The narrative API from Balladic — 8 operation(s) for narrative.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/narrative` | Get Narrative |
| GET | `/narrative/first` | Get First Narrative |
| POST | `/narrative/first/seen` | See First Narrative |
| GET | `/narrative/ballads` | Get Ballad Narratives |
| GET | `/narrative/ballads/{project_id}` | Get Ballad Narrative |
| GET | `/narrative/{user_id}` | Get Narrative For User |
| POST | `/narrative/refresh` | Refresh Narrative |
| POST | `/narrative/ballads/refresh` | Refresh Ballad Narratives |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/balladic-com/openapi/balladic-com-narrative-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/balladic-com/json-schema/balladic-com-project-list-item-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/balladic-com/json-schema/balladic-com-project-detail-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/balladic-com/json-schema/balladic-com-org-billing-status-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/balladic-com/json-schema/balladic-com-task-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/balladic-com/json-schema/balladic-com-notification-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/balladic-com/json-schema/balladic-com-user-response-schema.json

## Other Balladic APIs (12)

- [Balladic Admin API](https://apis.io/apis/balladic-com/balladic-com-admin-api/)
- [Balladic Augments API](https://apis.io/apis/balladic-com/balladic-com-augments-api/)
- [Balladic Auth API](https://apis.io/apis/balladic-com/balladic-com-auth-api/)
- [Balladic Balladic API](https://apis.io/apis/balladic-com/balladic-com-balladic-api-api/)
- [Balladic Billing API](https://apis.io/apis/balladic-com/balladic-com-billing-api/)
- [Balladic Board API](https://apis.io/apis/balladic-com/balladic-com-board-api/)
- [Balladic Chat API](https://apis.io/apis/balladic-com/balladic-com-chat-api/)
- [Balladic Columns API](https://apis.io/apis/balladic-com/balladic-com-columns-api/)
- [Balladic Comments API](https://apis.io/apis/balladic-com/balladic-com-comments-api/)
- [Balladic Contact API](https://apis.io/apis/balladic-com/balladic-com-contact-api/)
- [Balladic Contacts API](https://apis.io/apis/balladic-com/balladic-com-contacts-api/)
- [Balladic Containers API](https://apis.io/apis/balladic-com/balladic-com-containers-api/)

## Tags

Narrative

---

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