openapi: 3.0.0 info: title: Platform API version: 2 description: |- Access Platform API for create, update, list and delete Videos, & Categories. We have a newer API version available [here](https://flowplayer.com/developers/platform-api/api-reference-3.0) and support Livestreaming and Live Sources as well. ### Authentication You'll need both API key and site/workspace id in most of the API call. You can find your API key and siteid (workspaceid) under [workspace/settings](https://app.flowplayer.com/workspace/settings). ### Requesting the API Base url for the API is: https://api.flowplayer.com/ovp/ Depending on what type of request you want to make you will have to add the API key differently. In `get`-endpoints the API key is added as an query-param named `api-key` and for `post`, `put` and `delete` it's added in the request body. For example, a get video is requested as below: https://api.flowplayer.com/ovp/web/video/v2/{video_id}.json?api_key={your_api_key} **Content Type** The format, `XML` or `Json`, is determined by both `Content-Type`-header and the end of the request path. For `Json`-requests you'll need to end the request with `.json` and for `XML` with `.xml`. Example of a Create video request with `Json`: --header: Content-Type: application/json https://api.flowplayer.com/ovp/web/video/v2/create.json Example of a Create video request with `XML`: --header: Content-Type: application/xml https://api.flowplayer.com/ovp/web/video/v2/create.xml servers: - url: https://api.flowplayer.com/ovp/web/ paths: /category/v2/{id}: $ref: category.yaml#/components/paths/Category_Get /category/v2/create: $ref: category.yaml#/components/paths/Category_Create /category/v2/update: $ref: category.yaml#/components/paths/Category_Update /category/v2/site/{site_id}.{format}: $ref: category.yaml#/components/paths/Category_List /video/v2/site/{id}.{format}: $ref: video.yaml#/components/paths/Video_Workspace_List /video/v2/{id}.{format}: $ref: video.yaml#/components/paths/Video_Single /video/v2/delete.{format}: $ref: video.yaml#/components/paths/Video_Delete /video/v2/update.{format}: $ref: video.yaml#/components/paths/Video_Update /video/v2/create.{format}: $ref: video.yaml#/components/paths/Video_Create /video/v2/copy: $ref: video.yaml#/components/paths/Video_Copy /video/v2/remote.{format}: $ref: video_remote.yaml#/components/paths/Video components: tags: - name: Video description: List, upload and manage your videos. - name: Category description: Categories can be used to categorise your video and livestream in to a folder-structure.