gateway.openapi_Gateway

Create Trail

post/v1/accounts/{account_id}/trails

Request

  • Base URL: https://api.fireworks.ai
  • URL: https://api.fireworks.ai/v1/accounts/{account_id}/trails
  • Auth: HTTP bearer

Path parameters

account_idstring required

The Account Id

Query parameters

trailIdstring

Optional ID for the trail. If not specified, a random UUID will be generated.

Request body

namestring
displayNamestring
createTimestring date-time
updateTimestring date-time
descriptionstring
createdBystring
langfuseConfigstring

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.

defaultModelstring

Default model for requests through this trail. Format: "{provider}/{model_id}" (e.g., "anthropic/claude-3-5-sonnet-20240620"). Can be overridden per request.

providerKeystring

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

A successful response.

namestring
displayNamestring
createTimestring date-time
updateTimestring date-time
descriptionstring
createdBystring
langfuseConfigstring

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.

defaultModelstring

Default model for requests through this trail. Format: "{provider}/{model_id}" (e.g., "anthropic/claude-3-5-sonnet-20240620"). Can be overridden per request.

providerKeystring

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

No recorded changes to this operation across all 1 revision of this API.