# Create

put ` https://app.mk.io/api/v1/projects/:project_name/media/liveEvents/:event_name/liveOutputs/:output_name`

Creates a Live Output

RBAC Capability Required: `ams.liveeventoutput.create`

## Authentication

Authorization Bearer

Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Path parameters

- **project_name** string Required
- **event_name** string Required
- **output_name** string Required

## Request

This endpoint expects an object.

### properties object [LiveOutputPutProperties](https://docs.mediakind.com/api-reference/media-api/schemas/liveoutputputproperties) Required

The properties of the live output.

#### Show 7 properties

- **archiveWindowLength** string Required
  - ISO 8601 timespan duration of the archive window length. This is duration that customer want to retain the recorded content.
- **assetName** string Required
  - 1-260 characters
  - The name of the asset that the live output will write to.
- **description** string Optional
  - 0-4096 characters
  - The description of the live output.
- **hls object** [LiveOutputHls](https://docs.mediakind.com/api-reference/media-api/schemas/liveoutputhls) Optional

#### Show 1 property

- **fragmentsPerTsSegment** integer Optional
  - 1 to 100000000 Defaults to 1
  - The number of fragments per HLS segment.
- **manifestName** string Optional
  - 1-64 characters pattern: ^[a-zA-Z0-9\\-]+[a-zA-Z0-9]$
  - The name of the manifest file. If not provided, the service will generate one automatically. This is the filename that will appear in playback URLs.
- **outputSnapTime** integer Optional
  - Defaults to 0
  - Not supported. The output snapshot time. This is the wall clock time, in unix epoch seconds, that the live output will begin recording from.
- **rewindWindowLength** string Optional
  - Not supported. ISO 8601 timespan duration of the rewind window length during live playback. This is the amount of time that the live output will be able to rewind.

## Response

201 Live Output created

- **name** string Optional
  - 1-256 characters pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
  - The name of the resource
- **properties object** [LiveOutputProperties](https://docs.mediakind.com/api-reference/media-api/schemas/liveoutputproperties) Required

The properties of the live output.

#### Show 11 properties

- **archiveWindowLength** string Required
  - ISO 8601 timespan duration of the archive window length. This is duration that customer want to retain the recorded content.
- **assetName** string Required
  - 1-260 characters
  - The name of the asset that the live output will write to.
- **created** string Optional
  - The exact time the live output was created.
- **description** string Optional
  - 0-4096 characters
  - The description of the live output.
- **hls object** [LiveOutputHls](https://docs.mediakind.com/api-reference/media-api/schemas/liveoutputhls) Optional

#### Show 1 property

- **fragmentsPerTsSegment** integer Optional
  - 1 to 100000000 Defaults to 1
  - The number of fragments per HLS segment.
- **lastModified** string Optional
  - The exact time the live output was last modified.
- **manifestName** string Optional
  - 1-64 characters pattern: ^[a-zA-Z0-9\\-]+[a-zA-Z0-9]$
  - The name of the manifest file. If not provided, the service will generate one automatically. This is the filename that will appear in playback URLs.
- **outputSnapTime** integer Optional
  - Defaults to 0
  - Not supported. The output snapshot time. This is the wall clock time, in unix epoch seconds, that the live output will begin recording from.
- **provisioningState** string Optional
  - The provisioning state of the live output.
- **resourceState enum** Optional
  - The resource state of the live output.
  - Allowed values: Creating, Deleting, Running
- **rewindWindowLength** string Optional
  - Not supported. ISO 8601 timespan duration of the rewind window length during live playback. This is the amount of time that the live output will be able to rewind.

## Errors

### 400 Bad Request

- **error object** [ErrorDetail](https://docs.mediakind.com/api-reference/media-api/schemas/errordetail) Required
- Pertinent information about the error

#### Show 3 properties

- **code** string Required
- **detail** string Required
- **extraDetail map from strings to any Optional**
  - Extra information regarding this error.

#### Show value schema Hide value schema

- **[any key] any**
- **ref string Required**
  - A reference to the request that caused the error.
- **status integer Required**
  - The HTTP status code

### 401 Unauthorized

... [Similar structure for all other error responses]