API Reference

Upload media

This operation uploads media such a images, videos, and files to Spruce for use in messaging. Uploading a file will return a media ID that can be used to reference the file in other operations. Callers of this API should record the resulting media ID for future use. A media ID can be used in the attachmentID field of the conversation message post attachment. Media IDs can be used multiple times.
The Content-Type and Content-Disposition headers on the multipart media field can use used to provide additional metadata about the media. This metadata can impact how the media is displayed and downloaded from the application.

Example Headers

  • Content-Disposition: form-data; name="media"; filename="image.png"
  • Content-Type: image/png
Language
Credentials
Bearer
Click Try It! to start a request and see the response here!