Grants

List Grants

get

List grants for the user's organization.

Args: cluster: Filter by cluster ID. kinds: Filter by grant kinds. show_expired: Include expired/deleted grants (default False).

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

clusterstring · nullableOptional

show_expiredbooleanOptionalDefault: false

Responses

200

Successful Response

application/json

itemsone ofOptional

422

Validation Error

application/json

get

/v2/grants

HTTPcURLJavaScriptPython

GET /v2/grants HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[]

Create Grant

post

Create a new grant. Only admins can create grants.

Grants provide capacity entitlements with buy-back pricing:

• unit_price: Price per unit of capacity

• early_termination_buyback_price: Price paid back for early termination

• flexible_usage_buyback_price: Price paid back for unused flexible capacity

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

anyOptional

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v2/grants

HTTPcURLJavaScriptPython

POST /v2/grants HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*

No content

Delete Grant

delete

Delete (soft-delete) a grant. Only admins can delete grants.

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

grant_fidstringRequired

Responses

204

Successful Response

422

Validation Error

application/json

delete

/v2/grants/{grant_fid}

HTTPcURLJavaScriptPython

DELETE /v2/grants/{grant_fid} HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Resell Grant

post

Resell (reduce) a grant's quantity. Only admins can resell grants.

The new quantity must be less than the current quantity. This is used to return unused capacity from grants.

Implementation:

• Creates a NEW grant with the reduced quantity

• The new grant starts now and ends at the same time as the old grant

• The old grant is soft-deleted (deleted_at = new grant's starts_at)

• This preserves the remaining duration while reducing capacity

Authorizations

MithrilAPIKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

grant_fidstringRequired

Body

application/json

Request body for reselling (reducing) a grant's quantity.

new_quantityintegerRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

post

/v2/grants/{grant_fid}/resell

HTTPcURLJavaScriptPython

POST /v2/grants/{grant_fid}/resell HTTP/1.1
Host: api.mithril.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "new_quantity": 1
}

No content