---
title: "Update API subscription settings"
method: POST
path: "/manage/api/subscription"
tags: ["manage"]
---

# Update API subscription settings

`POST /manage/api/subscription`

## Query parameters

- `organization_id` string, required

## Request body

- PostApiSubscriptionRequest — Request to update API settings. Fields which are omitted will be ignored.
  - `recharge_settings` RechargeSettings — The current recharge settings for the API subscription.
    - `top_up_balance` Price, required — Represents a price.
      - `currency_code` string, required — The ISO 4217 currency code for the price object.
      - `amount` number, required — The amount of the currency in the common denomination. For example, in USD this is cents.
    - `minimum_balance_threshold` Price, required — Represents a price.
      - `currency_code` string, required — The ISO 4217 currency code for the price object.
      - `amount` number, required — The amount of the currency in the common denomination. For example, in USD this is cents.
  - `is_active` boolean — Whether to enable or disable auto recharge.

## Response `200`

API subscription content

- PostApiSubscriptionResponse — The updated API subscription.
  - `recharge_settings` RechargeSettingsResponse — The current recharge settings for the API subscription.
    - `top_up_balance` Price, required — Represents a price.
      - `currency_code` string, required — The ISO 4217 currency code for the price object.
      - `amount` number, required — The amount of the currency in the common denomination. For example, in USD this is cents.
    - `minimum_balance_threshold` Price, required — Represents a price.
      - `currency_code` string, required — The ISO 4217 currency code for the price object.
      - `amount` number, required — The amount of the currency in the common denomination. For example, in USD this is cents.

## Other responses

- `400` — Bad request
- `401` — Not authorized
- `403` — Not authorized

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/b560c0ad0618/schema)