Requests

Cancel a request

Changed on

Cancel a request on behalf of the user who created the API token. The user must be the requester, an admin, or a department manager with appropriate permissions.

post/requests/{id}/cancel

Request

  • Base URL
    https://api.absentify.com/api/v1
  • URL
    https://api.absentify.com/api/v1/requests/{id}/cancel
  • Auth
    API key in header X-API-KEY

Path parameters

idstring uuid required

Request body

cancel_reasonstring required
revisioninteger

Revision you last saw (from GET /requests/{id} or the webhook). If the request was changed since, the call fails with 409 and nothing happens.

Response

Successful response

successboolean required
messagestring required

Changes

    • info

      added the new optional request property

    • warning

      changed the pattern of the path request parameter id from ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ to ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$