FruxonDocs
IntegrationsConfigs

Gets a configuration by ID.

Returns the current draft state of the config, not the published revision. To read what tool calls actually execute against, fetch the revision pointed to by `PublishedRevisionId` via `/integrations/{integration}/configs/{config}/revisions/{revision}`.

GET
/v1/tenants/{tenant}/integrations/{integration}/configs/{config}

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

config*string

The configuration ID.

Formatuuid
tenant*string

The tenant identifier

integration*string

The integration identifier

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/integrations/string/configs/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "id": "00000000-0000-0000-0000-000000000000",
  "integrationId": "string",
  "displayName": "string",
  "parameters": {},
  "hasAuth": false,
  "hasAuthMap": false,
  "authMethodId": "string",
  "auth": {
    "level": "APPLICATION",
    "integrationAuthMetadataId": "string",
    "grantedScopes": [
      "string"
    ]
  },
  "authMapEntries": [
    {
      "parameters": {}
    }
  ],
  "sandboxMode": "NONE",
  "sandboxVariant": {
    "parameters": {},
    "auth": {
      "integrationAuthMetadataId": "string",
      "level": "APPLICATION",
      "parameters": {}
    },
    "authMap": [
      {
        "parameters": null,
        "authConfig": null
      }
    ]
  },
  "publishedRevisionId": "00000000-0000-0000-0000-000000000000",
  "createdBy": "string",
  "createdAt": 0,
  "modifiedAt": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Verifies the auth credentials stored in the configuration.

For non-OAuth auth types (API key, bearer token, basic auth), tests whether the stored credentials can successfully connect to the integration. For OAuth2, returns an `authorizationUrl` the frontend should redirect the user to in order to complete the OAuth flow. When the config uses an AuthMap (per-request auth), each entry is verified independently and the results are returned in `authMapResults`. Use the optional `authMapIndex` query parameter to verify a single entry. Returns 400 if the config has neither Auth nor AuthMap configured.

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.