Skip to main content

Cancel slides agent message

POST https://api.rollstack.com/public/v1/reports/{id}/messages/{messageId}/cancel

Stops a message to the slides agent: a queued one leaves the queue, and a running one stops. A finished one stays as it is. Only the user who sent it may.

Requires the slide_decks:run scope.

Operation ID: cancelReportMessage.

Path parameters

  • id (string, required): The report to act on, by its id from listReports or createReport. Only reports whose type is SlideDeck work here: another type, such as a Google Slides presentation, returns 400. You can also copy it from the report's link in Rollstack: it's the part right after /slides/.
  • messageId (string, required): The message to the slides agent: the messageId that sendReportMessage returned. Only the user who sent the message can read, cancel or decide its proposals, and only while they can edit the report.

Headers

  • Idempotency-Key (string): A unique value, such as a UUID, that makes retrying this call safe. A retry with the same key within 24 hours answers the first call's result instead of running it again. Use a new key for each new call. From 1 to 255 printable ASCII characters.

Response 204

Success, no content