Stock photos
Searching a third-party stock photography library, and copying a photo out of it into the workspace. A search result is the provider's, not the workspace's, until it is imported.
Search stock photos
Searches a third-party stock photography library. Nothing is stored by this request — the results are the provider's, and each carries the attribution that must be shown wherever the photo is displayed. With no query, the provider's editorial selection is returned. Answers 503 when the workspace has no stock provider configured, and 403 when an administrator has turned stock photos off for the workspace.
query Parameters
colorcursororientationpageper_pagequeryHeaders
X-Tenant-IdThe workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.
Search stock photos › Responses
Success
Import a stock photo
Copies one searched photo into the workspace as a file and returns it. Without file_repo the photo lands in the media library, which additionally requires media:upload; with one, it is filed against that object and follows its access rules. Answers 403 when stock photos are turned off for the workspace.
path Parameters
idHeaders
X-Tenant-IdThe workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.
Import a stock photo › Responses
Success