MediaValet Saved Searches API
Saved searches and their execution.
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-saved-searches-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 Saved Searches 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: Saved Searches
description: Saved searches and their execution.
paths:
/savedsearches:
get:
operationId: retrieveSavedSearches
summary: Retrieve Saved Searches
description: Retrieves all custom saved searches.
tags:
- Saved Searches
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
name:
type: string
searchQuery:
type: string
ownerUserId:
type: string
ownerUserName:
type: string
sharedWithOthers:
type: boolean
pinnedSearchForUser:
type: boolean
pinnedSearchForGroups:
type: boolean
_links:
type: object
properties:
self:
type: string
functions:
type: array
items:
type: string
translationKeys:
type: object
properties:
eu_4:
type: object
interpolations:
type: object
properties:
ex_1:
type: object
permissions:
type: array
items:
type: string
example:
id: <uuid>
name: <string>
searchQuery: <string>
ownerUserId: <string>
ownerUserName: <string>
sharedWithOthers: <boolean>
pinnedSearchForUser: <boolean>
pinnedSearchForGroups: <boolean>
_links:
self: <string>
functions:
- <string>
- <string>
translationKeys:
eu_4: {}
interpolations:
ex_1: {}
permissions:
- lightbox:assignAsset
- None
'403':
description: The user does not have permission to perform this operation.
'404':
description: A saved search was not found.
'500':
description: The request failed because of a problem on the server.
post:
operationId: createSavedSearch
summary: Create Saved Search
description: Creates a new custom search.
tags:
- Saved Searches
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:
id:
type: string
format: uuid
name:
type: string
searchQuery:
type: string
example:
id: <uuid>
name: <string>
searchQuery: <string>
responses:
'201':
description: The saved search was successfully created.
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
searchQuery:
type: string
ownerUserId:
type: string
ownerUserName:
type: string
sharedWithOthers:
type: boolean
pinnedSearchForUser:
type: boolean
pinnedSearchForGroups:
type: boolean
_links:
type: object
properties:
self:
type: string
functions:
type: array
items:
type: string
translationKeys:
type: object
properties:
eu_4:
type: object
interpolations:
type: object
properties:
ex_1:
type: object
permissions:
type: array
items:
type: string
example:
id: <uuid>
name: <string>
searchQuery: <string>
ownerUserId: <string>
ownerUserName: <string>
sharedWithOthers: <boolean>
pinnedSearchForUser: <boolean>
pinnedSearchForGroups: <boolean>
_links:
self: <string>
functions:
- <string>
- <string>
translationKeys:
eu_4: {}
interpolations:
ex_1: {}
permissions:
- lightbox:assignAsset
- None
'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.
/savedsearches/pinned:
get:
operationId: retrievePinnedSavedSearches
summary: Retrieve Pinned Saved Searches
description: Retrieves all pinned saved searches.
tags:
- Saved Searches
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
name:
type: string
searchQuery:
type: string
ownerUserId:
type: string
ownerUserName:
type: string
sharedWithOthers:
type: boolean
pinnedSearchForUser:
type: boolean
pinnedSearchForGroups:
type: boolean
_links:
type: object
properties:
self:
type: string
functions:
type: array
items:
type: string
translationKeys:
type: object
properties:
eu_4:
type: object
interpolations:
type: object
properties:
ex_1:
type: object
permissions:
type: array
items:
type: string
example:
id: <uuid>
name: <string>
searchQuery: <string>
ownerUserId: <string>
ownerUserName: <string>
sharedWithOthers: <boolean>
pinnedSearchForUser: <boolean>
pinnedSearchForGroups: <boolean>
_links:
self: <string>
functions:
- <string>
- <string>
translationKeys:
eu_4: {}
interpolations:
ex_1: {}
permissions:
- lightbox:assignAsset
- None
'403':
description: The user does not have permission to perform this operation.
'404':
description: A pinned saved search was not found.
'500':
description: The request failed because of a problem on the server.
/savedsearches/{savedSearchId}:
get:
operationId: retrieveSavedSearch
summary: Retrieve Saved Search
description: Retrieves a custom saved search.
tags:
- Saved Searches
parameters:
- name: savedSearchId
in: path
required: true
description: savedSearchId 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
name:
type: string
searchQuery:
type: string
ownerUserId:
type: string
ownerUserName:
type: string
sharedWithOthers:
type: boolean
pinnedSearchForUser:
type: boolean
pinnedSearchForGroups:
type: boolean
_links:
type: object
properties:
self:
type: string
functions:
type: array
items:
type: string
translationKeys:
type: object
properties:
eu_4:
type: object
interpolations:
type: object
properties:
ex_1:
type: object
permissions:
type: array
items:
type: string
example:
id: <uuid>
name: <string>
searchQuery: <string>
ownerUserId: <string>
ownerUserName: <string>
sharedWithOthers: <boolean>
pinnedSearchForUser: <boolean>
pinnedSearchForGroups: <boolean>
_links:
self: <string>
functions:
- <string>
- <string>
translationKeys:
eu_4: {}
interpolations:
ex_1: {}
permissions:
- lightbox:assignAsset
- None
'403':
description: The user does not have permission to perform this operation.
'404':
description: A saved search was not found.
'500':
description: The request failed because of a problem on the server.
delete:
operationId: removeSavedSearch
summary: Remove Saved Search
description: Removes a custom saved search.
tags:
- Saved Searches
parameters:
- name: savedSearchId
in: path
required: true
description: savedSearchId 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.
'403':
description: The user does not have permission to perform this operation.
'404':
description: A saved search was not found.
'500':
description: The request failed because of a problem on the server.
patch:
operationId: updateSavedSearch
summary: Update Saved Search
description: Update a custom saved search with a list of patch operations.
tags:
- Saved Searches
parameters:
- name: savedSearchId
in: path
required: true
description: savedSearchId 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.
'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.
'404':
description: A saved search was not found.
'500':
description: The request failed because of a problem on the server.
/savedsearches/{savedSearchId}/share:
get:
operationId: retrieveSavedSearchShares
summary: Retrieve Saved Search Shares
description: Retrieves shares for a saved search.
tags:
- Saved Searches
parameters:
- name: savedSearchId
in: path
required: true
description: savedSearchId 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:
sharedWithUsers:
type: array
items:
type: string
format: uuid
sharedWithGroups:
type: array
items:
type: string
format: uuid
pinnedForGroups:
type: array
items:
type: string
format: uuid
example:
sharedWithUsers:
- <uuid>
- <uuid>
sharedWithGroups:
- <uuid>
- <uuid>
pinnedForGroups:
- <uuid>
- <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.
'404':
description: A saved search was not found.
'500':
description: The request failed because of a problem on the server.
post:
operationId: createSavedSearch2
summary: Create Saved Search
description: Creates a custom saved search.
tags:
- Saved Searches
parameters:
- name: savedSearchId
in: path
required: true
description: savedSearchId 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: object
properties:
savedSearchId:
type: string
format: uuid
shareWithUsers:
type: array
items:
type: string
format: uuid
shareWithGroups:
type: array
items:
type: string
format: uuid
example:
savedSearchId: <uuid>
shareWithUsers:
- <uuid>
- <uuid>
shareWithGroups:
- <uuid>
- <uuid>
responses:
'200':
description: Request was successful.
'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.
'404':
description: A saved search 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).