approvals

Create approval request

The new approval request will be created based on approval request with provided baseId. If base approval request is pending, it will be abandoned. The newly created request will contain new id, type, decision mode and steps, as well as PENDING statuses and decisions.

post/approvals

Request

  • Base URL
    https://api.smartrecruiters.com/approvals-api/v201910
  • URL
    https://api.smartrecruiters.com/approvals-api/v201910/approvals
  • Auth
    • API key in header x-smarttoken
    • or OAuth 2
      Authorization code: https://www.smartrecruiters.com/identity/oauth/allow
      Token URL: https://api.smartrecruiters.com/identity/oauth/token scopes: approvals_create

Request body

baseIdstring required

Approval request id

type'sequential' | 'parallel' required
decisionMode'any' | 'all' required

Response

Approval request created

idstring

Approval request id

type'sequential' | 'parallel'
decisionMode'any' | 'all'
status'PENDING' | 'APPROVED' | 'REJECTED' | 'ABANDONED'

Status of approval request

Example response

{
  "status": "APPROVED",
  "steps": [
    {
      "status": "APPROVED",
      "approvers": [
        {
          "decision": "APPROVED"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.