Skip to main content
POST /v2/access/stories accepts exactly one image. Set mediaItems to a numeric Vault image ID, a numeric string, or a completed upload: reference.
Authenticate with apikey and x-connection-id as described in Access API. The connection needs stories:write; uploading a new image also needs vault:write. The optional releaseForms object accepts numeric user IDs in users, partners, and guests arrays. Other fields are rejected, including canvas dimensions, questions, and editor transformations. Apply image edits before uploading. Videos and GIFs are not supported by story creation.

Upload an image and create the story

This Node.js example handles single-part and multipart PNG uploads. For another supported image format, change contentType to match the file.
Byte-range ends are inclusive. V2 single-part PUTs finalize the upload automatically; multipart uploads require finalization after every part has been uploaded. OFAuth calculates the part count from the file size. A temporary upload reference is consumed when story creation succeeds. Start a new upload session for another story, or reuse a Vault image ID. Upload sessions started before this release must be restarted to record the detected file type and storage location.