push

Ask Permission

The desk asks this business's phones for a capability.

TWO SURFACES, ONE ASK. The card lands in the chat (the phone reads its open asks and draws it over the composer) and a notification carries the same ask to a phone that is in a pocket — stormy://permission/<capability> opens the pre-prompt straight from the banner. The notification is best effort: a phone that refused notifications is exactly the phone this is most often used on, and a failed banner must never fail the ask.

post/v1/teams/{team_id}/push/permissions/ask

Path parameters

team_idstring uuid required

Headers

authorizationstring nullable
x-darwin-tokenstring nullable

Request body

capabilitystring required
whystring
installation_idstring

Response

Successful Response

object required

Changes

Changed in 1 of the 32 revisions of this API.1

Of the 32 revisions, 1 has no diff computed.