Refresh Fileset Revision

POST

///apis/files/v2/workspaces/:workspace/filesets/:name/refresh

POST

/apis/files/v2/workspaces/:workspace/filesets/:name/refresh

curl -X POST /apis/files/v2/workspaces/workspace/filesets/name/refresh

{
  "id": "string",
  "name": "string",
  "workspace": "string",
  "description": "string",
  "purpose": "dataset",
  "storage": {
    "path": "string",
    "read_chunk_size": 1048576,
    "type": "local",
    "write_buffer_size": 16777216
  },
  "metadata": {
    "dataset": {
      "schema": {},
      "schema_defs": {},
      "schemas_by_path": {}
    },
    "model": {
      "tool_calling": {
        "chat_template": "string",
        "tool_call_parser": "string",
        "tool_call_plugin": "string",
        "auto_tool_choice": true
      }
    },
    "environment": {
      "format": "string",
      "name": "string",
      "adapter_agent": "string",
      "hub_id": "string",
      "vf_env_id": "string",
      "config_paths": [
        "string"
      ]
    }
  },
  "custom_fields": {},
  "project": "string",
  "created_at": "string",
  "updated_at": "string"
}

Re-resolve a fileset’s tracked revision against its source.

A fileset created from a mutable ref is pinned to an immutable id so its contents cannot shift under a deployment. This re-resolves that same ref and repoints the fileset at whatever it names now. Everything else about the storage config, including the repository and directory, is left alone.

A running deployment keeps serving the revision it staged. It moves to this one when the runner next stages the fileset, and records the revision it staged.

Re-resolve a fileset's tracked revision against its source. A fileset created from a mutable ref is pinned to an immutable id so its contents cannot shift under a deployment. This re-resolves that same ref and repoints the fileset at whatever it names now. Everything else about the storage config, including the repository and directory, is left alone. A running deployment keeps serving the revision it staged. It moves to this one when the runner next stages the fileset, and records the revision it staged.

Path parameters

workspacestringRequired

namestringRequired

Response

Successful Response

idstring

namestring

workspacestring

descriptionstring

purposeenum

storageobject

metadataobject

Tagged metadata container - the key indicates the type.

Example: metadata = FilesetMetadata( dataset=DatasetMetadataContent( schema={“columns”: [“id”, “name”]}, ) )

custom_fieldsmap from strings to any

projectstring

created_atstring

updated_atstring

Errors

400

Bad Request Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

502

Bad Gateway Error