Trails

Update trail metadata

patch/api/v1/trails/{forge}/{owner}/{repo}/{number}

Path parameters

forgestring required

ownerstring required

repostring required

numberstring required

Request body

branchstring

Git branch name

basestring

Base branch

titlestring

Trail title

bodystring

Trail body Markdown

status'draft' | 'open' | 'merged' | 'closed'

Trail lifecycle status.

ready_for_reviewboolean

Explicit review readiness. Only open Trails may set true; false clears readiness.

assigneesstring[]

GitHub usernames to set as trail assignees

type'bug' | 'feature' | 'task'

Trail type

priority'urgent' | 'high' | 'medium' | 'low' | 'none'

Priority level

Response

Updated trail

Changes

Changed in 6 of the 29 revisions of this API.5629

Sep 25, 202614c8416feab71116See the full diff
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
Sep 24, 2026ba1409f8f36b23See the full diff
- ●
  added the new base_checks enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new base_checks enum value to the ///// response property for the response status
  response-property-enum-value-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
Sep 24, 20260eb4157af08b323See the full diff
- ▲
  the /// response's property type changed from array to object for status
  response-property-type-changed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ●
  removed the request property
  request-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
Sep 21, 202603a8a4babd7d1See the full diff
- ○
  added the required property /// to the response with the status
  response-required-property-added
Sep 17, 2026e1f0e2f14d0a115See the full diff
- ▲
  the / response's property type changed from array to object for status
  response-property-type-changed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Sep 16, 2026f15a377013f61See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added

Full history