# api.video API Documentation

This is the complete API documentation for connecting to the api.video API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **api.video connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/apivideo/actions/{actionSlug}/run
```

## api.video actions

- PUT `complete-a-live-stream` Complete a live stream
- POST `create-a-player` Create a player
- POST `create-a-video-object` Create a video object
- POST `create-live-stream` Create live stream
- POST `create-webhook` Create Webhook
- DELETE `delete-a-live-stream` Delete a live stream
- DELETE `delete-a-player` Delete a player
- DELETE `delete-a-video-object` Delete a video object
- DELETE `delete-a-webhook` Delete a Webhook
- DELETE `delete-an-upload-token` Delete an upload token
- DELETE `delete-video-summary` Delete video summary
- POST `generate-an-upload-token` Generate an upload token
- POST `generate-video-summary` Generate video summary
- POST `get-bearer-token` Get Bearer Token
- GET `get-summary-details` Get summary details
- GET `list-all-active-upload-tokens` List all active upload tokens
- GET `list-all-live-streams` List all live streams
- GET `list-all-player-themes` List all player themes
- GET `list-videos` List all video objects
- GET `list-all-video-tags` List all video tags
- GET `list-all-webhooks` List all webhooks
- GET `list-summaries` List summaries
- POST `refresh-bearer-token` Refresh Bearer Token
- GET `retrieve-a-player` Retrieve a player
- GET `retrieve-a-video-object` Retrieve a video object
- GET `retrieve-aggregated-metrics` Retrieve aggregated metrics
- GET `retrieve-live-stream` Retrieve live stream
- GET `retrieve-metrics-in-a-breakdown-of-dimensions` Retrieve metrics in a breakdown of dimensions
- GET `retrieve-metrics-over-time` Retrieve metrics over time
- GET `retrieve-upload-token` Retrieve upload token
- GET `retrieve-video-status-and-details` Retrieve video status and details
- GET `retrieve-webhook-details` Retrieve Webhook details
- PUT `update-a-live-stream` Update a live stream
- PUT `update-a-player` Update a player
- PUT `update-a-video-object` Update a video object
- PUT `update-summary-details` Update summary details