FruxonDocs
IntegrationsAssets

Re-fetch and re-ingest documents from an asset's original source.

Starts an asynchronous refresh against the asset's stored source configuration: fetches current documents, diffs against what is already indexed, and updates documents and chunks accordingly. Returns immediately with a `LongOperation`; clients poll `GET /assets/{asset}/operations/{operation}` until state is `Completed` or `Failed`. When `documentIds` is supplied only the listed documents are refreshed (useful for webhook-driven incremental updates); otherwise the full source is re-scanned. Concurrent refreshes for the same asset are rate-limited.

POST
/v1/tenants/{tenant}/assets/{asset}:refresh

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 asset ID.

Formatuuid
tenant*string

The tenant identifier

Request Body

Optional body. When documentIds is provided, only those documents are refreshed; otherwise all documents are replaced.

documentIds?|null
force?boolean|null
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08:refresh" \  -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"
  },
  "longOperation": {
    "name": "string",
    "status": "PENDING",
    "resourceName": "string",
    "resourceType": "string",
    "startedAt": 0,
    "completedAt": 0,
    "error": "string",
    "metadata": {}
  }
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

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.

Regenerates the webhook URL for an asset with auto-update enabled

Rotates the webhook secret backing the asset's auto-update subscription: the previous URL stops accepting deliveries immediately. The new URL is returned only on this response, so capture it before navigating away. Only valid for assets created with auto-update enabled against a manual-registration provider; returns 400 otherwise. After rotation the user must reconfigure the source system to point at the new URL.