CTA Templates

Create an upload URL for a CTA image

Returns a short-lived, pre-signed URL for uploading a CTA image. Upload the file bytes with an HTTP PUT to upload_url, sending exactly the returned upload_headers, then use image_url as a template's image_url. Accepted content types are image/png, image/jpeg, image/webp and image/gif, up to 10 MiB; when filename has an extension it must match the content type (.png, .jpg/.jpeg, .webp, .gif). Returns 503 when image storage is not configured for the deployment. Requires the GEO product.

post/org/cta-assets/upload-url

Request

  • Base URL
    https://apiv2.senso.ai/api/v1
  • Auth
    API key in header X-API-Key

Request body

filenamestring required

The file's name. Its extension, when present, must match content_type.

content_type'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif' required

The image's media type.

file_size_bytesinteger required

The file size in bytes, at most 10 MiB.

Response

Where and how to upload the image.

upload_urlstring required

The pre-signed URL to PUT the file bytes to.

image_urlstring required

The public URL the image will have once uploaded — use it as a template's image_url.

object_keystring required

The storage key of the uploaded object. Its extension follows content_type (.png, .jpg, .webp or .gif), not filename.

expires_ininteger required

Seconds until upload_url stops accepting the upload (currently 900).

upload_headersobject required

The headers to send with the PUT: Content-Type (the accepted content type) and Cache-Control.

Changes

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