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

Request

  • Base URL: https://carbonarc.ai (the document declares no server; this is the origin it was published from)
  • URL: https://carbonarc.ai/api/v1/admin/clients/{client_id}/issue-promotional-grants
  • Auth: OAuth 2 (authorization code, authorization URL authorize, token URL token)

Path parameters

client_idstring required

Request body

effective_atstring date-time required
expires_atstring date-time required

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 4 revisions of this API.