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

# Create Trail

`POST /v1/accounts/{account_id}/trails`

## Path parameters

- `account_id` string, required

## Query parameters

- `trailId` string

## Request body

- GatewayTrail
  - `name` string
  - `displayName` string
  - `createTime` 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.

## Response `200`

A successful response.

- GatewayTrail
  - `name` string
  - `displayName` string
  - `createTime` 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.

## Changes

- **2026-01-30** `920bcfb416a7` — 1 info
  - added the optional property `langfuseConfig` to the response with the `200` status
- **2025-12-10** `b5d8d14e7fdc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/changes/v1/accounts/:account_id/trails/post.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/29a1e4db152c?raw)