issues-agent

[Beta] Update the issues agent config for a session

Changed on

Beta: This endpoint is in active development and may change without notice.

Patches the agent config. All side effects (clearing fix fields when the GitHub repo changes, setting agent_overview_repo_id) happen in a single CRUD transaction. Omitted fields are left unchanged.

patch/api/v1/platform/sessions/{session_id}/issues-agent

Request

  • Base URL
    https://api.smith.langchain.com
  • URL
    https://api.smith.langchain.com/api/v1/platform/sessions/{session_id}/issues-agent
  • Auth
    • API key in header X-API-Key
    • or API key in header X-Tenant-Id
    • or HTTP bearer

Path parameters

session_idstring required

Tracer session ID (UUID)

Request body

agent_overview_acceptedboolean
analysis_level'standard' | 'reduced' | 'expanded'

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

auto_open_fix_prboolean
context_hub_repo_handlestring
cron_enabledboolean
github_base_branchstring

Legacy: ignored without github_repo_url.

github_repo_subdirstring

Legacy: ignored without github_repo_url.

github_repo_urlstring

Legacy: use the github-repos endpoints. Absent leaves repos alone, "" unlinks all, otherwise replaces the list with the one repo named.

preview_verify_enabledboolean
preview_verify_no_triggerboolean
prioritiesstring[]
run_filterstring

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

session_agent_overview_repo_idstring
session_lcu_spend_limit_monthlystring

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_instructionsstring

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

validation_deployment_idstring

ValidationDeploymentID is a deployment UUID or LangSmith deployment URL, or an empty string to disable validation.

Response

OK

agent_overview_acceptedboolean
analysis_level'standard' | 'reduced' | 'expanded'

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.

auto_open_fix_prboolean

When true, every fix run on this board opens a pull request instead of parking the fix for someone to publish. Defaults to false.

context_hub_repo_handlestring
created_atstring
cron_enabledboolean
cron_schedulestring
engine_versionstring
github_base_branchstring

Legacy: aliases the oldest GitHub entry in GithubRepos.

github_repo_subdirstring

Legacy: aliases the oldest GitHub entry in GithubRepos.

github_repo_urlstring

Legacy: aliases the oldest GitHub entry in GithubRepos.

idstring
issue_countinteger
latest_run_idstring
latest_thread_idstring

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

linear_availableboolean
preview_verify_enabledboolean

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

preview_verify_no_triggerboolean

PreviewVerifyNoTrigger tells fix verification not to request a preview. The deployment builds one itself for the fix commit.

prioritiesstring[]
run_filterstring

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_countinteger

Compatibility alias for selected_trace_count_last_14_days. Deprecated: use selected_trace_count_last_14_days.

selected_trace_count_last_14_daysinteger

The number of traces Engine inspected in the last 14 days.

selected_trace_count_last_7_daysinteger

The number of traces Engine inspected in the last 7 days.

session_agent_overview_repo_idstring
session_idstring
session_lcu_spend_limit_monthlystring

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_namestring

JOINed from tracer_session

tenant_idstring
tenant_namestring

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_atstring
user_instructionsstring

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.

validation_deployment_idstring

ValidationDeploymentID selects the deployment used for baseline replay and as the parent of fix-verification previews.

Changes

  • e9b5f2bcae6fRevision changes
    • info

      added the optional property // to the response with the status

  • 3c96302af436Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status