Search

Search for the users eligible to act as approvers

post

Searches for the users who can be assigned to the approvals. The user must be a Requestor or an Approver to have the required approval.approval_read_own scope.

In case of any validation problem, the below errorCodes can be returned:

• APPROVAL-400008: Requested user has no permissions to the resource.
• APPROVAL-400011: Requested user is not assigned to any company.
• APPROVAL-404002: Provided resource does not exist.
• APPROVAL-404003: Requested user is not assigned to any legal entity.

Authorizations

AuthorizationstringRequired

To generate a customer access token, go to the Logging in a customer endpoint.

Path parameters

tenantstring · min: 3 · max: 16Required

Your Emporix tenant name. Note: The tenant name should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$

Body

resourceTypestring · enumRequired

Type of resource under approval.

Possible values:

resourceIdstringRequired

An identifier of the resource for approval.

actionstring · enumRequired

Base schema for an approval action type.

Possible values:

Responses

200

Approval permitted response.

application/json

Base schema search approval users response.

userIdstringRequired

An identifier of the user.

firstNamestringRequired

First name of the user.

lastNamestringRequired

Last name of the user.

400

Bad request due to validation, incorrect parameters, etc.

application/json

401

Unauthorized.

application/json

403

Access forbidden. The caller is not allowed to access this resource.

application/json

post/approval/{tenant}/search/users

POST /approval/{tenant}/search/users HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "resourceId": "cartId",
  "resourceType": "CART",
  "action": "CHECKOUT"
}

[
  {
    "userId": "aaa2f2b6-7dc8-45ff-9f20-4e6163c14ceb",
    "firstName": "John",
    "lastName": "Doe"
  }
]