FruxonDocs
IntegrationsConfigs

Rolls back the configuration to a previously published revision.

Repoints `PublishedRevisionId` at the target revision without creating a new revision or version number; the draft on the config record is not modified. The target must already exist in this config's history — use `/integrations/{integration}/configs/{config}/revisions` to list valid IDs first.

POST
/v1/tenants/{tenant}/integrations/{integration}/configs/{config}:rollback

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

Request Body

The revision to roll back to.

revisionId*string
Formatuuid
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/integrations/string/configs/497f6eca-6276-4993-bfeb-53cbbbba6f08:rollback" \  -H "Content-Type: application/json" \  -d '{    "revisionId": "bae12d01-48af-47b3-9304-b09ef0081cd6"  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "tenantId": "f97df110-f4de-492e-8849-4a6af68026b0",
  "configId": "46ff6d11-d8b2-40d8-9197-dfa33c61cd6c",
  "version": 0,
  "parameters": {
    "property1": "string",
    "property2": "string"
  },
  "auth": {
    "integrationAuthMetadataId": "string",
    "level": "UNSPECIFIED",
    "parameters": {
      "property1": "string",
      "property2": "string"
    }
  },
  "authMap": [
    {
      "parameters": {
        "property1": "string",
        "property2": "string"
      },
      "authConfig": {
        "integrationAuthMetadataId": "string",
        "level": "UNSPECIFIED",
        "parameters": {
          "property1": "string",
          "property2": "string"
        }
      }
    }
  ],
  "sandboxMode": "UNSPECIFIED",
  "sandboxVariant": {
    "parameters": {
      "property1": "string",
      "property2": "string"
    },
    "auth": {
      "integrationAuthMetadataId": "string",
      "level": "UNSPECIFIED",
      "parameters": {
        "property1": "string",
        "property2": "string"
      }
    },
    "authMap": [
      {
        "parameters": {
          "property1": "string",
          "property2": "string"
        },
        "authConfig": {
          "integrationAuthMetadataId": "string",
          "level": "UNSPECIFIED",
          "parameters": {
            "property1": "string",
            "property2": "string"
          }
        }
      }
    ]
  },
  "note": "string",
  "createdBy": "string",
  "createdAt": 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
}

Lists all revisions for a configuration.

Returns every published revision ever created for the config, ordered as stored (filter or sort client-side by `Version` for chronological order). Compare entries against the config's `PublishedRevisionId` to identify the currently active one; older revisions are retained for rollback via `:rollback`. Secret values are masked as on the config itself.

Lists agents that reference this configuration.

Returns every agent whose current revision has an integration config entry pointing to this tenant config via `TenantConfigId`. Use this before deleting or rolling back a config to understand the impact.