# Recommended trace wait for a scenario judge

How long a scenario judge should wait for this project's traces before a verdict: the first wait, the one extension it may ask for, and how long the span set must hold still. Measured on the project's own ingest; defaults without history.

> Page: https://langwatch.ai/docs/api-reference/traces/recommended-trace-wait-for-a-scenario-judge
> Source: https://github.com/langwatch/langwatch/blob/main/docs/api-reference/traces/recommended-trace-wait-for-a-scenario-judge.mdx
> Index of all pages: https://langwatch.ai/docs/llms.txt

## Endpoint

`GET https://app.langwatch.ai/api/v1/traces/settle-settings`

## Authentication

### project_api_key

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

```json
{"id":"project_api_key","type":"apiKey","in":"header","name":"X-Auth-Token"}
```

## Request example

```bash
curl --request GET \
  --url 'https://app.langwatch.ai/api/v1/traces/settle-settings' \
  --header "X-Auth-Token: $LANGWATCH_API_KEY"
```

## Responses

### 200

The recommended wait, extension and quiet period, in milliseconds

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "waitTimeoutMs": {"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},
    "waitExtensionMs": {"type":"integer","minimum":0,"maximum":9007199254740991},
    "quietPeriodMs": {"type":"integer","minimum":0,"maximum":9007199254740991}
  },
  "required": ["waitTimeoutMs","waitExtensionMs","quietPeriodMs"],
  "additionalProperties": false
}
```

### 400

Bad Request

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {"error":{"type":"string"},"message":{"type":"string"}},
  "required": ["error"],
  "additionalProperties": false
}
```

### 401

Unauthorized

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {"error":{"type":"string"},"message":{"type":"string"}},
  "required": ["error"],
  "additionalProperties": false
}
```

### 422

Unprocessable Entity

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {"error":{"type":"string"},"message":{"type":"string"}},
  "required": ["error"],
  "additionalProperties": false
}
```

### 500

Internal Server Error

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {"error":{"type":"string"},"message":{"type":"string"}},
  "required": ["error"],
  "additionalProperties": false
}
```

> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.
