
# Import an Asset

Import a video `Asset` to Livepeer from an external URL through the
`POST /api/asset/import` API.

```jsx
curl --location --request POST 'https://livepeer.com/api/asset/import' \
--header 'Authorization: Bearer $API_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url":"$EXTERNAL_URL",
    "name":"Example name"
}'
```

### Request body parameters

<Table
  data={[
    {
      parameter: <code>url</code>,
      type: <code>string</code>,
      description: "The URL of the file that Livepeer should download and use.",
    },
    {
      parameter: <code>name</code>,
      type: <code>string</code>,
      description:
        "The name of the `Asset` containing a custom human-readable description or title.",
    },
  ]}
/>

## How do I import a Live stream into my Assets?

Livepeer live stream recordings are automatically imported as `Asset` objects.
All you need to do is enable recording on your streams.

When the stream session ends, the platform waits `6min` to give a chance for the
user to reconnect on the same recording session. After that delay, the recording
is processed and you should have a new asset in your account which you can
retrieve from the list assets API.


parameter	type	description
`url`	`string`	The URL of the file that Livepeer should download and use.
`name`	`string`	The name of the `Asset` containing a custom human-readable description or title.