Cards, prop trading & accounting

Set Card Pin

Sets a 4-digit PIN on a Rain card via encrypted session, only for the worker who holds the card; admins are refused.

POSThttps://api.toku.com/hris/set-card-pin

Not available to API keys.

curl --request POST \
  --url 'https://api.toku.com/hris/set-card-pin' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "rainCardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "pin": "string",
  "orgID": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
200 response
{
  "success": true,
  "message": "string"
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is an access token from a Toku sign-in. See Authentication in the API reference.

Body

application/json

rainCardIdstring<uuid>required
pinstringrequired

Allowed: 4 to 4 characters, matches ^\d+$

orgIDstring<uuid>required

Response

200Successful response
successboolean
messagestring
400Bad request
401Unauthorized
403Forbidden
404Not found
409Conflict
429Response 429
Was this page helpful? Suggest edits