MediaValet

MediaValet Persons API

Person and face recognition records used to tag the people appearing in assets. 8 operations.

Documentation GitHub OpenAPI

Operations 8

GET /categories/{categoryId}/persons Persons Get Persons In Category Async #

GET /persons/{identificationType}/mostViewed Retrieve Faces in Most viewed Assets #

GET /categories/{categoryId}/persons/identified Persons Get Identified Persons In Category Async #

GET /categories/{categoryId}/persons/unidentified Persons Get Unidentified Persons In Category Async #

GET /persons/{identificationType}/recentlyUploaded Retrieve Faces of recently Uploaded Assets #

POST /persons/identified/search Persons Get Identified Persons #

POST /persons/unidentified/search Persons Get Unidentified Persons #

PATCH /persons/{personId} Update person name #

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-persons-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

openapi: 3.2.0
info:
  title: MediaValet Persons 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: Persons
  description: Person/face recognition records used to tag people in assets.
paths:
  /categories/{categoryId}/persons:
    get:
      operationId: personsGetPersonsInCategoryAsync
      summary: Persons Get Persons In Category Async
      tags:
      - Persons
      parameters:
      - name: categoryId
        in: path
        required: true
        description: categoryId 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:
                  personCount:
                    type: integer
                  persons:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        thumbnailUrl:
                          type: string
                        numberOfAssets:
                          type: integer
                        name:
                          type: string
                        identified:
                          type: boolean
              example:
                personCount: <integer>
                persons:
                - id: <uuid>
                  thumbnailUrl: <string>
                  numberOfAssets: <integer>
                  name: <string>
                  identified: <boolean>
                - id: <uuid>
                  thumbnailUrl: <string>
                  numberOfAssets: <integer>
                  name: <string>
                  identified: <boolean>
        '400':
          description: There was a problem with the data sent with the request.
        '403':
          description: The user does not have permission to perform this operation.
        '500':
          description: The request failed because of a problem on the server.
  /persons/{identificationType}/mostViewed:
    get:
      operationId: retrieveFacesInMostViewedAssets
      summary: Retrieve Faces in Most viewed Assets
      description: Returns list faces of most viewed assets.
      tags:
      - Persons
      parameters:
      - name: identificationType
        in: path
        required: true
        description: identificationType 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
                  thumbnailUrl:
                    type: string
                  name:
                    type: string
                  identified:
                    type: boolean
                  libaryId:
                    type: string
                    format: uuid
              example:
                id: <uuid>
                thumbnailUrl: <string>
                name: <string>
                identified: <boolean>
                libaryId: <uuid>
        '403':
          description: The user does not have permission to perform this operation.
  /categories/{categoryId}/persons/identified:
    get:
      operationId: personsGetIdentifiedPersonsInCategoryAsync
      summary: Persons Get Identified Persons In Category Async
      tags:
      - Persons
      parameters:
      - name: categoryId
        in: path
        required: true
        description: categoryId 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:
                  personCount:
                    type: integer
                  persons:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        thumbnailUrl:
                          type: string
                        numberOfAssets:
                          type: integer
                        name:
                          type: string
                        identified:
                          type: boolean
              example:
                personCount: <integer>
                persons:
                - id: <uuid>
                  thumbnailUrl: <string>
                  numberOfAssets: <integer>
                  name: <string>
                  identified: <boolean>
                - id: <uuid>
                  thumbnailUrl: <string>
                  numberOfAssets: <integer>
                  name: <string>
                  identified: <boolean>
        '400':
          description: There was a problem with the data sent with the request.
        '403':
          description: The user does not have permission to perform this operation.
        '500':
          description: The request failed because of a problem on the server.
  /categories/{categoryId}/persons/unidentified:
    get:
      operationId: personsGetUnidentifiedPersonsInCategoryAsync
      summary: Persons Get Unidentified Persons In Category Async
      tags:
      - Persons
      parameters:
      - name: categoryId
        in: path
        required: true
        description: categoryId 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:
                  personCount:
                    type: integer
                  persons:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        thumbnailUrl:
                          type: string
                        numberOfAssets:
                          type: integer
                        name:
                          type: string
                        identified:
                          type: boolean
              example:
                personCount: <integer>
                persons:
                - id: <uuid>
                  thumbnailUrl: <string>
                  numberOfAssets: <integer>
                  name: <string>
                  identified: <boolean>
                - id: <uuid>
                  thumbnailUrl: <string>
                  numberOfAssets: <integer>
                  name: <string>
                  identified: <boolean>
        '400':
          description: There was a problem with the data sent with the request.
        '403':
          description: The user does not have permission to perform this operation.
        '500':
          description: The request failed because of a problem on the server.
  /persons/{identificationType}/recentlyUploaded:
    get:
      operationId: retrieveFacesOfRecentlyUploadedAssets
      summary: Retrieve Faces of recently Uploaded Assets
      description: Returns list of faces recently uploaded assets.
      tags:
      - Persons
      parameters:
      - name: identificationType
        in: path
        required: true
        description: identificationType 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
                  thumbnailUrl:
                    type: string
                  name:
                    type: string
                  identified:
                    type: boolean
                  libaryId:
                    type: string
                    format: uuid
              example:
                id: <uuid>
                thumbnailUrl: <string>
                name: <string>
                identified: <boolean>
                libaryId: <uuid>
        '403':
          description: The user does not have permission to perform this operation.
  /persons/identified/search:
    post:
      operationId: personsGetIdentifiedPersons
      summary: Persons Get Identified Persons
      tags:
      - Persons
      parameters:
      - name: x-mv-api-version
        in: header
        required: false
        description: (Required) The requested API version
        schema:
          type: string
        example: '1.2'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                Filters:
                  type: string
                Debug:
                  type: boolean
                ThresholdStrategy:
                  type: string
                Count:
                  type: integer
                Offset:
                  type: integer
                OrderBy:
                  type: string
                ContainerFilter:
                  type: string
                SearchTerm:
                  type: string
                SearchFields:
                  type: string
                IncludeTotalCount:
                  type: boolean
                IncludeSoftDeleted:
                  type: boolean
                UseSemanticSearch:
                  type: boolean
                UseRrf:
                  type: boolean
                SemanticSearchSimilarity:
                  type: number
                FileId:
                  type: string
                FileUrl:
                  type: string
                FileSearchExactMatch:
                  type: boolean
            example:
              Filters: <string>
              Debug: <boolean>
              ThresholdStrategy: <string>
              Count: <integer>
              Offset: <integer>
              OrderBy: <string>
              ContainerFilter: <string>
              SearchTerm: <string>
              SearchFields: <string>
              IncludeTotalCount: <boolean>
              IncludeSoftDeleted: <boolean>
              UseSemanticSearch: <boolean>
              UseRrf: <boolean>
              SemanticSearchSimilarity: <float>
              FileId: <string>
              FileUrl: <string>
              FileSearchExactMatch: <boolean>
      responses:
        '200':
          description: Request was successful.
          content:
            application/json:
              schema:
                type: object
                properties:
                  personCount:
                    type: integer
                  persons:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        thumbnailUrl:
                          type: string
                        numberOfAssets:
                          type: integer
                        name:
                          type: string
                        identified:
                          type: boolean
              example:
                personCount: <integer>
                persons:
                - id: <uuid>
                  thumbnailUrl: <string>
                  numberOfAssets: <integer>
                  name: <string>
                  identified: <boolean>
                - id: <uuid>
                  thumbnailUrl: <string>
                  numberOfAssets: <integer>
                  name: <string>
                  identified: <boolean>
        '400':
          description: There was a problem with the data sent with the request.
        '403':
          description: The user does not have permission to perform this operation.
        '500':
          description: The request failed because of a problem on the server.
  /persons/unidentified/search:
    post:
      operationId: personsGetUnidentifiedPersons
      summary: Persons Get Unidentified Persons
      tags:
      - Persons
      parameters:
      - name: x-mv-api-version
        in: header
        required: false
        description: (Required) The requested API version
        schema:
          type: string
        example: '1.2'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                Filters:
                  type: string
                Debug:
                  type: boolean
                ThresholdStrategy:
                  type: string
                Count:
                  type: integer
                Offset:
                  type: integer
                OrderBy:
                  type: string
                ContainerFilter:
                  type: string
                SearchTerm:
                  type: string
                SearchFields:
                  type: string
                IncludeTotalCount:
                  type: boolean
                IncludeSoftDeleted:
                  type: boolean
                UseSemanticSearch:
                  type: boolean
                UseRrf:
                  type: boolean
                SemanticSearchSimilarity:
                  type: number
                FileId:
                  type: string
                FileUrl:
                  type: string
                FileSearchExactMatch:
                  type: boolean
            example:
              Filters: <string>
              Debug: <boolean>
              ThresholdStrategy: <string>
              Count: <integer>
              Offset: <integer>
              OrderBy: <string>
              ContainerFilter: <string>
              SearchTerm: <string>
              SearchFields: <string>
              IncludeTotalCount: <boolean>
              IncludeSoftDeleted: <boolean>
              UseSemanticSearch: <boolean>
              UseRrf: <boolean>
              SemanticSearchSimilarity: <float>
              FileId: <string>
              FileUrl: <string>
              FileSearchExactMatch: <boolean>
      responses:
        '200':
          description: Request was successful.
          content:
            application/json:
              schema:
                type: object
                properties:
                  personCount:
                    type: integer
                  persons:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        thumbnailUrl:
                          type: string
                        numberOfAssets:
                          type: integer
                        name:
                          type: string
                        identified:
                          type: boolean
              example:
                personCount: <integer>
                persons:
                - id: <uuid>
                  thumbnailUrl: <string>
                  numberOfAssets: <integer>
                  name: <string>
                  identified: <boolean>
                - id: <uuid>
                  thumbnailUrl: <string>
                  numberOfAssets: <integer>
                  name: <string>
                  identified: <boolean>
        '400':
          description: There was a problem with the data sent with the request.
        '403':
          description: The user does not have permission to perform this operation.
        '500':
          description: The request failed because of a problem on the server.
  /persons/{personId}:
    patch:
      operationId: updatePersonName
      summary: Update person name
      description: Update person name.
      tags:
      - Persons
      parameters:
      - name: personId
        in: path
        required: true
        description: personId 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'
      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:
                  id:
                    type: string
                    format: uuid
                  thumbnailUrl:
                    type: string
                  name:
                    type: string
                  identified:
                    type: boolean
                  libaryId:
                    type: string
                    format: uuid
              example:
                id: <uuid>
                thumbnailUrl: <string>
                name: <string>
                identified: <boolean>
                libaryId: <uuid>
        '400':
          description: There was a problem with the data sent with the request.
        '403':
          description: The user does not have permission to perform this operation.
        '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).