Sign in
External Models

Create and publish a model story via external API

Creates a published model story and returns a presigned URL for uploading its media. The caller must upload the file to the returned URL within 1 hour.

post/v1/external-models/{id}/stories

Path parameters

idstring required

Model ID

Headers

x-api-keystring required

API key for authentication

Request body

media_type'photo' | 'video' required
content_typestring

Defaults to image/webp for photo stories and video/mp4 for video stories.

expires_atstring nullable
ordernumber
is_explicitboolean
durationnumber nullable

Video duration in seconds, if known.

Example request

{
  "media_type": "photo",
  "content_type": "image/webp",
  "expires_at": "2026-05-08T12:00:00.000Z"
}

Response

Story created and published with presigned upload URL

story_idstring required
media_idstring required
model_idstring required
upload_urlstring required
s3_keystring required
final_urlstring required
expires_innumber required

Changes

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