Create the issues agent 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>"
}

POST

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

analysis_level

enum<string>

AnalysisLevel is how thoroughly Engine monitors the project: "standard" (the default), "reduced" (fewer traces at lower cost), or "expanded" (more traces per run, for projects with enough tracing volume). Omit for "standard".

Available options:

standard,

reduced,

expanded

context_hub_repo_handle

string

github_base_branch

string

github_repo_subdir

string

github_repo_url

string

priorities

string[]

run_filter

string

Runs-filter-DSL trace scope; omit/null/empty for no scope.

Response

Created

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

Create the issues agent for a session (Beta)

Authorizations

Path Parameters

Body

Response