MediaValet Persons API
Person and face recognition records used to tag the people appearing in assets. 8 operations.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mediavalet:mediavalet-persons-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.
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).