MediaValet

MediaValet OrgUnit API

Organizational units (libraries) — the MediaValet tenancy root that every asset, category and event is scoped to. 15 operations.

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.mediavalet.com/
📖
APIReference
https://docs.mediavalet.com/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mediavalet/refs/heads/main/openapi/mediavalet-org-unit-api-openapi.yml

Other Resources

🔗
DeveloperPortal
https://developer.mediavalet.com/
🔗
Postman
https://raw.githubusercontent.com/api-evangelist/mediavalet/refs/heads/main/collections/mediavalet-api.postman_collection.json
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/mediavalet/refs/heads/main/collections/mediavalet-api.postman_collection.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mediavalet-org-unit-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mediavalet-org-unit-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: MediaValet OrgUnit API
  description: |-
    The MediaValet API is a RESTful, JSON, hypermedia-driven service that supplies data to clients consuming the MediaValet cloud digital asset management (DAM) platform. The service applies business rules, permission rules, and other data processing to standardize what is returned. Requests go to the API gateway at https://api.mediavalet.com and must carry two credentials: an OAuth 2.0 / OpenID Connect Bearer access token issued by https://login.mediavalet.com/connect/token, and a per-account subscription key in the Ocp-Apim-Subscription-Key header. Requests also carry an x-mv-api-version header to select the API version. Access requires a MediaValet subscription and registration in the MediaValet Developer Portal at https://developer.mediavalet.com.

    PROVENANCE: this definition is derived operation-for-operation from MediaValet's own published Postman collection ("MediaValet API", collection 55cc404f-b818-43ba-87c2-1a07f2a47bd9) served at https://docs.mediavalet.com/api/collections/15676803/TzRUB7XE. Paths, methods, parameters, request bodies, response status codes and examples come from that collection. Schemas are inferred from the collection's request/response example payloads and are indicative rather than authoritative.
  version: '1.0'
  contact:
    name: MediaValet
    url: https://developer.mediavalet.com
  termsOfService: https://www.mediavalet.com/terms-of-service
servers:
- url: https://api.mediavalet.com
  description: MediaValet API gateway (public)
security:
- oauth2:
  - api
  subscriptionKey: []
tags:
- name: OrgUnit
  description: Organizational units (libraries) and their configuration.
paths:
  /organizationalunits/{id}:
    get:
      operationId: retrieveOrgUnitInformationById
      summary: Retrieve Org Unit Information By Id
      description: Retrieves detailed information for a specific organizational unit.
      tags:
      - OrgUnit
      parameters:
      - name: id
        in: path
        required: true
        description: id path parameter.
        schema:
          type: string
      - name: x-mv-api-version
        in: header
        required: false
        description: (Required) The requested API version
        schema:
          type: string
        example: '1.2'
      responses:
        '200':
          description: Request was successful.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  names:
                    type: object
                    properties:
                      name:
                        type: string
                      canonicalName:
                        type: string
                  contactInformation:
                    type: object
                    properties:
                      street:
                        type: string
                      city:
                        type: string
                      stateProvince:
                        type: string
                      country:
                        type: string
                      postalCode:
                        type: string
                      region:
                        type: string
                      phoneNumber:
                        type: string
                      website:
                        type: string
                  storage:
                    type: object
                    properties:
                      quota:
                        type: integer
                      usage:
                        type: integer
                  customization:
                    type: object
                    properties:
                      headerImageAndLogos:
                        type: object
                        properties:
                          logoImageMedium:
                            type: string
                          logoImageLarge:
                            type: string
                          headerImage:
                            type: string
                          _links:
                            type: object
                            properties:
                              self:
                                type: string
                              functions:
                                type: array
                                items:
                                  type: string
                          translationKeys:
                            type: object
                            properties:
                              consequat_e:
                                type: object
                          interpolations:
                            type: object
                            properties:
                              dolor__d5:
                                type: object
                              amet_9_3:
                                type: object
                              exercitation_8f9:
                                type: object
                              eiusmod23_:
                                type: object
                          permissions:
                            type: array
                            items:
                              type: string
                      doNotDisplayRequestUserLink:
                        type: boolean
                      skinColors:
                        type: object
                        properties:
                          backgroundAssetCardColor:
                            type: string
                          backgroundAssetCardHeaderColor:
                            type: string
                          backgroundHeaderColor:
                            type: string
                          backgroundMainColor:
                            type: string
                          backgroundPageColor:
                            type: string
                          backgroundReviewActionsColor:
                            type: string
                          buttonColor:
                            type: string
                          buttonInactiveColor:
                            type: string
                          highlightColor:
                            type: string
                          lineColor:
                            type: string
                          overlayColor:
                            type: string
                          tableOddRowColor:
                            type: string
                          textColor:
                            type: string
                          textHighlightColor:
                            type: string
                          textInactiveColor:
                            type: string
                          treeFolderColor:
                            type: string
                          textTreeColor:
                            type: string
                          backgroundTableHeaderColor:
                            type: string
                          backgroundModalHeaderColor:
                            type: string
                          focusOutlineColor:
                            type: string
                          _links:
                            type: object
                            properties:
                              self:
                                type: string
                              functions:
                                type: array
                                items:
                                  type: string
                          translationKeys:
                            type: object
                            properties:
                              nisi22:
                                type: object
                              adipisicing7e_:
                                type: object
                              est_9:
                                type: object
                              irure_6:
                                type: object
                          interpolations:
                            type: object
                            properties:
                              utd:
                                type: object
                          permissions:
                            type: array
                            items:
                              type: string
                      dafaultSkin:
                        type: string
                  customRoot:
                    type: string
                  printUIClientId:
                    type: string
                  sendForApprovalNotice:
                    type: string
                  applyWatermark:
                    type: boolean
                  watermarkFilePath:
                    type: string
                  isAmsEnabled:
                    type: boolean
                  launchDarklyConfigs:
                    type: object
                    properties:
                      clientSideId:
                        type: string
                  features:
                    type: object
                    properties:
                      culpa_e4f:
                        type: string
                      pariatur_435:
                        type: string
                  featuresLastModified:
                    type: object
                    properties:
                      occaecat2:
                        type: string
                        format: date-time
                  activeDirectoryTenantId:
                    type: string
                  userIdleTimeOutInMinutes:
                    type: integer
                  deactivateVersioning:
                    type: boolean
                  oktaOrgUrl:
                    type: string
                  iamExternalIdentityProviderName:
                    type: string
                  overwriteGroups:
                    type: boolean
                  _links:
                    type: object
                    properties:
                      self:
                        type: string
                      functions:
                        type: array
                        items:
                          type: string
                  translationKeys:
                    type: object
                    properties:
                      laboris_ed_:
                        type: object
                      amet_183:
                        type: object
                  interpolations:
                    type: object
                    properties:
                      ut6a6:
                        type: object
                  permissions:
                    type: array
                    items:
                      type: string
              example:
                id: <uuid>
                names:
                  name: <string>
                  canonicalName: <string>
                contactInformation:
                  street: <string>
                  city: <string>
                  stateProvince: <string>
                  country: <string>
                  postalCode: <string>
                  region: <string>
                  phoneNumber: <string>
                  website: <string>
                storage:
                  quota: <long>
                  usage: <long>
                customization:
                  headerImageAndLogos:
                    logoImageMedium: <string>
                    logoImageLarge: <string>
                    headerImage: <string>
                    _links:
                      self: <string>
                      functions:
                      - <string>
                      - <string>
                    translationKeys:
                      consequat_e: {}
                    interpolations:
                      dolor__d5: {}
                      amet_9_3: {}
                      exercitation_8f9: {}
                      eiusmod23_: {}
                    permissions:
                    - asset:downloadFromMvd
                    - lightbox:transferOwnership
                  doNotDisplayRequestUserLink: <boolean>
                  skinColors:
                    backgroundAssetCardColor: <string>
                    backgroundAssetCardHeaderColor: <string>
                    backgroundHeaderColor: <string>
                    backgroundMainColor: <string>
                    backgroundPageColor: <string>
                    backgroundReviewActionsColor: <string>
                    buttonColor: <string>
                    buttonInactiveColor: <string>
                    highlightColor: <string>
                    lineColor: <string>
                    overlayColor: <string>
                    tableOddRowColor: <string>
                    textColor: <string>
                    textHighlightColor: <string>
                    textInactiveColor: <string>
                    treeFolderColor: <string>
                    textTreeColor: <string>
                    backgroundTableHeaderColor: <string>
                    backgroundModalHeaderColor: <string>
                    focusOutlineColor: <string>
                    _links:
                      self: <string>
                      functions:
                      - <string>
                      - <string>
                    translationKeys:
                      nisi22: {}
                      adipisicing7e_: {}
                      est_9: {}
                      irure_6: {}
                    interpolations:
                      utd: {}
                    permissions:
                    - user:editEmail
                    - asset:downloadFromMvd
                  dafaultSkin: <string>
                customRoot: <string>
                printUIClientId: <string>
                sendForApprovalNotice: <string>
                applyWatermark: <boolean>
                watermarkFilePath: <string>
                isAmsEnabled: <boolean>
                launchDarklyConfigs:
                  clientSideId: <string>
                features:
                  culpa_e4f: Active
                  pariatur_435: Experimental
                featuresLastModified:
                  occaecat2: <dateTime>
                activeDirectoryTenantId: <string>
                userIdleTimeOutInMinutes: <integer>
                deactivateVersioning: <boolean>
                oktaOrgUrl: <string>
                iamExternalIdentityProviderName: <string>
                overwriteGroups: <boolean>
                _links:
                  self: <string>
                  functions:
                  - <string>
                  - <string>
                translationKeys:
                  laboris_ed_: {}
                  amet_183: {}
                interpolations:
                  ut6a6: {}
                permissions:
                - asset:downloadFromPortal
                - user:editEmail
        '401':
          description: The current user is not authorized to view this end-point.
        '403':
          description: The user does not have permission to perform this operation.
        '404':
          description: An organizational unit was not found.
        '500':
          description: The request failed because of a problem on the server.
  /organizationalunits/current:
    get:
      operationId: retrieveCurrentOrgUnitInformation
      summary: Retrieve Current Org Unit Information
      description: Retrieves detailed information for current organizational unit.
      tags:
      - OrgUnit
      parameters:
      - name: x-mv-api-version
        in: header
        required: false
        description: (Required) The requested API version
        schema:
          type: string
        example: '1.2'
      responses:
        '200':
          description: Request was successful.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  names:
                    type: object
                    properties:
                      name:
                        type: string
                      canonicalName:
                        type: string
                  contactInformation:
                    type: object
                    properties:
                      street:
                        type: string
                      city:
                        type: string
                      stateProvince:
                        type: string
                      country:
                        type: string
                      postalCode:
                        type: string
                      region:
                        type: string
                      phoneNumber:
                        type: string
                      website:
                        type: string
                  storage:
                    type: object
                    properties:
                      quota:
                        type: integer
                      usage:
                        type: integer
                  customization:
                    type: object
                    properties:
                      headerImageAndLogos:
                        type: object
                        properties:
                          logoImageMedium:
                            type: string
                          logoImageLarge:
                            type: string
                          headerImage:
                            type: string
                          _links:
                            type: object
                            properties:
                              self:
                                type: string
                              functions:
                                type: array
                                items:
                                  type: string
                          translationKeys:
                            type: object
                            properties:
                              consequat_e:
                                type: object
                          interpolations:
                            type: object
                            properties:
                              dolor__d5:
                                type: object
                              amet_9_3:
                                type: object
                              exercitation_8f9:
                                type: object
                              eiusmod23_:
                                type: object
                          permissions:
                            type: array
                            items:
                              type: string
                      doNotDisplayRequestUserLink:
                        type: boolean
                      skinColors:
                        type: object
                        properties:
                          backgroundAssetCardColor:
                            type: string
                          backgroundAssetCardHeaderColor:
                            type: string
                          backgroundHeaderColor:
                            type: string
                          backgroundMainColor:
                            type: string
                          backgroundPageColor:
                            type: string
                          backgroundReviewActionsColor:
                            type: string
                          buttonColor:
                            type: string
                          buttonInactiveColor:
                            type: string
                          highlightColor:
                            type: string
                          lineColor:
                            type: string
                          overlayColor:
                            type: string
                          tableOddRowColor:
                            type: string
                          textColor:
                            type: string
                          textHighlightColor:
                            type: string
                          textInactiveColor:
                            type: string
                          treeFolderColor:
                            type: string
                          textTreeColor:
                            type: string
                          backgroundTableHeaderColor:
                            type: string
                          backgroundModalHeaderColor:
                            type: string
                          focusOutlineColor:
                            type: string
                          _links:
                            type: object
                            properties:
                              self:
                                type: string
                              functions:
                                type: array
                                items:
                                  type: string
                          translationKeys:
                            type: object
                            properties:
                              nisi22:
                                type: object
                              adipisicing7e_:
                                type: object
                              est_9:
                                type: object
                              irure_6:
                                type: object
                          interpolations:
                            type: object
                            properties:
                              utd:
                                type: object
                          permissions:
                            type: array
                            items:
                              type: string
                      dafaultSkin:
                        type: string
                  customRoot:
                    type: string
                  printUIClientId:
                    type: string
                  sendForApprovalNotice:
                    type: string
                  applyWatermark:
                    type: boolean
                  watermarkFilePath:
                    type: string
                  isAmsEnabled:
                    type: boolean
                  launchDarklyConfigs:
                    type: object
                    properties:
                      clientSideId:
                        type: string
                  features:
                    type: object
                    properties:
                      culpa_e4f:
                        type: string
                      pariatur_435:
                        type: string
                  featuresLastModified:
                    type: object
                    properties:
                      occaecat2:
                        type: string
                        format: date-time
                  activeDirectoryTenantId:
                    type: string
                  userIdleTimeOutInMinutes:
                    type: integer
                  deactivateVersioning:
                    type: boolean
                  oktaOrgUrl:
                    type: string
                  iamExternalIdentityProviderName:
                    type: string
                  overwriteGroups:
                    type: boolean
                  _links:
                    type: object
                    properties:
                      self:
                        type: string
                      functions:
                        type: array
                        items:
                          type: string
                  translationKeys:
                    type: object
                    properties:
                      laboris_ed_:
                        type: object
                      amet_183:
                        type: object
                  interpolations:
                    type: object
                    properties:
                      ut6a6:
                        type: object
                  permissions:
                    type: array
                    items:
                      type: string
              example:
                id: <uuid>
                names:
                  name: <string>
                  canonicalName: <string>
                contactInformation:
                  street: <string>
                  city: <string>
                  stateProvince: <string>
                  country: <string>
                  postalCode: <string>
                  region: <string>
                  phoneNumber: <string>
                  website: <string>
                storage:
                  quota: <long>
                  usage: <long>
                customization:
                  headerImageAndLogos:
                    logoImageMedium: <string>
                    logoImageLarge: <string>
                    headerImage: <string>
                    _links:
                      self: <string>
                      functions:
                      - <string>
                      - <string>
                    translationKeys:
                      consequat_e: {}
                    interpolations:
                      dolor__d5: {}
                      amet_9_3: {}
                      exercitation_8f9: {}
                      eiusmod23_: {}
                    permissions:
                    - asset:downloadFromMvd
                    - lightbox:transferOwnership
                  doNotDisplayRequestUserLink: <boolean>
                  skinColors:
                    backgroundAssetCardColor: <string>
                    backgroundAssetCardHeaderColor: <string>
                    backgroundHeaderColor: <string>
                    backgroundMainColor: <string>
                    backgroundPageColor: <string>
                    backgroundReviewActionsColor: <string>
                    buttonColor: <string>
                    buttonInactiveColor: <string>
                    highlightColor: <string>
                    lineColor: <string>
                    overlayColor: <string>
                    tableOddRowColor: <string>
                    textColor: <string>
                    textHighlightColor: <string>
                    textInactiveColor: <string>
                    treeFolderColor: <string>
                    textTreeColor: <string>
                    backgroundTableHeaderColor: <string>
                    backgroundModalHeaderColor: <string>
                    focusOutlineColor: <string>
                    _links:
                      self: <string>
                      functions:
                      - <string>
                      - <string>
                    translationKeys:
                      nisi22: {}
                      adipisicing7e_: {}
                      est_9: {}
                      irure_6: {}
                    interpolations:
                      utd: {}
                    permissions:
                    - user:editEmail
                    - asset:downloadFromMvd
                  dafaultSkin: <string>
                customRoot: <string>
                printUIClientId: <string>
                sendForApprovalNotice: <string>
                applyWatermark: <boolean>
                watermarkFilePath: <string>
                isAmsEnabled: <boolean>
                launchDarklyConfigs:
                  clientSideId: <string>
                features:
                  culpa_e4f: Active
                  pariatur_435: Experimental
                featuresLastModified:
                  occaecat2: <dateTime>
                activeDirectoryTenantId: <string>
                userIdleTimeOutInMinutes: <integer>
                deactivateVersioning: <boolean>
                oktaOrgUrl: <string>
                iamExternalIdentityProviderName: <string>
                overwriteGroups: <boolean>
                _links:
                  self: <string>
                  functions:
                  - <string>
                  - <string>
                translationKeys:
                  laboris_ed_: {}
                  amet_183: {}
                interpolations:
                  ut6a6: {}
                permissions:
                - asset:downloadFromPortal
                - user:editEmail
        '401':
          description: The current user is not authorized to view this end-point.
        '403':
          description: The user does not have permission to perform this operation.
        '404':
          description: An organizational unit was not found.
        '500':
          description: The request failed because of a problem on the server.
  /organizationalunits/current/portals:
    get:
      operationId: retrievesPortalsDetailsForCurrentOrgUnit
      summary: Retrieves Portals Details For Current Org Unit
      description: Retrieves information for portals of current organizational unit.
      tags:
      - OrgUnit
      parameters:
      - name: x-mv-api-version
        in: header
        required: false
        description: (Required) The requested API version
        schema:
          type: string
        example: '1.2'
      responses:
        '200':
          description: Request was successful.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    domainName:
                      type: string
                    hostName:
                      type: string
                    isDefault:
                      type: string
                    _links:
                      type: object
                      properties:
                        self:
                          type: string
                        functions:
                          type: array
                          items:
                            type: string
                    translationKeys:
                      type: object
                      properties:
                        euf:
                          type: object
                    interpolations:
                      type: object
                      properties:
                        in_72d:
                          type: object
                    permissions:
                      type: array
                      items:
                        type: string
              example:
              - domainName: <string>
                hostName: <string>
                isDefault: <string>
                _links:
                  self: <string>
                  functions:
                  - <string>
                  - <string>
                translationKeys:
                  euf: {}
                interpolations:
                  in_72d: {}
                permissions:
                - lightbox:assignAsset
                - lightbox:viewAsset
              - domainName: <string>
                hostName: <string>
                isDefault: <string>
                _links:
                  self: <string>
                  functions:
                  - <string>
                  - <string>
                translationKeys:
                  cupidatat0c: {}
                  sit_6c8: {}
                interpolations:
                  Duisb: {}
                  sed_0: {}
                  dolore_a: {}
                permissions:
                - asset:shareAsWebGallery
                - lightbox:editDetails
        '401':
          description: The current user is not authorized to view this end-point.
        '403':
          description: The user does not have permission to perform this operation.
        '404':
          description: An organizational unit was not found.
        '500':
          description: The request failed because of a problem on the server.
  /organizationalunits/current/libraries:
    get:
      operationId: retrieveCurrentOrgUnitLibrariesInformation
      summary: Retrieve Current Org Unit Libraries Information
      description: Retrieves detailed information for current organizational unit libraries.
      tags:
      - OrgUnit
      parameters:
      - name: x-mv-api-version
        in: header
        required: false
        description: (Required) The requested API version
        schema:
          type: string
        example: '1.2'
      responses:
        '200':
        

# --- truncated at 32 KB (103 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mediavalet/refs/heads/main/openapi/mediavalet-org-unit-api-openapi.yml