{
  "opencollection": "1.0.0",
  "info": {
    "name": "MediaValet Open API",
    "version": "1.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{accessToken}}"
    },
    "headers": [
      { "name": "Ocp-Apim-Subscription-Key", "value": "{{subscriptionKey}}" }
    ]
  },
  "items": [
    {
      "info": { "name": "Assets", "type": "folder" },
      "items": [
        {
          "info": { "name": "Search assets.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/search", "params": [{ "name": "q", "value": "", "type": "query", "description": "Full-text search query." }] },
          "docs": "Search the library for assets matching a query, with pagination and filtering."
        },
        {
          "info": { "name": "Get an asset.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/assets/:assetId", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }] },
          "docs": "Retrieve a single asset by its identifier, including metadata and rendition links."
        },
        {
          "info": { "name": "Update an asset.", "type": "http" },
          "http": { "method": "PUT", "url": "https://api.mediavalet.com/assets/:assetId", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }], "body": { "type": "json", "data": "{}" } },
          "docs": "Update an asset's editable fields."
        },
        {
          "info": { "name": "List related assets.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/assets/:assetId/relatedassets", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }] },
          "docs": "List assets related to the given asset."
        },
        {
          "info": { "name": "List asset renditions.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/assets/:assetId/renditions", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }] },
          "docs": "List the generated renditions (thumbnails, previews, derivatives) for an asset."
        },
        {
          "info": { "name": "Get asset attributes.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/assets/:assetId/attributes", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }] },
          "docs": "Retrieve the attribute values applied to an asset."
        },
        {
          "info": { "name": "Get asset categories.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/assets/:assetId/categories", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }] },
          "docs": "List the categories an asset is filed under."
        },
        {
          "info": { "name": "Get asset keywords.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/assets/:assetId/keywords", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }] },
          "docs": "List the keywords applied to an asset."
        },
        {
          "info": { "name": "Add keywords to an asset.", "type": "http" },
          "http": { "method": "POST", "url": "https://api.mediavalet.com/assets/:assetId/keywords", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }], "body": { "type": "json", "data": "[]" } },
          "docs": "Add one or more keywords to an asset."
        },
        {
          "info": { "name": "Remove a keyword from an asset.", "type": "http" },
          "http": { "method": "DELETE", "url": "https://api.mediavalet.com/assets/:assetId/keyword/:keyword", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }, { "name": "keyword", "value": "", "type": "path", "description": "The keyword to remove." }] },
          "docs": "Remove a single keyword from an asset."
        },
        {
          "info": { "name": "Get asset comments.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/assets/:assetId/comments", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }] },
          "docs": "List comments on an asset."
        },
        {
          "info": { "name": "Get asset history.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/assets/:assetId/history", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the asset." }] },
          "docs": "Retrieve the change history / audit trail for an asset."
        },
        {
          "info": { "name": "Get video intelligence status.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/assets/:assetId/videoIntelligence/status", "params": [{ "name": "assetId", "value": "", "type": "path", "description": "The UUID of the video asset." }] },
          "docs": "Retrieve the processing status of AI video intelligence for a video asset."
        }
      ]
    },
    {
      "info": { "name": "Categories", "type": "folder" },
      "items": [
        {
          "info": { "name": "List categories.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/categories" },
          "docs": "List the categories in the library."
        },
        {
          "info": { "name": "Create a category.", "type": "http" },
          "http": { "method": "POST", "url": "https://api.mediavalet.com/categories", "body": { "type": "json", "data": "{}" } },
          "docs": "Create a new category in the library tree."
        },
        {
          "info": { "name": "Get a category.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/categories/:categoryId", "params": [{ "name": "categoryId", "value": "", "type": "path", "description": "The UUID of the category." }] },
          "docs": "Retrieve a single category by its identifier."
        },
        {
          "info": { "name": "List assets in a category.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/categories/:categoryId/assets", "params": [{ "name": "categoryId", "value": "", "type": "path", "description": "The UUID of the category." }] },
          "docs": "List the assets filed under a category."
        },
        {
          "info": { "name": "List category permission sets.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/categories/permissionSets" },
          "docs": "List the permission sets that govern access to categories."
        }
      ]
    },
    {
      "info": { "name": "Attributes", "type": "folder" },
      "items": [
        {
          "info": { "name": "List attributes.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/attributes" },
          "docs": "List the custom attribute (metadata field) definitions in the library."
        },
        {
          "info": { "name": "Create an attribute.", "type": "http" },
          "http": { "method": "POST", "url": "https://api.mediavalet.com/attributes", "body": { "type": "json", "data": "{}" } },
          "docs": "Create a new custom attribute definition."
        },
        {
          "info": { "name": "Get an attribute.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/attributes/:attributeId", "params": [{ "name": "attributeId", "value": "", "type": "path", "description": "The UUID of the attribute." }] },
          "docs": "Retrieve a single attribute definition by its identifier."
        }
      ]
    },
    {
      "info": { "name": "Keywords", "type": "folder" },
      "items": [
        {
          "info": { "name": "List keywords.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/keywords" },
          "docs": "List the keyword vocabulary for the library."
        },
        {
          "info": { "name": "Create a keyword.", "type": "http" },
          "http": { "method": "POST", "url": "https://api.mediavalet.com/keywords", "body": { "type": "json", "data": "{}" } },
          "docs": "Add a new keyword to the library vocabulary."
        },
        {
          "info": { "name": "Get a keyword.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/keywords/:keywordId", "params": [{ "name": "keywordId", "value": "", "type": "path", "description": "The UUID of the keyword." }] },
          "docs": "Retrieve a single keyword by its identifier."
        },
        {
          "info": { "name": "List keyword groups.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/keywordGroups" },
          "docs": "List the keyword groups that organize the keyword vocabulary."
        }
      ]
    },
    {
      "info": { "name": "Uploads", "type": "folder" },
      "items": [
        {
          "info": { "name": "Create an upload session.", "type": "http" },
          "http": { "method": "POST", "url": "https://api.mediavalet.com/uploads", "body": { "type": "json", "data": "{}" } },
          "docs": "Create an upload session for a new file. The response returns the storage location and identifiers used to transfer chunks and commit the upload."
        },
        {
          "info": { "name": "Get an upload session.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/uploads/:uploadId", "params": [{ "name": "uploadId", "value": "", "type": "path", "description": "The UUID of the upload session." }] },
          "docs": "Retrieve the status of an upload session."
        },
        {
          "info": { "name": "Commit an upload session.", "type": "http" },
          "http": { "method": "POST", "url": "https://api.mediavalet.com/uploads/:uploadId", "params": [{ "name": "uploadId", "value": "", "type": "path", "description": "The UUID of the upload session." }] },
          "docs": "Commit a completed upload session so MediaValet processes the file into a managed asset."
        }
      ]
    },
    {
      "info": { "name": "Users", "type": "folder" },
      "items": [
        {
          "info": { "name": "List users.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/users" },
          "docs": "List the users in the organization."
        },
        {
          "info": { "name": "Get the current user.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/users/current" },
          "docs": "Retrieve the profile of the authenticated user."
        },
        {
          "info": { "name": "Get the current user's permissions.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/users/current/permissions" },
          "docs": "Retrieve the effective permissions of the authenticated user."
        },
        {
          "info": { "name": "List approvers.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/users/approvers" },
          "docs": "List the users who can approve requests within the organizational unit."
        },
        {
          "info": { "name": "List user groups.", "type": "http" },
          "http": { "method": "GET", "url": "https://api.mediavalet.com/groups" },
          "docs": "List the user groups in the organization."
        }
      ]
    }
  ]
}