---
title: "Update repo trail settings"
method: PATCH
path: "/api/v1/cache/r/{repoId}/settings/trail-settings"
tags: ["Repo Settings"]
---

# Update repo trail settings

`PATCH /api/v1/cache/r/{repoId}/settings/trail-settings`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/cache/r/{repoId}/settings/trail-settings`
- Auth: none declared

Updates the entire-api Trail enablement setting. Requires the caller to have the trails feature flag and access to the repo.

## Path parameters

- `repoId` string, required

## Request body

- object
  - `trails_enabled` boolean, required

## Response `200`

New settings values

- object
  - `settings` object, required
    - `trails_enabled` boolean, required

## Other responses

- `400`: Invalid body
- `404`: Repository not found
- `500`: Failed to update settings

## Changes

- **2026-10-20** `74a5f2d632e5`: 1 info
  - endpoint added
- **2026-10-20** `2e642485ff74`: 1 breaking
  - api path removed without deprecation
- **2026-10-20** `aeb83a0fe3e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/cache/r/:repoId/settings/trail-settings/patch.md)

---

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