Create Flow Access Link

post/v1/flows/{flow_id}/access-links

Authentication

Send your tenant secret key as a Bearer token. Keep secret keys on your server; never ship them in browser or mobile code.

Parameters

flow_id

path · required

No additional parameter description.

Request body

JSON · required

expires_in_seconds

integer | null

No additional field description.

Example request

cURL

curl --request POST \
  --url 'https://api.fideralabs.com/v1/flows/{flow_id}/access-links' \
  --header 'Authorization: Bearer $FIDERA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "expires_in_seconds": 0
}'

Responses

201Successful Response

active

booleanrequired

No additional field description.

created_at

stringrequired

No additional field description.

expires_at

stringrequired

No additional field description.

flow_id

stringrequired

No additional field description.

id

stringrequired

No additional field description.

revoked_at

string | nullrequired

No additional field description.

rotated_at

string | nullrequired

No additional field description.

url

stringrequired

Complete capability URL. Returned only by create/rotate.

application/json

{
  "active": true,
  "created_at": "2026-07-29T12:00:00Z",
  "expires_at": "2026-07-29T12:00:00Z",
  "flow_id": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "revoked_at": "2026-07-29T12:00:00Z",
  "rotated_at": "2026-07-29T12:00:00Z",
  "url": "string"
}

422Validation Error

detail

ValidationError[]

No additional field description.

Operation ID

create_flow_access_link_v1_flows__flow_id__access_links_post