Grant Terminations

Overview

When an employee leaves or a grant needs to be cancelled, you can terminate their grants. Termination recalculates the vesting schedule — only tokens that have vested up to the termination date remain; future vestings are cancelled.

Terminating a Single Grant

Navigate to the grant

Go to Grants and find the grant to terminate.

Click Terminate

Open the grant detail and click Terminate Grant.

Set the termination date

Choose the effective termination date. Vestings after this date will be cancelled.

Confirm

Review the impact and confirm. The grant status changes to TERMINATED.

API: Use Terminate Grant with the grantID and terminationDate.

Terminating All Grants for an Employee

When an employee leaves, terminate all their active grants at once:

API: Use Terminate Employee Grants with the externalEmployeeID and terminationDate. If grantIDs is omitted, all active grants are terminated.

curl -X POST https://app.toku.com/api/tokuApi/v1/terminateEmployeeGrants \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "x-role-type: CLIENT_ORG_ADMIN" \
  -H "Content-Type: application/json" \
  -d '{
    "externalEmployeeID": "EMP-001",
    "terminationDate": "2026-06-30T00:00:00.000Z"
  }'

Response:

{
  "terminatedGrantIDs": ["grant-uuid-1", "grant-uuid-2"],
  "alreadyTerminatedGrantIDs": []
}

Bulk Termination

Terminate specific grants across multiple employees:

API: Use Terminate Grants (Bulk) with an array of grantIDs and terminationDate.

Reverting a Termination

Made a mistake? Revert a termination to restore the grant to its previous status and regenerate future vestings.

Find the terminated grant

Filter grants by status TERMINATED.

Click Revert

Open the grant and click Revert Termination.

Confirm

The grant returns to its pre-termination status with vestings regenerated.

Revert via API

Single grant:

curl -X POST https://app.toku.com/api/tokuApi/v1/revertGrantTermination \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "x-role-type: CLIENT_ORG_ADMIN" \
  -H "Content-Type: application/json" \
  -d '{"grantID": "grant-uuid"}'

All grants for an employee:

curl -X POST https://app.toku.com/api/tokuApi/v1/revertEmployeeGrants \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "x-role-type: CLIENT_ORG_ADMIN" \
  -H "Content-Type: application/json" \
  -d '{
    "externalEmployeeID": "EMP-001",
    "grantIDs": ["grant-uuid-1", "grant-uuid-2"]
  }'

Grant Status After Termination

Status	Meaning
`TERMINATED`	Grant terminated, future vestings cancelled
`MARKED_FOR_FUTURE_TERMINATION`	Termination scheduled for a future date
`ACCEPTED`	Grant restored after revert (back to active)

Terminate Grant

Terminate a single grant

Terminate Employee Grants

Terminate all grants for an employee

Revert Termination

Undo a termination

Revert Employee Grants

Bulk revert for an employee

​Overview

​Terminating a Single Grant

​Terminating All Grants for an Employee

​Bulk Termination

​Reverting a Termination

​Revert via API

​Grant Status After Termination

​Related API Endpoints

Terminate Grant

Terminate Employee Grants

Revert Termination

Revert Employee Grants

Overview

Terminating a Single Grant

Terminating All Grants for an Employee

Bulk Termination

Reverting a Termination

Revert via API

Grant Status After Termination

Related API Endpoints