SaaSFlow
DevelopersAPIReferenceaccess_requests

Retrieve access request

The state of an access request this connection made: whether the person approved it and how it went. A failed change says why in result.error; ask for a…

Authentication

Checking whether you're signed in…
GET
/companies/{companyId}/access_requests/{requestId}

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
requestId*string
Length1 <= length

Response Body

The request

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
Example Request
curl -X GET 'https://api.saasflow.com/companies/string/access_requests/string'
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"}