---
title: "Update Trail"
method: PATCH
path: "/v1/accounts/{account_id}/trails/{trail_id}"
tags: ["gateway.openapi_Gateway"]
---

# Update Trail

`PATCH /v1/accounts/{account_id}/trails/{trail_id}`

## Request

- Base URL: `https://api.fireworks.ai`
- URL: `https://api.fireworks.ai/v1/accounts/{account_id}/trails/{trail_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/docs/v1/accounts/:account_id/trails/:trail_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` string, required
- `trail_id` string, required

## Request body

- object
  - `displayName` string
  - `createTime` string, date-time
  - `updateTime` string, date-time
  - `description` string
  - `createdBy` string
  - `langfuseConfig` string: Langfuse configuration for this trail, inherited from the account at creation time. Contains API credentials for a Project within the customer's Langfuse Organization. Serialized JSON format: {"public_key":"pk-lf-xxx","secret_key":"sk-lf-xxx","host":"https://langfuse-prod.fireworks.ai"} If empty, the default Langfuse Organization/Project will be used.
  - `defaultModel` string: Default model for requests through this trail. Format: "{provider}/{model_id}" (e.g., "anthropic/claude-3-5-sonnet-20240620"). Can be overridden per request.
  - `providerKey` string: Provider API key for this trail. When creating a trail: provide the raw API key (e.g., "sk-ant-api03-xxxx...") After creation: this field contains a secret reference (e.g., "accounts/{account_id}/secrets/trail-xxx-provider-key") The LiteLLM gateway retrieves the actual key from Secret Manager using this reference. Can be overridden by specifying api_key in the request body.

## Response `200`

A successful response.

- GatewayTrail
  - `name` string
  - `displayName` string
  - `createTime` string, date-time
  - `updateTime` string, date-time
  - `description` string
  - `createdBy` string
  - `langfuseConfig` string: Langfuse configuration for this trail, inherited from the account at creation time. Contains API credentials for a Project within the customer's Langfuse Organization. Serialized JSON format: {"public_key":"pk-lf-xxx","secret_key":"sk-lf-xxx","host":"https://langfuse-prod.fireworks.ai"} If empty, the default Langfuse Organization/Project will be used.
  - `defaultModel` string: Default model for requests through this trail. Format: "{provider}/{model_id}" (e.g., "anthropic/claude-3-5-sonnet-20240620"). Can be overridden per request.
  - `providerKey` string: Provider API key for this trail. When creating a trail: provide the raw API key (e.g., "sk-ant-api03-xxxx...") After creation: this field contains a secret reference (e.g., "accounts/{account_id}/secrets/trail-xxx-provider-key") The LiteLLM gateway retrieves the actual key from Secret Manager using this reference. Can be overridden by specifying api_key in the request body.

## Changes

- **2026-10-16** `3bf245180173`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/changes/v1/accounts/:account_id/trails/:trail_id/patch.md)

---

[API](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api.md) - [All operations](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/revisions/3bf245180173?raw)