---
title: "Enable/disable platform-key push delivery for an app"
method: PUT
path: "/v1/push/platform/{appId}"
tags: ["Push"]
---

# Enable/disable platform-key push delivery for an app

`PUT /v1/push/platform/{appId}`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v1/push/platform/{appId}`
- Auth: HTTP bearer

Push keys uploaded to the base app serve every app of the install, with
no limits and no settings: an app without keys of its own sends with
the base app's keys, an app that uploads its own keys sends with those,
and parent/child relations between apps play no role. This switch only
turns platform-key delivery off for one app (enabled: false) or back
on; it can also be set when the app is created (`platformPushEnabled`
on POST /v1/apps and /v2/apps). Accepts a user token with
appSettings.update permission on the target app, or a server (B2B)
token of that app or of its parent app.

## Path parameters

- `appId` string, required

## Request body

- object
  - `enabled` boolean, required

## Response `200`

ok ({ ok, enabled })

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: validation error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)