---
title: "[BETA] Disables a signal endpoint."
method: POST
path: "/api/admin/signal-endpoints/{id}/off"
tags: ["Operational"]
---

# [BETA] Disables a signal endpoint.

`POST /api/admin/signal-endpoints/{id}/off`

**Enterprise feature**

**[BETA]** This API is in beta state, which means it may change or be removed in the future.

Disables an existing signal endpoint, identified by its id.

## Path parameters

- `id` string, required

## Response `200`

#/components/schemas/signalEndpointSchema

- SignalEndpointSchema — An object describing a signal endpoint.
  - `id` integer, required — The signal endpoint's ID. Signal endpoint IDs are incrementing integers. In other words, a more recently created signal endpoint will always have a higher ID than an older one.
  - `enabled` boolean, required — Whether the signal endpoint is currently enabled. If not specified, defaults to true.
  - `name` string, required — The signal endpoint name. Must be URL-safe.
  - `description` string, nullable — A more detailed description of the signal endpoint and its intended use.
  - `createdAt` string, date-time, required — The date and time of when the signal endpoint was created.
  - `createdByUserId` integer, required — The ID of the user that created this signal endpoint.
  - `url` string — The full URL that should be used to call the signal endpoint. This property is only returned for newly created or updated signal endpoints.
  - `tokens` SignalEndpointTokenSchema[] — The list of tokens associated with the signal endpoint.
    - `id` integer, required — The signal endpoint token's ID. Signal endpoint token IDs are incrementing integers. In other words, a more recently created signal endpoint token will always have a higher ID than an older one.
    - `token` string — The token used for authentication. It is automatically generated by Unleash when the token is created and that is the only time this property is returned.
    - `name` string, required — The signal endpoint token name.
    - `signalEndpointId` integer, required — The signal endpoint ID that this token belongs to.
    - `createdAt` string, date-time, required — The date and time of when the signal endpoint token was created.
    - `createdByUserId` integer, required — The ID of the user that created this signal endpoint token.

## Other responses

- `401` — Authorization information is missing or invalid. Provide a valid API token as the `authorization` header, e.g. `authorization:*.*.my-admin-token`.
- `403` — The provided user credentials are valid, but the user does not have the necessary permissions to perform this operation
- `404` — The requested resource was not found.

---

[API](https://skmtc.net/unleash/apis/unleash-api-3.md) · [All operations](https://skmtc.net/unleash/apis/unleash-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unleash/unleash-api-3/versions/b2c3116e633e/schema)