---
title: "Hydrate files"
method: PUT
path: "/runs/{id}/files/hydrate"
tags: ["Runs"]
---

# Hydrate files

`PUT /runs/{id}/files/hydrate`

## Request

- Base URL: `https://localhost:8446/api/v2`
- URL: `https://localhost:8446/api/v2/runs/{id}/files/hydrate`
- Auth: API key in header `Authorization`

Files that match this rule are automatically downloaded in cache. Supported by File Caching and Hybrid Work jobs.

## Path parameters

- `id` number, required

## Request body

- object
  - `files` string: Files. Maximum 1000 files per request.
  - `agents` number: Agents. Array of agent ids, if you want specify
  - `groups` number: Groups. Array of groups ids, if you want specify

## Response `200`

Successful response

- object
  - `agents` object, required: List of agents
  - `agents.id` number, required: Agent id
  - `agents.name` string, required: Agent name
  - `agents.status` string, required: Request status for this agent. Possible values: sent - List of files sent for this agent error - Agent has an error
  - `agents.errorMessage` string: Error message
  - `agents.info` object: Dictionary with counts of processed files

## Other responses

- `default`: Error response. Depending on the error, either a 4xx or 5xx response status is returned.

---

[API](https://skmtc.dev/resilio/apis/resilio-api.md) - [All operations](https://skmtc.dev/resilio/apis/resilio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/resilio/apis/resilio-api/revisions/ca39130a395e?raw)