Grants, vesting & distributions

Create Signable Exercise Request

Creates an exercise request plus a DocuSign embedded envelope and returns the signing URL.

POSThttps://api.toku.com/tga/create-signable-exercise-request

Not available to API keys.

curl --request POST \
  --url 'https://api.toku.com/tga/create-signable-exercise-request' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "grantID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "redemptionMethod": "TOKEN",
  "bankInfo": {}
}'
200 response
{
  "url": "string",
  "documentID": "string",
  "exerciseRequestID": "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

grantIDstring<uuid>required
numberOfUnitsToRedeemanyrequired

NOTE(ck): z.instanceof(Decimal) has no contract form; TGA still checks it

redemptionMethodstringrequired

Available options: TOKEN, CASH

bankInfoobjectrequired

NOTE(ck): a .refine() rule is not mirrored here; TGA still enforces it

Response

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