Update issue

Edit fields, refresh evidence, comment on, or change the review status of one issue.

PATCH/v1/projects/{projectId}/issues/{issueId}

Authorization

AuthorizationPersonal API key · headerrequired

Your personal API key from Settings > Personal API Keys, sent as Bearer <key>.

X-Organization-IdOrganization ID · headerrequired

The organization to act in. Copy it with Copy organization ID in the organization menu or the settings sidebar.

Path parameters

projectIdstringrequired

issueIdstring<uuid>required

matches ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Request body

requiredapplication/json

titlestring

Short issue title.

min length 1

diagnosisstring

1–2 short sentences describing the observed failure, with inline trace and relevant signal citations. Omit fixes and investigation history.

min length 1

impact_summarystring | null

2–3 Markdown bullets on impact, scope, frequency, trends, and material uncertainty. Quantify how often contributing labels were applied, and any other judge signals, with inline citations. Combine related facts; omit immaterial unknowns and labeled checklists.

prioritystring

Allowed:lowmediumhighcritical

production_activitystring

Allowed:newongoingincreasingrecurring

agent_reasoningstring | null

1–3 Markdown bullets suggesting evidence-backed remediation. Omit repeated evidence and claims of an exact cause or fix.

cited_itemsobject[]

Cite every supporting trace with a one-sentence failure description in its label field and an optional short quote. Add a span or trace-behavior citation for each contributing location, using the same trace_id and real span_id when available; use trace-only evidence only when no deeper location is reliable. For contributing label or judge signals, include their citation with the stable name in its label field and matching trace-behavior verdicts with tool-returned behavior_id/judge_id and value. Cite the label itself with type "behavior" (behavior_id) and its verdict on a trace with type "trace-behavior". Put changing metrics and confidence in impact_summary.

min items 1

Show properties

Array of object

typestringrequired

user_statusstring

Allowed:needs_reviewignoredmergedmonitored

judge_idstring

Monitoring Judge ID; required for monitored status.

behavior_idstring

ID of the label the production judge applies; required for monitored status. The field name remains behavior_id.

messagestring

Timeline comment, alone or with other changes.

min length 1

Responses

200

Response for status 200

issueobjectrequired

Show properties

idstringrequired

organization_idstringrequired

project_idstringrequired

issue_keystringrequired

titlestringrequired

diagnosisstringrequired

impact_summarystring | nullrequired

prioritystringrequired

Allowed:lowmediumhighcritical

user_statusstringrequired

Allowed:needs_reviewignoredresolvedmergedmonitored

production_activitystringrequired

Allowed:newongoingincreasingrecurring

first_seen_atstring | nullrequired

last_seen_atstring | nullrequired

evidence_countnumberrequired

Distinct stored traces the Issue cites. Citations that point to the same trace count once.

agent_reasoningstring | nullrequired

monitoring_judge_idstring | nullrequired

monitoring_behavior_idstring | nullrequired

created_atstringrequired

updated_atstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Personal API keyOrganization IDRemember on this deviceInclude my values in samples

Parameters

projectIdpath*issueIdpath*

Bodyapplication/json

Request body

Request

curl -X PATCH 'https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/issues/YOUR_ISSUE_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'X-Organization-Id: YOUR_ORGANIZATION_ID' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "string",
  "diagnosis": "string",
  "impact_summary": "string",
  "priority": "low",
  "production_activity": "new",
  "agent_reasoning": "string",
  "cited_items": [
    {
      "type": "string",
      "property1": null,
      "property2": null
    }
  ],
  "user_status": "needs_review",
  "judge_id": "string",
  "behavior_id": "string",
  "message": "string"
}'

const response = await fetch("https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/issues/YOUR_ISSUE_ID", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "X-Organization-Id": "YOUR_ORGANIZATION_ID",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"title\": \"string\",\n  \"diagnosis\": \"string\",\n  \"impact_summary\": \"string\",\n  \"priority\": \"low\",\n  \"production_activity\": \"new\",\n  \"agent_reasoning\": \"string\",\n  \"cited_items\": [\n    {\n      \"type\": \"string\",\n      \"property1\": null,\n      \"property2\": null\n    }\n  ],\n  \"user_status\": \"needs_review\",\n  \"judge_id\": \"string\",\n  \"behavior_id\": \"string\",\n  \"message\": \"string\"\n}"
});

import requests

response = requests.patch(
    "https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/issues/YOUR_ISSUE_ID",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Organization-Id": "YOUR_ORGANIZATION_ID",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"title\": \"string\",\n  \"diagnosis\": \"string\",\n  \"impact_summary\": \"string\",\n  \"priority\": \"low\",\n  \"production_activity\": \"new\",\n  \"agent_reasoning\": \"string\",\n  \"cited_items\": [\n    {\n      \"type\": \"string\",\n      \"property1\": null,\n      \"property2\": null\n    }\n  ],\n  \"user_status\": \"needs_review\",\n  \"judge_id\": \"string\",\n  \"behavior_id\": \"string\",\n  \"message\": \"string\"\n}",
)

Response

{
  "issue": {
    "id": "string",
    "organization_id": "string",
    "project_id": "string",
    "issue_key": "string",
    "title": "string",
    "diagnosis": "string",
    "impact_summary": "string",
    "priority": "low",
    "user_status": "needs_review",
    "production_activity": "new",
    "first_seen_at": "string",
    "last_seen_at": "string",
    "evidence_count": 0,
    "agent_reasoning": "string",
    "monitoring_judge_id": "string",
    "monitoring_behavior_id": "string",
    "created_at": "string",
    "updated_at": "string"
  }
}