---
title: "Disable subscription form"
method: POST
path: "/subscription-forms/{subscriptionFormId}/_disable"
tags: ["Subscription Forms"]
---

# Disable subscription form

`POST /subscription-forms/{subscriptionFormId}/_disable`

Disable the subscription form to hide it from API consumers in the Developer Portal.
When disabled, the form will not be displayed during the API subscription process.

This operation is idempotent - disabling an already disabled form returns success.

User must have the ENVIRONMENT_SETTINGS[UPDATE] permission.

## Path parameters

- `subscriptionFormId` string, uuid, required

## Response `200`

Subscription form disabled successfully

- SubscriptionForm — Subscription form definition used by API consumers when subscribing to APIs
  - `id` string, uuid, required — Unique identifier of the subscription form
  - `gmdContent` string, required — Gravitee Markdown (GMD) content defining the form. Supports form components like gmd-input, gmd-textarea, gmd-select, gmd-checkbox, gmd-radio.
  - `enabled` boolean, required — Whether the form is enabled and visible to API consumers in the Developer Portal
  - `resolvedOptions` object — Resolved option lists for fields that use EL expressions. Keys are field keys; values are the effective option lists (fallback values when no API context is available). Present only when at least one field has dynamic options.

## Other responses

- `404` — No subscription form exists with this ID
- `default` — Generic error response

---

[API](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) · [All operations](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gravitee-io/gravitee-io-apim-management-api-environments/versions/37e8cbe5f769/schema)