ABabsentify
Requests

Decline a request

Changed on

Decline a pending request on behalf of the user who created the API token. The API automatically finds the next pending approval and declines it with the provided reason. This acts on the request approvers only and never on a change request: to decide a change of an approved request use POST /requests/{id}/changes/{changeId}/decline.

post/requests/{id}/decline

Request

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

Path parameters

idstring uuid required

Request body

decline_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

  • d09a007f839dRevision changes
    • info

      added the new optional request property

  • 00323426aebdRevision changes
    • 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})$