Lists a person's open identity links.
Newest first, whoever started them: an operator here, or the person from a conversation. The links themselves are never listed. A link that was used, withdrawn, superseded or ran out is not open and is not listed.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The participant identifier.
uuidThe tenant identifier
Query Parameters
The maximum number of items to return per page
int32int32Opaque pagination token returned by an external service. Pass it back unchanged rather than interpreting it as an offset.
Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/participants/497f6eca-6276-4993-bfeb-53cbbbba6f08/identityLinks"{
"items": [
{
"requestId": "00000000-0000-0000-0000-000000000000",
"provider": "string",
"address": "string",
"direction": "PUSH",
"expiresAt": 0,
"status": "OPEN"
}
],
"nextPageToken": "string",
"totalCount": 0
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Returns a single participant with their channels and current agent bindings.
Fetches one participant by id, including its inline channel list and the set of agents it is currently bound to. Returns 404 when no participant with that id exists in the tenant.
Sends one of a person's identities a verification.
For a mailbox (`email`, the directory email, or a mail channel's address) the six-digit code is mailed to the address alone and the answer is `PUSH` with no link: the person replies to that mail with the code, and the reply goes to the workspace's email channel, named in `replyTo`. For Telegram and WhatsApp the answer is `PULL` with the link the person opens from that account; for Slack, the code they send the app in a direct message; for the console, `CONSOLE` with the link they open signed in. The link works once, for 15 minutes, and only from the identity it names. Refused with 400 without an address, 400 `address_not_on_person` for an identity the person does not carry, 400 `not_sendable` for an account the person proves by connecting it (GitHub, Jira, GitLab, Linear), 400 `no_reply_mailbox` for a mailbox when the workspace has no email channel to reply to, 409 `identity_held` with the merge suggestion's id (`mergeSuggestionId` beside `message` and `code`) when someone else in the workspace holds it, and 429 `too_many_links` while the person already has three links open (`Retry-After` says when the first expires).