latestOpenAPI 3.1.02026-08-218667571.2 MB

a8ca30023371

Admin APIs
clients

Issue Promotional Grants

Issue a promotional token grant to a client using existing or newly created promotional tokens.

This endpoint finds an existing promotional token and issues a single grant to the client. If no promotional tokens exist, it creates a new one with a safe priority (10) to avoid conflicts. This prevents the priority conflicts that occur when creating tokens with priority 1.

Args: client_id: ID of the client to issue grant to request: Promotional grant request with amount, expires_at, and priority funding_service: Service for issuing token grants token_service: Service for finding/creating promotional tokens user: Authenticated admin user

Returns: Dict containing details of the issued grant

Raises: ValidationError: If promotional token creation fails or client not found

post/api/v1/admin/clients/{client_id}/issue-promotional-grants

Path parameters

client_idstring required

Request body

effective_atstring date-time required
expires_atstring date-time required

Response

Successful Response

{"stackTrail":"paths:/api/v1/admin/clients/{client_id}/issue-promotional-grants:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}