# Create destination

Source: <https://everruns.com/docs/api/operations/create_destination/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Operations & billing](https://everruns.com/docs/api/groups/operations-billing/)/Create destination

# Create destination

Preview

Operate durable execution, schedules, sandbox infrastructure, budgets, payments and audit logs.

Public APIEverruns Cloud and self-hosted Platform

POST`/v1/tracing/destinations`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Request Bodyrequired

Media typeapplication/json

Create or update a receiver; omitted authentication preserves existing credentials.

object

**config**

required

Non-secret destination settings, including capture consent and pause state.

object

**capture_content**

Explicit consent to export message and tool content; defaults to metadata only.

boolean

### Example

```json
false
```

**capture_reasoning**

Explicit consent to export reasoning; also requires content capture.

boolean

### Example

```json
false
```

**enabled**

Whether customer exports may be sent to this receiver; false pauses delivery.

boolean

### Example

```json
true
```

**endpoint**

required

HTTPS receiver endpoint without embedded credentials, query parameters, or fragments.

string

### Example

```plaintext
https://collector.example.com/v1/traces
```

**langsmith_agent_environment**

LangSmith agent environment: local, development, staging, or production.

string | null

**langsmith_agent_id**

Registered LangSmith agent identifier, mutually exclusive with project_name.

string | null

**name**

required

Human-readable destination name, from 1 to 128 characters.

string

### Example

```plaintext
Production traces
```

**project_id**

Braintrust project identifier; required for Braintrust receivers.

string | null format: uuid

### Example

```plaintext
00000000-0000-0000-0000-000000000002
```

**project_name**

LangSmith project name for project-based workspaces.

string | null

**provider**

required

Native Braintrust, Langfuse, LangSmith, or generic OTLP over HTTPS.

string

Allowed values: braintrust langfuse langsmith otlp

**revision**

Expected current revision for updates; omit when creating a destination.

integer | null format: int64

### Example

```json
1
```

**secrets**

One of:

* object

  Receiver authentication. Required for creation or a receiver change; never returned.

  object

  **headers**

  Authentication headers: Authorization, X-API-Key, or Api-Key. Values are write-only.

  object

  **_key_**

  additional properties

  string

* null

  null

## Responses

201

### 201

Media typeapplication/json

Destination settings, safe delivery health, and routing usage; excludes credentials.

object

**agent_selections**

required

Number of agent policies that explicitly select this destination.

integer format: int64

**config**

required

Non-secret destination settings, including capture consent and pause state.

object

**capture_content**

Explicit consent to export message and tool content; defaults to metadata only.

boolean

**capture_reasoning**

Explicit consent to export reasoning; also requires content capture.

boolean

**enabled**

Whether customer exports may be sent to this receiver; false pauses delivery.

boolean

**endpoint**

required

HTTPS receiver endpoint without embedded credentials, query parameters, or fragments.

string

**langsmith_agent_environment**

LangSmith agent environment: local, development, staging, or production.

string | null

**langsmith_agent_id**

Registered LangSmith agent identifier, mutually exclusive with project_name.

string | null

**name**

required

Human-readable destination name, from 1 to 128 characters.

string

**project_id**

Braintrust project identifier; required for Braintrust receivers.

string | null format: uuid

**project_name**

LangSmith project name for project-based workspaces.

string | null

**provider**

required

Native Braintrust, Langfuse, LangSmith, or generic OTLP over HTTPS.

string

Allowed values: braintrust langfuse langsmith otlp

**dropped_events**

required

Number of events omitted by bounded customer export delivery.

integer format: int64

**id**

required

Destination identifier owned by the current organization.

string format: uuid

**last_accepted_at**

Time the receiver last accepted an export, or null before any acceptance.

string | null format: date-time

**last_attempt_at**

Time of the latest delivery attempt, or null before the first attempt.

string | null format: date-time

**last_error**

Sanitized delivery failure; never includes receiver credentials or response bodies.

string | null

**organization_default**

required

Whether this destination is selected in organization defaults.

boolean

**revision**

required

Current revision used to reject stale saves and deletes.

integer format: int64

### Example

```json
{
  "agent_selections": 0,
  "config": {
    "capture_content": false,
    "capture_reasoning": false,
    "enabled": true,
    "endpoint": "https://collector.example.com/v1/traces",
    "name": "Production traces",
    "project_id": "00000000-0000-0000-0000-000000000002",
    "provider": "braintrust"
  },
  "dropped_events": 0,
  "id": "00000000-0000-0000-0000-000000000001",
  "last_accepted_at": "2026-10-28T00:00:00Z",
  "last_attempt_at": "2026-10-28T00:00:00Z",
  "last_error": "Receiver unavailable",
  "organization_default": false,
  "revision": 1
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/tracing/destinations';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"config":{"capture_content":false,"capture_reasoning":false,"enabled":true,"endpoint":"https://collector.example.com/v1/traces","langsmith_agent_environment":"example","langsmith_agent_id":"example","name":"Production traces","project_id":"00000000-0000-0000-0000-000000000002","project_name":"example","provider":"braintrust"},"revision":1,"secrets":{"headers":{"additionalProperty":"example"}}}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/tracing/destinations \
  --header 'Content-Type: application/json' \
  --data '{ "config": { "capture_content": false, "capture_reasoning": false, "enabled": true, "endpoint": "https://collector.example.com/v1/traces", "langsmith_agent_environment": "example", "langsmith_agent_id": "example", "name": "Production traces", "project_id": "00000000-0000-0000-0000-000000000002", "project_name": "example", "provider": "braintrust" }, "revision": 1, "secrets": { "headers": { "additionalProperty": "example" } } }'
```

Additional language examples require JavaScript. The default request example is available above.

201

201 ·

```json
{
  "agent_selections": 0,
  "config": {
    "capture_content": false,
    "capture_reasoning": false,
    "enabled": true,
    "endpoint": "https://collector.example.com/v1/traces",
    "name": "Production traces",
    "project_id": "00000000-0000-0000-0000-000000000002",
    "provider": "braintrust"
  },
  "dropped_events": 0,
  "id": "00000000-0000-0000-0000-000000000001",
  "last_accepted_at": "2026-10-28T00:00:00Z",
  "last_attempt_at": "2026-10-28T00:00:00Z",
  "last_error": "Receiver unavailable",
  "organization_default": false,
  "revision": 1
}
```

## Matching endpoints