FruxonDocs
ApiKnowledge bases

Rolls a source's applied or failed upgrade back.

The job pauses and drains again, deploys each agent's previous revision, puts the previous work shape and schedule back, removes what the upgrade created, records the previous version and resumes. Nothing is deleted from either history. It cannot undo items processed under the new version, and a stage the upgrade added can be removed only while it is empty. Refused once the upgrade is kept, once the source handed what it would write over to you, and for a revision that uses a deleted integration config — which the preview says up front.

POST
/v1/tenants/{tenant}/knowledgeBases/{knowledgeBase}/sources/{source}/upgrades/{upgrade}:rollback

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

knowledgeBase*string

The knowledge base id.

Formatuuid
source*string

The knowledge source id.

Formatuuid
upgrade*string

The upgrade id.

Formatuuid
tenant*string

The tenant identifier

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/knowledgeBases/497f6eca-6276-4993-bfeb-53cbbbba6f08/sources/497f6eca-6276-4993-bfeb-53cbbbba6f08/upgrades/497f6eca-6276-4993-bfeb-53cbbbba6f08:rollback"
{
  "id": "00000000-0000-0000-0000-000000000000",
  "ownerKind": "KNOWLEDGE_SOURCE",
  "ownerId": "00000000-0000-0000-0000-000000000000",
  "recipeKey": "string",
  "fromVersion": 0,
  "toVersion": 0,
  "status": "PLANNED",
  "failedDuring": "PLANNED",
  "detail": "string",
  "wasActive": false,
  "canRollBack": false,
  "work": {
    "agents": [
      {
        "role": "UNSPECIFIED",
        "agentId": "string",
        "action": "UNSPECIFIED",
        "targetHash": "string"
      }
    ],
    "automation": {
      "triggerId": "00000000-0000-0000-0000-000000000000",
      "action": "UNCHANGED",
      "targetHash": "string"
    },
    "drainStageIds": [
      "string"
    ]
  },
  "revisionsBefore": {},
  "revisionsAfter": {},
  "created": [
    {
      "kind": "TRIGGER",
      "role": "SOURCE",
      "resourceId": "string"
    }
  ],
  "requestedBy": "string",
  "createdAt": 0,
  "modifiedAt": 0,
  "appliedAt": 0,
  "confirmedAt": 0,
  "rolledBackAt": 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
}