---
title: "Create a Scout credits top-up intent"
method: POST
path: "/api/account/scout-credits/intent"
tags: ["Scout Credits"]
---

# Create a Scout credits top-up intent

`POST /api/account/scout-credits/intent`

## Request

- Base URL: `https://flint.network`
- URL: `https://flint.network/api/account/scout-credits/intent`
- Auth: one of:
  - API key in cookie `flint_session`
  - HTTP bearer

Session required (WorkOSOwnerSession cookie or bearerAgentSession bearer token) so FLINT knows which account to credit before any money moves. Returns an sct_ topup_id good for 24 hours and its pay_url: POST /api/x402/scout-credits/{topup_id}, a route that needs no session to pay, so a stock x402 client's unauthenticated discovery request (awal x402 pay, for example) can settle it. Rate limited to 10 intents per rolling hour per account.

## Response `200`

Intent created.

- ScoutCreditsTopupIntentResponse
  - `ok` unknown, required
  - `topup_id` string, required
  - `pay_url` string, uri, required: POST /api/x402/scout-credits/{topup_id}. No session needed to pay it.
  - `expires_at` string, date-time, required
  - `credits` unknown, required
  - `price_usd` unknown, required

## Other responses

- `401`: No WorkOSOwnerSession cookie or bearerAgentSession token was presented.
- `429`: The cheap caller-admission quota for paid attempts was exceeded.
- `500`: Server error

---

[API](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api.md) · [All operations](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api/revisions/eb5052b7b5dc?raw)