MediaValet

MediaValet Attribute Groups API

Groupings of custom metadata attributes.

GitHub OpenAPI

Operations 6

GET /attributeGroups Gets all Attribute Groups for the current library #
POST /attributeGroups Creates a new Attribute Group #
GET /attributeGroups/{attributeGroupId} Gets the details of a specific Attribute Group by ID #
DELETE /attributeGroups/{attributeGroupId} Deletes an Attribute Group #
PATCH /attributeGroups/{attributeGroupId} Attribute Groups Update Attribute Group Async #
GET /attributeGroups/{attributeGroupId}/attributes Gets all Attributes for a specific Attribute Group by ID #

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-attribute-groups-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-attribute-groups-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

mediavalet-attribute-groups-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: MediaValet Attribute Groups 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.
  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: Attribute Groups
  description: Groupings of custom metadata attributes.
paths:
  /attributeGroups:
    get:
      operationId: getsAllAttributeGroupsForTheCurrentLibrary
      summary: Gets all Attribute Groups for the current library
      tags:
      - Attribute Groups
      parameters:
      - name: x-mv-api-version
        in: header
        required: false
        description: The requested API version
        schema:
          type: string
        example: '1.0'
      responses:
        '200':
          description: The Attribute Groups were successfully retrieved.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    attributeGroupId:
                      type: string
                    name:
                      type: string
                    description:
                      type: string
                    attributeIds:
                      type: array
                      items:
                        type: string
                    _links:
                      type: object
                      properties:
                        self:
                          type: string
                        functions:
                          type: array
                          items:
                            type: string
                    translationKeys:
                      type: object
                      properties:
                        key_0:
                          type: object
                        key_1:
                          type: object
                    interpolations:
                      type: object
                      properties:
                        key_0:
                          type: object
                    permissions:
                      type: array
                      items:
                        type: string
              example:
              - attributeGroupId: 00000000-0000-0000-0000-000000000000
                name: string
                description: string
                attributeIds:
                - 00000000-0000-0000-0000-000000000000
                - 00000000-0000-0000-0000-000000000000
                _links:
                  self: string
                  functions:
                  - string
                  - string
                translationKeys:
                  key_0: {}
                  key_1: {}
                interpolations:
                  key_0: {}
                permissions:
                - asset:shareAsLink
                - lightbox:assignAsset
              - attributeGroupId: 00000000-0000-0000-0000-000000000000
                name: string
                description: string
                attributeIds:
                - 00000000-0000-0000-0000-000000000000
                - 00000000-0000-0000-0000-000000000000
                _links:
                  self: string
                  functions:
                  - string
                  - string
                translationKeys:
                  key_0: {}
                  key_1: {}
                interpolations:
                  key_0: {}
                permissions:
                - attributeGroup:view
                - asset:shareAsLink
        '403':
          description: Attribute grouping is not enabled for this library or you do not have permission to view attribute groups.
        '500':
          description: The request failed because of a problem on the server.
    post:
      operationId: createsANewAttributeGroup
      summary: Creates a new Attribute Group
      tags:
      - Attribute Groups
      parameters:
      - name: x-mv-api-version
        in: header
        required: false
        description: The requested API version
        schema:
          type: string
        example: '1.0'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                description:
                  type: string
                attributeIds:
                  type: array
                  items:
                    type: string
            example:
              name: string
              description: string
              attributeIds:
              - 00000000-0000-0000-0000-000000000000
              - 00000000-0000-0000-0000-000000000000
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
              example: {}
        '201':
          description: The Attribute Group was successfully created.
          content:
            application/json:
              schema:
                type: object
                properties:
                  attributeGroupId:
                    type: string
                  name:
                    type: string
                  description:
                    type: string
                  attributeIds:
                    type: array
                    items:
                      type: string
                  _links:
                    type: object
                    properties:
                      self:
                        type: string
                      functions:
                        type: array
                        items:
                          type: string
                  translationKeys:
                    type: object
                    properties:
                      key_0:
                        type: object
                      key_1:
                        type: object
                  interpolations:
                    type: object
                    properties:
                      key_0:
                        type: object
                  permissions:
                    type: array
                    items:
                      type: string
              example:
                attributeGroupId: 00000000-0000-0000-0000-000000000000
                name: string
                description: string
                attributeIds:
                - 00000000-0000-0000-0000-000000000000
                - 00000000-0000-0000-0000-000000000000
                _links:
                  self: string
                  functions:
                  - string
                  - string
                translationKeys:
                  key_0: {}
                  key_1: {}
                interpolations:
                  key_0: {}
                permissions:
                - asset:shareAsWebGallery
                - attributeGroup:viewAttribute
        '400':
          description: Bad Request.
        '403':
          description: Attribute grouping is not enabled for this library or you do not have permission to create attribute groups.
        '404':
          description: Attribute not found
        '500':
          description: The request failed because of a problem on the server.
  /attributeGroups/{attributeGroupId}:
    get:
      operationId: getsTheDetailsOfASpecificAttributeGroupByID
      summary: Gets the details of a specific Attribute Group by ID
      tags:
      - Attribute Groups
      parameters:
      - name: attributeGroupId
        in: path
        required: true
        description: attributeGroupId path parameter.
        schema:
          type: string
      - name: x-mv-api-version
        in: header
        required: false
        description: The requested API version
        schema:
          type: string
        example: '1.0'
      responses:
        '200':
          description: The Attribute Group was successfully retrieved.
          content:
            application/json:
              schema:
                type: object
                properties:
                  attributeGroupId:
                    type: string
                  name:
                    type: string
                  description:
                    type: string
                  attributeIds:
                    type: array
                    items:
                      type: string
                  _links:
                    type: object
                    properties:
                      self:
                        type: string
                      functions:
                        type: array
                        items:
                          type: string
                  translationKeys:
                    type: object
                    properties:
                      key_0:
                        type: object
                      key_1:
                        type: object
                  interpolations:
                    type: object
                    properties:
                      key_0:
                        type: object
                  permissions:
                    type: array
                    items:
                      type: string
              example:
                attributeGroupId: 00000000-0000-0000-0000-000000000000
                name: string
                description: string
                attributeIds:
                - 00000000-0000-0000-0000-000000000000
                - 00000000-0000-0000-0000-000000000000
                _links:
                  self: string
                  functions:
                  - string
                  - string
                translationKeys:
                  key_0: {}
                  key_1: {}
                interpolations:
                  key_0: {}
                permissions:
                - asset:shareAsWebGallery
                - attributeGroup:viewAttribute
        '403':
          description: Attribute grouping is not enabled for this library or you do not have permission to view attribute groups.
        '404':
          description: The Attribute Group was not found.
        '500':
          description: The request failed because of a problem on the server.
    delete:
      operationId: deletesAnAttributeGroup
      summary: Deletes an Attribute Group
      tags:
      - Attribute Groups
      parameters:
      - name: attributeGroupId
        in: path
        required: true
        description: attributeGroupId path parameter.
        schema:
          type: string
      - name: x-mv-api-version
        in: header
        required: false
        description: The requested API version
        schema:
          type: string
        example: '1.0'
      responses:
        '200':
          description: The Attribute Group was successfully deleted.
        '400':
          description: Bad Request.
        '403':
          description: Attribute grouping is not enabled for this library or you do not have permission to delete attribute groups.
        '404':
          description: The Attribute Group was not found.
        '500':
          description: The request failed because of a problem on the server.
    patch:
      operationId: attributeGroupsUpdateAttributeGroupAsync
      summary: Attribute Groups Update Attribute Group Async
      tags:
      - Attribute Groups
      parameters:
      - name: attributeGroupId
        in: path
        required: true
        description: attributeGroupId path parameter.
        schema:
          type: string
      - name: x-mv-api-version
        in: header
        required: false
        description: The requested API version
        schema:
          type: string
        example: '1.0'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                properties:
                  op:
                    type: string
                  path:
                    type: string
                  value:
                    type: object
                  from:
                    type: string
            example:
            - op: string
              path: string
              value: {}
              from: string
            - op: string
              path: string
              value: {}
              from: string
      responses:
        '200':
          description: Request was successful.
          content:
            application/json:
              schema:
                type: object
                properties:
                  attributeGroupId:
                    type: string
                  name:
                    type: string
                  description:
                    type: string
                  attributeIds:
                    type: array
                    items:
                      type: string
                  _links:
                    type: object
                    properties:
                      self:
                        type: string
                      functions:
                        type: array
                        items:
                          type: string
                  translationKeys:
                    type: object
                    properties:
                      key_0:
                        type: object
                      key_1:
                        type: object
                  interpolations:
                    type: object
                    properties:
                      key_0:
                        type: object
                  permissions:
                    type: array
                    items:
                      type: string
              example:
                attributeGroupId: 00000000-0000-0000-0000-000000000000
                name: string
                description: string
                attributeIds:
                - 00000000-0000-0000-0000-000000000000
                - 00000000-0000-0000-0000-000000000000
                _links:
                  self: string
                  functions:
                  - string
                  - string
                translationKeys:
                  key_0: {}
                  key_1: {}
                interpolations:
                  key_0: {}
                permissions:
                - asset:shareAsWebGallery
                - attributeGroup:viewAttribute
        '400':
          description: Bad Request.
        '403':
          description: Attribute grouping is not enabled for this library or you do not have permission to create attribute groups.
        '404':
          description: The Attribute Group was not found.
        '409':
          description: An Attribute Group with the specified name already exists.
        '500':
          description: The request failed because of a problem on the server.
  /attributeGroups/{attributeGroupId}/attributes:
    get:
      operationId: getsAllAttributesForASpecificAttributeGroupByID
      summary: Gets all Attributes for a specific Attribute Group by ID
      tags:
      - Attribute Groups
      parameters:
      - name: attributeGroupId
        in: path
        required: true
        description: attributeGroupId path parameter.
        schema:
          type: string
      - name: x-mv-api-version
        in: header
        required: false
        description: The requested API version
        schema:
          type: string
        example: '1.0'
      responses:
        '200':
          description: Attributes for the Attribute Group were successfully retrieved.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    attributeType:
                      type: string
                    name:
                      type: string
                    searchFieldName:
                      type: string
                    tagName:
                      type: string
                    displayAttribute:
                      type: boolean
                    mapEmbeddedData:
                      type: boolean
                    embeddedDataType:
                      type: string
                    embeddedDataValue:
                      type: string
                    mappingDirection:
                      type: string
                    delimeter:
                      type: string
                    isSystemProperty:
                      type: boolean
                    showLabel:
                      type: boolean
                    isRequired:
                      type: boolean
                    optionsList:
                      type: array
                      items:
                        type: object
                        properties:
                          optionValue:
                            type: string
                          isDefault:
                            type: boolean
                          sequence:
                            type: integer
                    statusList:
                      type: array
                      items:
                        type: object
                        properties:
                          statusName:
                            type: string
                          statusValue:
                            type: integer
                          sequence:
                            type: integer
                    defaultExpression:
                      type: string
                    parentAttributeId:
                      type: string
                    childrenAttributeIds:
                      type: array
                      items:
                        type: string
                    attributeGroupIds:
                      type: array
                      items:
                        type: string
                    _links:
                      type: object
                      properties:
                        self:
                          type: string
                        functions:
                          type: array
                          items:
                            type: string
                    translationKeys:
                      type: object
                      properties:
                        key_0:
                          type: object
                    interpolations:
                      type: object
                      properties:
                        key_0:
                          type: object
                        key_1:
                          type: object
                    permissions:
                      type: array
                      items:
                        type: string
              example:
              - id: 00000000-0000-0000-0000-000000000000
                attributeType: Boolean
                name: string
                searchFieldName: string
                tagName: string
                displayAttribute: false
                mapEmbeddedData: false
                embeddedDataType: Photoshop
                embeddedDataValue: string
                mappingDirection: Upload
                delimeter: string
                isSystemProperty: false
                showLabel: true
                isRequired: false
                optionsList:
                - optionValue: string
                  isDefault: true
                  sequence: 4858
                - optionValue: string
                  isDefault: true
                  sequence: 5763
                statusList:
                - statusName: string
                  statusValue: 3211
                  sequence: 7980
                - statusName: string
                  statusValue: 5663
                  sequence: 1873
                defaultExpression: string
                parentAttributeId: string
                childrenAttributeIds:
                - string
                - string
                attributeGroupIds:
                - 00000000-0000-0000-0000-000000000000
                - 00000000-0000-0000-0000-000000000000
                _links:
                  self: string
                  functions:
                  - string
                  - string
                translationKeys:
                  key_0: {}
                interpolations:
                  key_0: {}
                  key_1: {}
                permissions:
                - asset:createVideoClip
                - asset:shareAsLightbox
              - id: 00000000-0000-0000-0000-000000000000
                attributeType: DateTime
                name: string
                searchFieldName: string
                tagName: string
                displayAttribute: false
                mapEmbeddedData: true
                embeddedDataType: Iptc
                embeddedDataValue: string
                mappingDirection: Upload
                delimeter: string
                isSystemProperty: true
                showLabel: false
                isRequired: false
                optionsList:
                - optionValue: string
                  isDefault: false
                  sequence: 3956
                - optionValue: string
                  isDefault: true
                  sequence: 409
                statusList:
                - statusName: string
                  statusValue: 809
                  sequence: 1850
                - statusName: string
                  statusValue: 7824
                  sequence: 8739
                defaultExpression: string
                parentAttributeId: string
                childrenAttributeIds:
                - string
                - string
                attributeGroupIds:
                - 00000000-0000-0000-0000-000000000000
                - 00000000-0000-0000-0000-000000000000
                _links:
                  self: string
                  functions:
                  - string
                  - string
                translationKeys:
                  key_0: {}
                interpolations:
                  key_0: {}
                  key_1: {}
                  key_2: {}
                  key_3: {}
                permissions:
                - asset:shareAsLightbox
                - asset:shareAsCdnLink
        '403':
          description: Attribute grouping is not enabled for this library or you do not have permission to view attribute groups.
        '404':
          description: The Attribute Group was not found.
        '500':
          description: The request failed because of a problem on the server.
components:
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.0 / OpenID Connect issued by https://iam.mediavalet.com via https://login.mediavalet.com. Send the access token as a Bearer Authorization header.
      flows:
        authorizationCode:
          authorizationUrl: https://login.mediavalet.com/connect/authorize
          tokenUrl: https://login.mediavalet.com/connect/token
          refreshUrl: https://login.mediavalet.com/connect/token
          scopes:
            openid: OpenID Connect identity
            profile: User profile claims
            api: Access the MediaValet API
            api:service_principal: Service-principal (machine) access to the MediaValet API
            iam.admin: Administer MediaValet identity and access management
            iam.provisioning: Provision users and organizations
            offline_access: Obtain a refresh token
        clientCredentials:
          tokenUrl: https://login.mediavalet.com/connect/token
          scopes:
            api: Access the MediaValet API
            api:service_principal: Service-principal (machine) access to the MediaValet API
        password:
          tokenUrl: https://login.mediavalet.com/connect/token
          scopes:
            openid: OpenID Connect identity
            api: Access the MediaValet API
            offline_access: Obtain a refresh token
    subscriptionKey:
      type: apiKey
      in: header
      name: Ocp-Apim-Subscription-Key
      description: Per-account API subscription key issued through the MediaValet Developer Portal (Azure API Management).