---
title: "Create a season"
method: POST
path: "/v2/sites/{site_id}/series/{series_id}/seasons/"
tags: ["series"]
---

# Create a season

`POST /v2/sites/{site_id}/series/{series_id}/seasons/`

## Path parameters

- `site_id` string, required — Unique identifier for a resource
- `series_id` string, required — Unique identifier for a resource

## Request body

- object
  - `metadata` object, required
    - `title` string — Title of the season When a `title` is not specified, the `number` value is used for the season title.
    - `number` number, required — Number of the season
    - `description` string — Description of the season
  - `relationships` SeriesResourceRelationship, required
    - `media` object[] — List of media IDs and the associated episode number for each
      - `id` string, required — Unique identifier for a resource
      - `episode_number` number, required — Episode number of the media

## Response `201`

Resource successfully created

- SeasonResourceRead
  - `schema` string
  - `id` string — Unique identifier for a resource
  - `created` string — Date and time at which the resource was created
  - `last_modified` string — Date and time at which the resource was most recently modified
  - `type` string — Name of the type of resource.
  - `relationships` object — Ancilliary resources associated to the primary resource being read
    - `media` object[] — List of media IDs and the associated episode number for each
      - `id` string, required — Unique identifier for a resource
      - `episode_number` number, required — Episode number of the media
  - `metadata` SeasonResourceMetadata
    - `title` string — Title of the season When a `title` is not specified, the `number` value is used for the season title.
    - `number` number — Number of the season
    - `description` string — Description of the season
  - `episode_count` number — Number of episodes associated with the season
  - `total_duration` number — Total runtime of the season in minutes

## Other responses

- `400` — Bad Request The request either lacks certain attributes or contains malformed/invalid attributes.

---

[API](https://skmtc.net/jwplayer/apis/management-api-v2.md) · [All operations](https://skmtc.net/jwplayer/apis/management-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jwplayer/management-api-v2/revisions/180db7cada27/schema)