Revoke an App Password

DELETE

/api/v1/auth/app-passwords/{id}

curl --request DELETE \
  --url https://example.com/api/v1/auth/app-passwords/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>'

Revoke the App Password with this ID. The server also invalidates its unused setup links. An account session and a fresh assertion are required. Route: /api/v1/auth/app-passwords/{id}. Inputs: id. A recent account assertion is required. Do not automatically replay this operation after an uncertain result.

Authorizations

• installationBearer
• browserSession

Parameters

Path Parameters

id

required

string format: uuid

App password id from GET /auth/app-passwords

Responses

204

401

Media typeapplication/json

object

code

required

string

message

required

string

Example^generated

{
  "code": "example",
  "message": "example"
}

403

Media typeapplication/json

object

code

required

string

message

required

string

Example^generated

{
  "code": "example",
  "message": "example"
}

429

Media typeapplication/json

object

code

required

string

message

required

string

Example^generated

{
  "code": "example",
  "message": "example"
}