Media
Carica e gestisci i file media referenziati nei messaggi e nelle campagne.
Carica un file media
Uploads a new media file (image or video) to your media library. The request must use multipart/form-data encoding with the binary file in the 'file' part. Supported image formats include JPEG, PNG, and GIF. Supported video formats include MP4. Optionally provide a human-readable name and description for the file, and a folderId to organize it into a specific folder within your library. On success the response includes the newly created media ID. Store this ID and use it whenever you need to attach the file to an outbound message (e.g. RCS rich cards, WhatsApp media messages) or to campaign content. Returns 400 if the request is malformed, the file part is missing, or the file type is not supported. Returns 401 if the API key is missing or invalid. Returns 502 if the upstream media storage service is temporarily unavailable; retry after a short delay in this case.
Elenca media aziendali
Returns a paginated list of all media files stored in your media library. Each entry contains the file ID, name, MIME type, size, and a URL for previewing or downloading the file. Use the id field from a result to reference that file when composing messages (for example, attaching an image to an RCS card or a WhatsApp media message) or when including media in campaign content. Pagination is controlled by page (0-based index) and limit (items per page, default 10, maximum 1000). Results can be sorted via sortBy (e.g. id, name) and sortOrder (asc or desc). Supported media types include common image formats (JPEG, PNG, GIF) and video formats (MP4). The exact set of accepted types depends on the downstream channel requirements. Returns 401 if the API key is missing or invalid.
Ottieni un file media
Returns the full metadata and access URL for a single media file identified by its numeric ID. The response includes the file name, MIME type, size in bytes, creation date, and a URL you can use to download or preview the file. This is useful when you need to verify the details of a media item before referencing it in a message or campaign. Returns 404 if no media file with the given ID exists in your library. Returns 401 if the API key is missing or invalid.
Elimina un file media
Permanently deletes a media file from your library. This action cannot be undone. Messages that have already been sent with this media are not affected because the media content was delivered at send time. However, any future message or campaign that references the deleted media ID will fail to resolve the file. Before deleting, make sure the media ID is not referenced in any scheduled campaign or message template that has not yet been sent. Returns 204 on success with no response body. Returns 404 if no media file with the given ID exists in your library. Returns 401 if the API key is missing or invalid.