Create issue

Create one evidence-backed issue. A duplicate issue_key returns a conflict.

POST/v1/projects/{projectId}/issues

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

Request body

requiredapplication/json

issue_keystring

Stable root-cause key: lowercase letters, digits, hyphens, and colons.

titlestringrequired

Short issue title.

min length 1

diagnosisstringrequired

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[]required

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

Responses

200

Response for status 200

issueobjectrequired

Show properties

idstringrequired

issue_keystringrequired

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*

Bodyapplication/json

Request body

Request

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

const response = await fetch("https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/issues", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "X-Organization-Id": "YOUR_ORGANIZATION_ID",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"issue_key\": \"string\",\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}"
});

import requests

response = requests.post(
    "https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/issues",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Organization-Id": "YOUR_ORGANIZATION_ID",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"issue_key\": \"string\",\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}",
)

Response

{
  "issue": {
    "id": "string",
    "issue_key": "string"
  }
}