Assets

Upload or fetch an asset

post/v1/assets/

Request

  • Base URL: https://api.picsha.ai
  • URL: https://api.picsha.ai/v1/assets/
  • Auth: HTTP bearer

Query parameters

ephemeralstring

If true, asset will be deleted after 24 hours

expires_atstring date-time

ISO-8601 timestamp for when the asset should be automatically deleted.

Headers

x-org-idstring

Organization ID

x-external-user-idstring

External User ID

Request body

urlstring uri

Direct URL of the external asset to fetch, store, and process.

s3Keystring

S3 Key of a file already uploaded directly via presigned URL or resumable TUS.

originalNamestring

Original filename for S3 pre-uploaded assets.

tagsstring[]

Initial tags to attach to the asset.

metadataobject

Initial metadata dictionary to attach to the asset.

Response

Default Response

idstring required
urlstring nullable
messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.