> ## Documentation Index
> Fetch the complete documentation index at: https://sequin.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Start collection refresh

> This endpoint starts a refresh of a credential's collections.

## Request parameters

<ParamField path="credential_id" type="string" required>
  ID of the credential.
</ParamField>

## Response fields

<ResponseField name="credential_id" type="string">
  ID of the credential.
</ResponseField>

<ResponseField name="last_started_at" type="string">
  The time Sequin last started the latest refresh of the credential's collections. A datetime in ISO 8601 format.
</ResponseField>

<ResponseField name="last_succeeded_at" type="string">
  The time Sequin last successfully refreshed the credential's collections. A datetime in ISO 8601 format.
</ResponseField>

<ResponseField name="status" type="string">
  The status of the last refresh task. One of `processing`, `succeeded`, or `failed`.

  `processing` indicates Sequin is currently refreshing the credential's collections.
</ResponseField>

<ResponseField name="error" type="object">
  If the latest refresh attempt failed (i.e. `state` is `failed`), this field contains details about the error.
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "credential_id": "5f4b3b3e-4e3e-4b3b-8e3e-4b3e4b3e4b3e",
    "last_started_at": "2024-07-01T00:00:00Z",
    "last_succeeded_at": "2024-06-31T23:24:09Z",
    "status": "processing",
    "error": null
  }
  ```
</ResponseExample>