List My Promotions

GET

users

promotions

List My Promotions

curl --request GET \
  --url https://api.example.com/v1/users/me/promotions \
  --header 'Authorization: Bearer <token>'

{
  "active": [
    {
      "redemption_id": "<string>",
      "name": "<string>",
      "ops_granted": 123,
      "ops_remaining": 123,
      "redeemed_at": "<string>",
      "expires_at": "<string>"
    }
  ],
  "history": [
    {
      "redemption_id": "<string>",
      "name": "<string>",
      "ops_granted": 123,
      "ops_remaining": 123,
      "redeemed_at": "<string>",
      "expires_at": "<string>",
      "status": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization

string | null

Response

Successful Response

Listing of the authenticated user's promotion grants, split by active vs. history.

active

ActivePromotionOut · object[]

required

Show child attributes

history

HistoricalPromotionOut · object[]

required

Show child attributes

Get a pre-signed URL to upload large files (.docx/PDF/HTML/MD/RTF) without bloating agent context.Returns a short-lived (5-minute) PUT URL plus a curl example. **If you have shell access (Bash tool), execute the returned `curl_example` yourself to push the file directly to cloud storage — do NOT paste the curl command back to the user expecting them to run it manually. Only fall back to returning the curl text when shell execution is genuinely unavailable.** Bytes never pass through the agent's context window either way. After upload completes, call process_uploaded_document with the upload_id to trigger parsing. For files <100KB where token cost is trivial, upload_document_base64 still works inline. Max file size: 100 MB. Supported formats: .pdf, .docx, .txt, .rtf, .md, .html, .htm.

List My Promotions

curl --request GET \
  --url https://api.example.com/v1/users/me/promotions \
  --header 'Authorization: Bearer <token>'

{
  "active": [
    {
      "redemption_id": "<string>",
      "name": "<string>",
      "ops_granted": 123,
      "ops_remaining": 123,
      "redeemed_at": "<string>",
      "expires_at": "<string>"
    }
  ],
  "history": [
    {
      "redemption_id": "<string>",
      "name": "<string>",
      "ops_granted": 123,
      "ops_remaining": 123,
      "redeemed_at": "<string>",
      "expires_at": "<string>",
      "status": "<string>"
    }
  ]
}