Revoke a pending organization invitation

DELETE

/organizations/{org_id}/invitations/{inv_id}

const url = 'https://api.perstat.io/organizations/example/invitations/example';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://api.perstat.io/organizations/example/invitations/example \
  --header 'Authorization: Bearer <token>'

Revokes a pending invitation of the organization so its token can no longer be used to join. Requires member management rights; the revocation is audited. Returns 204 on success and 404 when the invitation does not exist. Accepts API keys with the org:write scope, subject to current role and resource grants.

Authorizations

bearer

Parameters

Path Parameters

org_id

required

string

inv_id

required

string

Responses

204

Request succeeded. The response has no body.

401

Authentication is missing or invalid.

403

The authenticated caller does not have permission to perform this operation.

404

No accessible resource matches the supplied identifier.