# Turn off a feature add-on

```http
PUT https://secure.yoprint.com/v1/api/store/{team_slug}/setting/feature_addon/{module}/disable
```

- API version: v1
- Operation ID: `v1_public_setting_feature_addon_disable`
- Section: Team settings › [Feature add-ons](https://developer.yoprint.com/reference/feature-add-ons.md)
- Web page: https://developer.yoprint.com/reference/feature-add-ons/v1-setting-feature-addon-disable/
- Authentication: `Authorization: Bearer YOUR_API_KEY`

Turns off an optional feature. The only add-on is `cust_msg_status`, "customer message statuses". Its statuses are kept, so turning it on again brings them back.

This doesn't change your YoPrint bill.

Returns the full settings object, with `cust_msg_status: false`.

## Permission

Needs the Manage Settings permission. The team owner always has it.

## Business rules

- `{module}` must be `cust_msg_status`; anything else returns 404.

## Side effects

- Team members who have YoPrint open see the setting change at once.

## Path parameters

- `team_slug` (string, required): Your team slug, shown as Team ID next to your API key in Profile. Example `your-team`.
- `module` (string, required): The add-on. The only one is `cust_msg_status`, "customer message statuses". One of: `"cust_msg_status"`. Example `cust_msg_status`.

## Request body

This operation takes no request body.

### Example request

```bash
curl -X PUT 'https://secure.yoprint.com/v1/api/store/your-team/setting/feature_addon/cust_msg_status/disable' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'X-Yoprint-Decimal-Format: exact-v1'
```

## Response

`200` Successful response.

Fields:

- `data` (object, required): The team's settings: the saved general settings (the keys "Update general settings" takes, with their defaults), `column` (list columns), `cust_msg_status` (the add-on), the three payment webhook addresses, the read-only customer portal sign-in and payment minimum fields below, and the payment gateway values stored for the team, which can include secret keys (sensitive; treat as private). A team that never changed its date formats reads `pdf_date_format: "std"` and `web_date_format: "us"`, values outside the list the update takes.
  - `column` (object | array, optional): List columns, by list name (`sales_order`, `quote`, ...). An empty array `[]` when none is saved.
  - `cust_msg_status` (boolean, optional): Whether the customer message statuses add-on is on.
  - `customer_portal_account_login_available` (boolean, optional): Read only: whether customers can sign in to your customer portal with an email account. True when your plan includes the customer portal.
  - `customer_portal_rollout` (object, optional): Read only: where the customer portal's move to email-account sign-in stands for your team. YoPrint sets the dates; you can't change them here.
    - `account_only` (boolean, required): True when customers must sign in with an email account: a portal link alone no longer opens the portal.
    - `all_teams_at` (string (date-time) | null, required): From when every team is account-only (UTC), or null when not set.
    - `configuration_warning` (string | null, required): Set when YoPrint's own rollout dates are inconsistent; null normally. One of: `"new_teams_cutoff_not_before_all_teams_cutoff"`, `"invalid_rollout_date"`.
    - `legacy_access_allowed` (boolean, required): The opposite of `account_only`: portal links still open the portal.
    - `new_teams_at` (string (date-time) | null, required): From when new teams are account-only (UTC), or null when not set.
    - `reason` (string, required): `transition`: links still work. `new_team_cutoff`: the team was created after the date for new teams. `all_teams_cutoff`: the date for every team has passed. One of: `"transition"`, `"new_team_cutoff"`, `"all_teams_cutoff"`.
  - `pagination_per_page` (integer, optional)
  - `payment_amount_policies` (map of objects, optional): Read only: the same for each of your currencies, deleted ones included, keyed by ISO code (orders keep the currency they were made in). `[]` when the team has none.
    - Each item:
      - `minimum_payment` (decimal pair, required): A decimal pair whose `value` is a string: the amount is `value` ÷ 10^`dp` (`{"value": "1000", "dp": 3}` is 1.00). YoPrint refuses smaller payments. See https://developer.yoprint.com/concepts/money-and-quantities.md.
      - `currency` (string, required)
      - `minimum_remaining_balance` (null, required): Always null here.
  - `payment_amount_policy` (object | null, optional): Read only: the smallest payment YoPrint takes in your default currency, or null when the team has no default currency.
    - `minimum_payment` (decimal pair, required): A decimal pair whose `value` is a string: the amount is `value` ÷ 10^`dp` (`{"value": "1000", "dp": 3}` is 1.00). YoPrint refuses smaller payments. See https://developer.yoprint.com/concepts/money-and-quantities.md.
    - `currency` (string, required)
    - `minimum_remaining_balance` (null, required): Always null here.
  - `paypal_webhook_url` (string (uri), optional): The same for PayPal.
  - `pdf_date_format` (string, optional): Date format on PDFs. `std` is the default for a team that never changed it; PDFs show it like `other_1` (05 Nov 2026). A team whose saved settings have no date format reads `other_1`. "Update general settings" accepts only the other five values. One of: `"std"`, `"default"`, `"british_standard"`, `"us_standard"`, `"international"`, `"other_1"`.
  - `shipping_label_create_cost_line_item` (boolean, optional): Whether "Create Shipping Cost Line Item" starts checked when someone buys a shipping label in the web app. `true` until changed.
  - `square_webhook_url` (string (uri), optional): The same for Square.
  - `stripe_webhook_url` (string (uri), optional): The address to give Stripe for this team's payment webhooks.
  - `web_date_format` (string, optional): Date format in the web app. `us` is the default for a team that never changed it; the web app shows it like `default` (Nov 05, 2026). A team whose saved settings have no date format reads `default`. "Update general settings" accepts only the other five values. One of: `"us"`, `"default"`, `"british_standard"`, `"us_standard"`, `"international"`, `"other_1"`.
- `status` (integer, required)
- `success` (boolean, required)

Example response:

```json
{
  "data": {
    "column": [],
    "cust_msg_status": false,
    "customer_portal_account_login_available": true,
    "customer_portal_rollout": {
      "account_only": false,
      "all_teams_at": null,
      "configuration_warning": null,
      "legacy_access_allowed": true,
      "new_teams_at": null,
      "reason": "transition"
    },
    "default_pricing_strategy": "job_separately",
    "dimension": "in",
    "enable_stock_management": true,
    "pagination_per_page": 50,
    "payment_amount_policies": {
      "USD": {
        "currency": "USD",
        "minimum_payment": {
          "dp": 3,
          "value": "1000"
        },
        "minimum_remaining_balance": null
      }
    },
    "payment_amount_policy": {
      "currency": "USD",
      "minimum_payment": {
        "dp": 3,
        "value": "1000"
      },
      "minimum_remaining_balance": null
    },
    "paypal_webhook_url": "https://secure.yoprint.com/api/store/your-team/webhook/v1/payment/paypal",
    "pdf_date_format": "us_standard",
    "pdf_sales_order_display_option": [
      "job_summary"
    ],
    "shipping_label_create_cost_line_item": true,
    "square_webhook_url": "https://secure.yoprint.com/api/store/your-team/webhook/v1/payment/square",
    "stripe_webhook_url": "https://secure.yoprint.com/api/store/your-team/webhook/v1/payment/stripe",
    "web_date_format": "default",
    "weight": "lbs"
  },
  "status": 200,
  "success": true
}
```

## Errors

- `401` The API key is missing or wrong (`unauthenticated`).
- `403` You are not allowed to do this. `api_access_not_in_plan`: your team's plan doesn't include API access (Pro and above, with an active subscription or trial), so every request answers this until the team upgrades. When your role lacks the permission the operation needs, the body is only `{"message": "Insufficient Permission"}`. Other refusals use the error envelope, with `unauthorized` or `user_is_not_authorized`.
  - When: Your role lacks Manage Settings. The body is `{"message": "Insufficient Permission"}`, without the error envelope. Fix: Use the key of a member whose role has Manage Settings, or the owner's.
- `404` Not found. `page_not_found`: the team slug is unknown, you are not a member of the team, or an id in the path is not one of this team's. `code: null`, with a message that starts "No query results for": there is no record with that id.
  - When: The module is not `cust_msg_status`: `error.code` `page_not_found`, `error.message` null. Fix: Use `cust_msg_status`.

## Notes

- Treat the response as sensitive: besides your preferences it can carry the payment gateway values stored for the team. Don't log or share it.

## Related

- [Turn on a feature add-on](https://developer.yoprint.com/reference/feature-add-ons/v1-setting-feature-addon-enable.md): `PUT /v1/api/store/{team_slug}/setting/feature_addon/{module}/enable`
