SaaSFlow
DevelopersAPIReferenceaccess_requests

Revoke invitation

Ask the person to approve withdrawing an invitation nobody has accepted yet, say one sent to the wrong address. The link in the email stops working.

Authentication

Checking whether you're signed in…
POST
/companies/{companyId}/access_requests/revoke_invitation

Authorization

headerAuthorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

Path Parameters

companyId*string
Length1 <= length

Request Body

application/json
  1. body
invitationId*string

From invitations_list.

Formatuuid

Response Body

Waiting for the person to approve

application/json
  1. response
id*string
action*string
params*
status*string

pending until the person decides; succeeded, failed (see result.error), rejected, or expired after an hour without a decision.

Value in"pending""executing""succeeded""failed""rejected""expired"
result*|null
url*string

Where the person reviews and approves the request.

createdTime*string
expiresTime*string
decidedTime*string|null
nextAction*string

What to do with the link.

Example Request
curl -X POST 'https://api.saasflow.com/companies/string/access_requests/revoke_invitation' \  -H 'Content-Type: application/json' \  -d '{  "invitationId": "550a4884-8473-4f2e-a6cf-551c16767d59"}'
Example Response
{  "id": "string",  "action": "string",  "params": {    "property1": null,    "property2": null  },  "status": "pending",  "result": {    "apiKeyId": "string",    "error": "string"  },  "url": "string",  "createdTime": "string",  "expiresTime": "string",  "decidedTime": "string",  "nextAction": "string"}