FruxonDocs
IntegrationsConfigs

Records that the operator granted this config's connected account access to one provider-side resource — a file or folder chosen in the provider's picker.

Needed for scopes that don't determine reach on their own: Google's `drive.file` grants access to nothing except files Fruxon created or the user explicitly picked, so without this list such a connection can't touch a single pre-existing file. This mirrors a grant that actually lives at the provider — picking the file in the Picker is what grants it; this call records that it happened so the config page can show it and, later, so a tool call can pre-flight against it. Recording a resource here does <b>not</b> grant anything, and re-posting an existing id refreshes its stored name rather than erroring. Deliberately separate from the anonymous `oauth/authentication-completed` callback, which records the same fact from the mid-run OAuth redirect and is keyed on an encrypted flow token. This one is an authenticated operator action against a specific config.

POST
/v1/tenants/{tenant}/integrations/{integration}/configs/{config}/resources
AuthorizationBearer <token>

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

In: header

Path Parameters

integration*string

The integration ID.

config*string

The configuration ID.

Formatuuid
tenant*string

The tenant identifier

Query Parameters

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.

The resource being recorded.

id*string

Provider-native resource id (e.g. a Google Drive file or folder id).

Length1 <= length <= 150
displayName?string|null

Name shown to the operator, as the picker reported it. Optional, but strongly preferred — a bare provider id identifies nothing to a human reading the config page later.

Lengthlength <= 150
kind?string|null

Provider's own word for the resource kind ("file", "folder").

Lengthlength <= 150
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/integrations/string/configs/497f6eca-6276-4993-bfeb-53cbbbba6f08/resources" \  -H "Content-Type: application/json" \  -d '{    "id": "string"  }'
{
  "items": [
    {
      "id": "string",
      "displayName": "string",
      "kind": "string",
      "grantedAt": 0
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}