{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"517dafe1-e9a1-4832-85f2-15073dab577c","name":"Mediaflow API","description":"Mediaflow API is a REST API based on JSON data over HTTPS. All calls and answers must be in UTF-8. Calls with POST or PUT must have the HTTP header `Content-Type: application/json`except for authentication calls using POST - more about that under [Authentication](https://documenter.getpostman.com/view/18665635/UVJiiEhx#authentication). Note that the numeric ID can also be negative. All calls require authentication with OAuth2, where an access token can be sent with either in the URL as the query parameter `access_token`, e.g\n\n> GET /1/folders?access_token=igfragagsnckagnkgadciangdsnjg HTTP/1.1  \nHost: api.mediaflow.com \n  \n\nor the access token can be sent via the HTTP header `Authorization`\n\n> GET /1/folders HTTP/1.1  \nHost: api.mediaflow.com  \nAuthorization: Bearer igfragagsnckagnkgadciangdsnjg \n  \n\nThe format and length of an access token may vary.\n\nAll answers from the API on GET calls comes with a JSON array as the root object, even if the answer contains only one object. The exception is for errors (when an error object is returned), and for OAuth2 authentication. If it is an empty result, an empty array is returned `[]`.\n\n## Fields\n\nBy default, only a few selected fields are included for each endpoint. To specify exactly which fields you are interested in, send a comma-separated list with the query string parameter `fields`. The field names must be written in lower case letters.\n\n> For example:  \n[https://api.mediaflow.com/1/folder?fields=id,name,parents](https://api.mediaflow.com/1/folder?fields=id,name,parents) \n  \n\nBy entering `fields=any` you get all available fields. Avoid using `fields=any` in production (only include the fields you are interested in). Note that new fields may be added to the API over time. The field `id` is always returned and cannot be deselected.\n\n## Page division\n\nBy default, all entries are returned. If you want to limit the number of entries, you can use the query string parameters `page` and `per_page`.\n\nIf the `page` parameter is used, the total number of entries in the HTTP header `X-Total-Count` is returned.\n\n> For example:  \n[https://api.mediaflow.com/1/folder?page=1&per_page=20](https://api.mediaflow.com/1/folder?page=1&per_page=20) \n  \n\n## CORS\n\nThe API fully supports CORS calls via the HTTP header `Access-Control-Allow-Origin`, even for OPTIONS calls. If necessary, all specified HTTP headers are also listed via `Access-Control-Expose-Headers`.\n\nOPTIONS calls always return status `204 No Content` and no content.\n\n## JSONP\n\nFor all GET calls, it is also possible to get JSONP-adapted answers. Note that with JSONP, errors are always returned with HTTP status `code 200`, and the correct error code is included in the error object. Enter the function name with the query string parameter `callback`.\n\n> For example:  \n[https://api.mediaflow.com/1/folder?callback=parseResponse](https://api.mediaflow.com/1/folder?callback=parseResponse) \n  \n\n## Error handling\n\nAll errors are returned with a corresponding HTTP status code and a JSON error object.\n\n> For example:  \n400 Bad Request  \n{  \n\"status\": 400,  \n\"error\": \"Invalid JSON data\"  \n} \n  \n\n# Authentication\n\n## OAuth2\n\nAuthentication uses OAuth2 to the URL `https://accounts.mediaflow.com/1/oauth2/token` where the following `grant_type` is supported:\n\n> grant_type=password  \ngrant_type=refresh_token  \ngrant_type=authorization_code \n  \n\nAll authentication calls require that you enter a `client_id` and a `client_secret`.\n\nTo authenticate with `grant_type=authorization_code` always use the URL `https://login.mediaflowpro.com/authorize` with the following query string parameters:\n\n> `response_type` should always be \"code\"  \n`client_id` identifier for the API client  \n`redirect_uri` which URL the user should be sent to after authentication  \n`state` optional data sent back after the call (not mandatory) \n  \n\nThereafter another call is made to `https://api.mediaflow.com/1/oauth2/token` with `grant_type=authorization_code`.\n\n## Using username and password for authentication\n\nNote that not all `_client_id_` allow login with the `_grant_type=password_` _type._\n\nEnter the following parameters for calls\n\n> `grant_type` should always be `password`  \n`client_id` identifier for the API client  \n`client_secret` password for the API client  \n`username` username  \n`password` password  \n`state` optional data sent back after the call (optional) \n  \n\nUpon successful authentication, the response contains:\n\n> `access_token` access_token used for all API calls  \n`refresh_token` token to renew an access_token when it expires  \n`token_type` always \"Bearer\"  \n`expires_in` how long, in seconds, the specified access_token is valid  \n`state` the same data as in the call. Only if it was indicated at the call \n  \n\nThe value of `expires_in`, and whether a `refresh_token` is returned or not, depends on the `client_id` used for the authentication.\n\n## Renew access_token based on a refresh_token\n\nIf you have previously received a `refresh_token` it can be used to get a new valid `access_token` even if the previous `access_token` has expired.\n\nParameters for calls\n\n> `grant_type` \"refresh_token\"  \n`client_id` identifier for the API client  \n`client_secret` Password for the API client  \n`refresh_token` a refresh token from a previous call \n  \n\nUpon successful authentication, the response contains:\n\n> `access_token` access_token used for all API calls  \n`token_type` always \"Bearer\"  \n`expires_in` how long, in seconds, the specified access_token is valid \n  \n\nThe value of `expires_in` depends on the `client_id` used for the authentication.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"18665635","team":2873877,"collectionId":"517dafe1-e9a1-4832-85f2-15073dab577c","publishedId":"UVJiiEhx","public":true,"publicUrl":"https://documenter-api.postman.tech/view/18665635/UVJiiEhx","privateUrl":"https://go.postman.co/documentation/18665635-517dafe1-e9a1-4832-85f2-15073dab577c","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.0","publishDate":"2024-02-14T10:33:44.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"Production","id":"9e615c21-fac5-457e-8949-da7890005bf5","owner":"23189985","values":[{"key":"base_url","value":"https://api.mediaflow.com","enabled":true,"type":"default"},{"key":"portal_test_refreshtoken","value":"CBB0FvScukAdSQ8YOlcih0I9mO3Eq6","enabled":true},{"key":"access_token","value":"","enabled":true,"type":"any"},{"key":"shareapi_base_url","value":"https://shareapi.mediaflowpro.com","enabled":true,"type":"default"},{"key":"shareapi_access_token","value":"","enabled":true,"type":"any"},{"key":"streamapi_base_url","value":"https://m.mediaflow.com","enabled":true,"type":"default"},{"key":"statsapi_base_url","value":"https://stats.mediaflow.com","enabled":true,"type":"default"},{"key":"account_base_url","value":"https://accounts.mediaflow.com","enabled":true,"type":"default"},{"key":"client_secret","value":"Fht4ynUoqw2fmHdyhRqsOcd7hDFemo","enabled":true,"type":"default"},{"key":"client_id","value":"t7kq24V5","enabled":true,"type":"default"},{"key":"refresh_token","value":"8gFYRlfmkd4rpY4mdY3rmjMg5AKJEpLU","enabled":true,"type":"default"},{"key":"oauth_base_url","value":"https://accounts.mediaflow.com","enabled":true,"type":"default"},{"key":"shared_url","value":"1MDE98KISH","enabled":true,"type":"default"},{"key":"shareapi_oauth_base_url","value":"https://shareapi.mediaflowpro.com","enabled":true,"type":"default"},{"key":"app_base_url","value":"https://app.mediaflow.com","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/2e72fe449f764f596dfcb1845c0a1c04a51e82c79256efae277bd291abb36b93","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Production","value":"23189985-9e615c21-fac5-457e-8949-da7890005bf5"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/UVJiiEhx"}