FruxonDocs
IntegrationsConfigs

Lists the accounts people connected through agents.

Every account a person connected in this workspace when an agent needed their own access (an integration config at user level), newest first. Each names who connected it — the participant whose address it is held under, or the workspace member who connected it from the console — along with the integration config, the auth method, what it grants, and when it was connected and last used. Never the secret. Filter by `participantId` for one person's accounts, by `integrationConfigId` for everyone connected under one config, or both. A participant that is a group or an AI agent has none. Returns 404 when `participantId` names no participant.

GET
/v1/tenants/{tenant}/userConnections

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

tenant*string

The tenant identifier

Query Parameters

participantId?string

Only the accounts held under one of this participant's addresses.

Formatuuid
integrationConfigId?string

Only the accounts connected under this integration config.

Formatuuid
PageSize?integer

The maximum number of items to return per page

Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque cursor token from an external system (e.g. RAG API). When set, M:Fruxon.Common.Collections.PageToken.AsString returns this value directly instead of encoding Fruxon.Common.Collections.PageToken.Skip.

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/userConnections"
{
  "items": [
    {
      "connection": {
        "id": "00000000-0000-0000-0000-000000000000",
        "integrationId": "string",
        "integrationName": "string",
        "authMethodName": "string",
        "authType": "UNSPECIFIED",
        "scopes": null,
        "grantedResources": null,
        "providerAccessUrl": "string",
        "connectedAt": 0,
        "updatedAt": 0,
        "lastUsedAt": null
      },
      "chatUserKey": "string",
      "person": {
        "kind": "UNSPECIFIED",
        "participantId": null,
        "userId": "string",
        "displayName": "string"
      },
      "integrationConfigId": "00000000-0000-0000-0000-000000000000",
      "integrationConfigName": "string",
      "agentId": "string"
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Gets a specific revision of a configuration.

Returns the immutable snapshot of `Parameters`, `Auth`, and `AuthMap` captured when the revision was published, along with its version number and any publish note. The revision must belong to the supplied config; mismatched pairs return 404.

Disconnects one person's connected account.

Deletes Fruxon's copy of the account and cancels the connect links still open for that same connection. The person connects again the next time an agent needs it. Nothing is revoked at the provider: Fruxon's access stays in the person's own account until they remove it there.