Grants, vesting & distributions

Update Pending Grant

Updates a grant's core and schedule fields plus tags, regenerating vestings and lockups when the schedule changes.

POSThttps://api.toku.com/tga/update-pending-grant

Not available to API keys yet. It will need grants:write.

curl --request POST \
  --url 'https://api.toku.com/tga/update-pending-grant' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "grantID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "grantName": "string",
  "grantDescription": "string",
  "grantConfigurationID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "grantAmount": 0,
  "allocationType": "string",
  "vestingStartDate": "2026-01-01T00:00:00Z",
  "grantDate": "2026-01-01T00:00:00Z",
  "vestingFrequencyType": "MONTHLY",
  "vestingCliffPercentage": 0,
  "vestingCliffPeriods": 0,
  "vestingPeriods": 0,
  "isCashCompensation": true,
  "scheduleStringOverride": "string",
  "section83BElectionEligible": true,
  "isTaxable": true,
  "taxCurrencyCode": "TRY",
  "grantAdminCurrencyCode": "TRY",
  "offPlatformDate": "2026-01-01T00:00:00Z",
  "tags": [
    "string"
  ],
  "pricePerUnit": 0,
  "priceTotal": 0,
  "vestingScheduleOverride": true,
  "autoVesting": true,
  "grantTemplateID": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
200 response
{
  "grantID": "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
grantNamestringrequired

Allowed: 1 to 200 characters

grantDescriptionstringrequired

Allowed: at most 5000 characters

grantConfigurationIDstring<uuid>required
grantAmountnumberrequired

Allowed: at least 0

allocationTypestring | null

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

Allowed: at most 100 characters

vestingStartDatestring<date-time>required
grantDatestring<date-time>
vestingFrequencyTypestringrequired

Available options: MONTHLY, QUARTERLY, SEMIANNUALLY, YEARLY, CUSTOM, DAILY, WEEKLY

vestingCliffPercentagenumberrequired

Allowed: 0 to 100

vestingCliffPeriodsintegerrequired

Allowed: at least 0

vestingPeriodsintegerrequired

Allowed: at least 0

isCashCompensationboolean
scheduleStringOverridestring | null

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

Allowed: at most 500 characters

section83BElectionEligibleboolean
isTaxableboolean
taxCurrencyCodestring

Available options: TRY, ILS, CRC, TTD, SGD, JPY, AUD, NOK, INR, GBP, CHF, RUB, CAD, BRL, NGN, KRW, AED, LBP, EUR, NZD, ZAR, USD, USDC, USDT, USDP, PHP, PLN, RSD, HKD, TWD, AFN, AMD, ANG, AOA, ARS, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BSD, BTN, BWP, BYN, BZD, CDF, CLF, CLP, CNY, COP, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, FJD, FKP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HNL, HRK, HTG, HUF, IDR, IQD, IRR, ISK, JMD, JOD, KES, KGS, KHR, KMF, KPW, KWD, KYD, KZT, LAK, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NPR, NIO, OMR, PAB, PEN, PGK, PKR, PYG, QAR, RON, RWF, SAR, SBD, SCR, SDG, SHP, SLL, SOS, SRD, SSP, STN, SVC, SYP, SZL, TJS, TMT, TND, TOP, TZS, UAH, UGX, UYU, UZS, VES, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZMW, SEK, THB

grantAdminCurrencyCodestring

Available options: TRY, ILS, CRC, TTD, SGD, JPY, AUD, NOK, INR, GBP, CHF, RUB, CAD, BRL, NGN, KRW, AED, LBP, EUR, NZD, ZAR, USD, USDC, USDT, USDP, PHP, PLN, RSD, HKD, TWD, AFN, AMD, ANG, AOA, ARS, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BSD, BTN, BWP, BYN, BZD, CDF, CLF, CLP, CNY, COP, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, FJD, FKP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HNL, HRK, HTG, HUF, IDR, IQD, IRR, ISK, JMD, JOD, KES, KGS, KHR, KMF, KPW, KWD, KYD, KZT, LAK, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NPR, NIO, OMR, PAB, PEN, PGK, PKR, PYG, QAR, RON, RWF, SAR, SBD, SCR, SDG, SHP, SLL, SOS, SRD, SSP, STN, SVC, SYP, SZL, TJS, TMT, TND, TOP, TZS, UAH, UGX, UYU, UZS, VES, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZMW, SEK, THB

offPlatformDatestring<date-time>
tagsstring[]required

Allowed: at most 100 items

pricePerUnitnumber

Allowed: at least 0

priceTotalnumber

Allowed: at least 0

vestingScheduleOverrideboolean
autoVestingboolean
grantTemplateIDstring<uuid>

Response

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