FruxonDocs
IntegrationsAssets

Updates an asset's mutable settings (e.g

Patches only the fields supplied in the request body; omitted fields are left untouched. Token-budget changes are pushed to the RAG service and take effect on subsequent searches without re-ingestion. Toggling auto-update may create a webhook; when the provider requires manual registration the response includes the webhook URL — it is returned only once, so store it. To rotate that URL later call `POST /assets/{asset}:regenerateWebhook`. Returns 400 if the asset is not vectorized and the request attempts to change vector-dependent settings.

PATCH
/v1/tenants/{tenant}/assets/{asset}

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

asset*string

The local asset ID.

Formatuuid
tenant*string

The tenant identifier

Request Body

Fields to update. Only provided fields are applied.

displayName?string|null
budget?

Token budget limits for a RAG asset ingestion.

currencyBudget?

Currency-based asset budget configuration in USD. Converted to token budget using the asset's embedding model pricing.

embedding?

Embedding and chunking settings for a partial asset update. All fields are optional — only provided fields are applied. Changing Fruxon.Rag.RagUpdateEmbeddingConfig.Provider, Fruxon.Rag.RagUpdateEmbeddingConfig.Model, Fruxon.Rag.RagUpdateEmbeddingConfig.ChunkSize, or Fruxon.Rag.RagUpdateEmbeddingConfig.ChunkOverlap triggers re-ingestion.

sourceConfig?|null
embeddingLlmConfigId?string|null

Optional reference to a tenant-level LLM config for embedding credentials. Used when vectorizing an asset for the first time via update.

Formatuuid
autoUpdate?

Describes how an asset should be kept up-to-date. Stored as a nullable JSONB column on the asset entity. When null, auto-update is disabled.

disableAutoUpdate?boolean

When true, disables auto-update for this asset (removes webhook subscription). Takes precedence over Fruxon.Model.Assets.UpdateAssetRequest.AutoUpdate when both are provided.

[key: string]?never

Response Body

curl -X PATCH "https://api.fruxon.com/v1/tenants/string/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{
  "asset": {
    "id": "string",
    "displayName": "string",
    "type": "string",
    "vectorized": false,
    "config": {
      "sourceType": "string",
      "parameters": {}
    },
    "integrationId": "string",
    "assetLink": "string",
    "createdAt": 0,
    "modifiedAt": 0,
    "autoUpdate": false,
    "autoUpdateConfig": {
      "strategy": "WEBHOOK",
      "provider": "string",
      "externalContext": "string",
      "filter": "string",
      "pollFrequency": "DAILY",
      "pollDay": "string",
      "pollDayOfMonth": "_1",
      "pollHour": "string",
      "pollMinute": "string",
      "timezone": "string"
    },
    "lastPolledAt": 0,
    "embeddingLlmConfigId": "string",
    "supportsAutoUpdate": false,
    "supportsWebhookRegistration": false,
    "supportsPollSchedule": false,
    "embedding": {
      "provider": "string",
      "model": "string",
      "chunkSize": 0,
      "chunkOverlap": 0
    },
    "budget": {
      "tokenBudget": 0,
      "monthlyTokenBudget": 0,
      "dailyTokenBudget": 0,
      "totalTokenCount": 0,
      "monthlyTokensUsed": 0,
      "dailyTokensUsed": 0,
      "costBudget": 0,
      "monthlyCostBudget": 0,
      "dailyCostBudget": 0,
      "totalCost": 0,
      "monthlyCostUsed": 0,
      "dailyCostUsed": 0,
      "pricePerMillionTokens": 0
    },
    "embeddingStatus": "PENDING",
    "errorCategory": "CREDENTIALS"
  },
  "webhook": {
    "id": "string",
    "provider": "string",
    "authMode": "API_KEY",
    "status": "ACTIVE",
    "expiresAt": 0,
    "createdAt": 0,
    "modifiedAt": 0,
    "webhookUrl": "string",
    "signingSecret": "string"
  }
}
{
  "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
}

Requests cancellation of a pending or in-progress ingestion operation.

Signals the worker to stop and marks the operation `Cancelled` once it observes the signal; chunks that were already embedded and persisted remain in the index. Returns the operation in its post-signal state — typically still `Running` for a short window before transitioning. Already-terminal operations (`Completed`, `Failed`, `Cancelled`) are returned unchanged; the call is idempotent. To remove partial results, follow with `POST /assets/{asset}:refresh` or delete affected documents.

Creates an asset from a configuration dictionary.

The accepted config keys and their requirements are defined by the source type descriptor returned from the `source-types` endpoint.