---
title: "Create Story"
method: POST
path: "/api/v1/stories"
tags: ["api", "api", "stories"]
---

# Create Story

`POST /api/v1/stories`

## Request

- Base URL: `https://www.faroz.uz` (the document declares no server; this is the origin it was published from)
- URL: `https://www.faroz.uz/api/v1/stories`
- Auth: HTTP bearer

## Request body

- StoryCreate
  - `title` string, required
  - `content` string
  - `type` string
  - `genre` string
  - `theme` string
  - `status` string
  - `author_name` string, nullable
  - `audio_url` string, nullable

## Response `201`

Successful Response

- Story
  - `id` string, required
  - `title` string, required
  - `content` string
  - `type` string
  - `genre` string
  - `theme` string
  - `status` string
  - `author_name` string
  - `audio_url` string, nullable
  - `created_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/faroz/apis/edu-app-api.md) · [All operations](https://skmtc.dev/faroz/apis/edu-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faroz/apis/edu-app-api/revisions/414a551ba773?raw)