Billing

Set the Developer spending limit

Changed on

Whole euros from 10 to 1000. The first unpaid cycle is also capped, and a server ceiling can be lower. 404 feature_disabled when Developer billing is off. Account keys only.

Scope: billing:manage. Acts on the account; keys bound to a customer are refused.

patch/v1/billing/developer

Request

  • Base URL: https://api.recruitmcp.com
  • URL: https://api.recruitmcp.com/v1/billing/developer
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: billing:manage)

Headers

Idempotency-Keystring

Optional on this route. At most 128 characters. When present, the same key and body replays the first response for 24 hours. A different body is 409 idempotency_key_reused. A second call waits for the first and replays it. Omit the header to run the request normally.

RecruitMCP-Version'2026-10-13'

API version. Defaults to the version the key was created with. Supported: 2026-10-13.

Request body

spend_limit_eurinteger required

Monthly limit in euros.

Response

Updated Developer billing.

object'developer_billing' required
status'inactive' | 'active' | 'suspended' | 'ending' | 'ended' required
spend_limit_eurinteger required

Customer monthly limit in euros.

effective_limit_eurnumber required

Limit that applies now, after the first-cycle cap and the server ceiling.

min_spend_limit_eurinteger
max_spend_limit_eurinteger
usage_creditsnumber required

Metered credits in the current period.

usage_eurnumber required

Metered euros in the current period.

period_startstring date-time nullable
period_endstring date-time nullable
first_invoice_paidboolean required
card_on_fileboolean required
suspended_reasonstring nullable
price_eur_per_creditnumber required

Changes

  • ad27b35513a6Revision changes
    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status