Update the issues agent config for a session (Beta)

Error

A valid request URL is required to generate request examples

{
  "agent_overview_accepted": true,
  "analysis_level": "standard",
  "context_hub_repo_handle": "<string>",
  "created_at": "<string>",
  "cron_enabled": true,
  "cron_schedule": "<string>",
  "engine_version": "<string>",
  "github_base_branch": "<string>",
  "github_repo_subdir": "<string>",
  "github_repo_url": "<string>",
  "id": "<string>",
  "issue_count": 123,
  "latest_run_id": "<string>",
  "latest_thread_id": "<string>",
  "linear_available": true,
  "linear_integration": {
    "enabled": true,
    "project_id": "<string>",
    "project_name": "<string>",
    "team_id": "<string>",
    "team_key": "<string>",
    "team_name": "<string>",
    "workspace_id": "<string>",
    "workspace_name": "<string>"
  },
  "linear_sync_health": {
    "auth_required": 123,
    "failed": 123,
    "paused": 123,
    "pending": 123,
    "synced": 123
  },
  "preview_verify_enabled": true,
  "priorities": [
    "<string>"
  ],
  "run_filter": "<string>",
  "selected_trace_count": 123,
  "session_agent_overview_repo_id": "<string>",
  "session_id": "<string>",
  "session_lcu_spend_limit_monthly": "<string>",
  "session_name": "<string>",
  "tenant_id": "<string>",
  "tenant_name": "<string>",
  "updated_at": "<string>",
  "user_instructions": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

PATCH

api

platform

sessions

{session_id}

issues-agent

Error

A valid request URL is required to generate request examples

{
  "agent_overview_accepted": true,
  "analysis_level": "standard",
  "context_hub_repo_handle": "<string>",
  "created_at": "<string>",
  "cron_enabled": true,
  "cron_schedule": "<string>",
  "engine_version": "<string>",
  "github_base_branch": "<string>",
  "github_repo_subdir": "<string>",
  "github_repo_url": "<string>",
  "id": "<string>",
  "issue_count": 123,
  "latest_run_id": "<string>",
  "latest_thread_id": "<string>",
  "linear_available": true,
  "linear_integration": {
    "enabled": true,
    "project_id": "<string>",
    "project_name": "<string>",
    "team_id": "<string>",
    "team_key": "<string>",
    "team_name": "<string>",
    "workspace_id": "<string>",
    "workspace_name": "<string>"
  },
  "linear_sync_health": {
    "auth_required": 123,
    "failed": 123,
    "paused": 123,
    "pending": 123,
    "synced": 123
  },
  "preview_verify_enabled": true,
  "priorities": [
    "<string>"
  ],
  "run_filter": "<string>",
  "selected_trace_count": 123,
  "session_agent_overview_repo_id": "<string>",
  "session_id": "<string>",
  "session_lcu_spend_limit_monthly": "<string>",
  "session_name": "<string>",
  "tenant_id": "<string>",
  "tenant_name": "<string>",
  "updated_at": "<string>",
  "user_instructions": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Authorizations

X-API-Key

string

header

required

Path Parameters

session_id

string

required

Tracer session ID (UUID)

Body

application/json

agent_overview_accepted

boolean

analysis_level

enum<string>

AnalysisLevel: "standard", "reduced", or "expanded". Switching to or from "reduced" also resets the scan cadence. nil = don't change.

Available options:

standard,

reduced,

expanded

context_hub_repo_handle

string

cron_enabled

boolean

github_base_branch

string

github_repo_subdir

string

github_repo_url

string

linear_integration

object

Show child attributes

preview_verify_enabled

boolean

priorities

string[]

run_filter

string

Trace-scope DSL. nil = don't change; "" clears it.

session_agent_overview_repo_id

string

session_lcu_spend_limit_monthly

string

SessionLCUSpendLimitMonthly sets the per-project monthly LCU spend limit. Tri-state: absent (nil) = don't change; 0 or positive = monthly cap (a cap of 0 is always reached, blocking new runs); negative clears it (stored as NULL = no limit). The frontend sends a negative number to clear rather than null, since null is indistinguishable from "absent". Serialized as a string to preserve NUMERIC precision.

user_instructions

string

Freeform user preferences. Send "" to clear (the frontend must not send null).

Response

agent_overview_accepted

boolean

analysis_level

enum<string>

AnalysisLevel controls coverage vs cost: "standard" (default), "reduced" (one scan a day, fewer traces per scan), or "expanded" (2x traces per run). Stored NULL in the DB means standard; reads always return a concrete value.

Available options:

standard,

reduced,

expanded

context_hub_repo_handle

string

created_at

string

cron_enabled

boolean

cron_schedule

string

engine_version

string

github_base_branch

string

github_repo_subdir

string

github_repo_url

string

issue_count

integer

latest_run_id

string

latest_thread_id

string

IDs of the latest run on LangSmith Deployments; NULL until first trigger.

linear_available

boolean

linear_integration

object

Show child attributes

linear_sync_health

object

Show child attributes

preview_verify_enabled

boolean

PreviewVerifyEnabled lets this board's fix runs use preview deployments when issue validation is enabled for its tracing project.

priorities

string[]

run_filter

string

RunFilter is a runs-filter-DSL string scoping which traces Engine analyzes (prompt guidance, not an enforced query). NULL = no scope. Clamped by validateRunFilter.

selected_trace_count

integer

SelectedTraceCount is the number of traces Engine inspected in the last 14 days.

session_agent_overview_repo_id

string

session_id

string

session_lcu_spend_limit_monthly

string

SessionLCUSpendLimitMonthly is the per-project monthly Engine LCU spend limit: NULL/negative = no limit; 0 or positive = monthly cap (spend is never negative, so a cap of 0 always reads as reached). Enforced in addition to (and independently of) the org-level limit. Serialized as a string to preserve NUMERIC(28,6) precision.

session_name

string

JOINed from tracer_session

tenant_id

string

tenant_name

string

JOINed from tenants (workspace label); resolved server-side so the org-admin list can label rows across workspaces the caller isn't a member of

updated_at

string

user_instructions

string

User-owned freeform preferences. Engine reads this as authoritative context and reconciles it into the Agent Overview on the next scan, but never edits it. NULL when the user hasn't set any.

SmithDB SDK migration

LangSmith REST API

Update the issues agent config for a session (Beta)

Authorizations

Path Parameters

Body

Response