Registry↗Dashboard↗

Issues

Issue tracking and management

15 endpoints

Create a user-submitted issue

Requires authentication
projectrequiredstring
titlerequiredstring
priorityrequiredstring
criticalhighsuggestedbacklog
severitystring
criticalhighmediumlowinfo
categorystring
descriptionstring
filePathstring
lineNumberinteger
failureCodestring
Pattern: ^(STR|SEM|PRA|EPI)-[A-Z]{3}/[CHMLI]$
failureDomainstring

- STR: Structural failures - SEM: Semantic failures - PRA: Pragmatic failures - EPI: Epistemic failures

STRSEMPRAEPI
failureModestring
agentstring
typestring

Issue type. Universal types: feature, bug, refactor, config, docs, infra, security, test, observation, deficiency, ambiguity. Domain-specific types (e.g., "omission", "interpretation" for legal) are also accepted and resolved by the API.

201Issue created
400Validation failed
401Missing or invalid authentication
403INSUFFICIENT_ORG_ROLE — org role below `publisher` (writes into an org require publisher or higher; personal-org owners always pass) or ORG_ACCESS_DENIED — not a member of the org named by X-Org-Slug / X-Org-Id. On INSUFFICIENT_ORG_ROLE the body is rewritten: `details.orgSlug`, `details.applied: false`, and a message that forbids retrying without `org`.

Response fields

dataobject
POST/api/v1/issues
curl -X POST "https://api.uluops.ai/api/v1/issues" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "my-project",
    "title": "Missing error handler in auth middleware",
    "priority": "critical"
  }'
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "fingerprint": "...",
    "semanticFingerprint": "...",
    "title": "...",
    "status": "open",
    "priority": "critical",
    "severity": "critical",
    "failureCode": "...",
    "failureDomain": "STR",
    "failureMode": "...",
    "failureSeverityCode": "C",
    "category": "...",
    "agent": "...",
    "type": "...",
    "filePath": "...",
    "lineNumber": 0,
    "timesSeen": 0,
    "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "resolvedAt": "2026-01-15T10:30:00Z",
    "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Search issues across projects

Requires authentication
querystringquery

Search text (optional — returns all issues if omitted)

projectsarrayquery
agentsarrayquery
statusstringquery
opencompleteddeferredwontfixmergedfalse-positiveall
Default: all
prioritystringquery
criticalhighsuggestedbacklogall
Default: all
severitiesarrayquery
failure_domainsarrayquery
limitintegerquery

Maximum number of results

Default: 50
200Search results
401Missing or invalid authentication

Response fields

dataIssue[]
countinteger
GET/api/v1/issues/search
curl -X GET "https://api.uluops.ai/api/v1/issues/search" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "projectId": "550e8400-e29b-41d4-a716-446655440000",
      "fingerprint": "...",
      "semanticFingerprint": "...",
      "title": "...",
      "status": "open",
      "priority": "critical",
      "severity": "critical",
      "failureCode": "...",
      "failureDomain": "STR",
      "failureMode": "...",
      "failureSeverityCode": "C",
      "category": "...",
      "agent": "...",
      "type": "...",
      "filePath": "...",
      "lineNumber": 0,
      "timesSeen": 0,
      "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
      "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
      "resolvedAt": "2026-01-15T10:30:00Z",
      "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
      "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
      "authorId": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T10:30:00Z"
    }
  ],
  "count": 0
}

Get issue by fingerprint

Requires authentication
fingerprintrequiredstringpath

Issue fingerprint (SHA-256 hash, 16-64 chars)

projectrequiredstringquery
200Issue details
401Missing or invalid authentication
404Resource not found

Response fields

dataobject
GET/api/v1/issues/by-fingerprint/{fingerprint}
curl -X GET "https://api.uluops.ai/api/v1/issues/by-fingerprint/a1b2c3d4e5f6g7h8?project=my-project" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "fingerprint": "...",
    "semanticFingerprint": "...",
    "title": "...",
    "status": "open",
    "priority": "critical",
    "severity": "critical",
    "failureCode": "...",
    "failureDomain": "STR",
    "failureMode": "...",
    "failureSeverityCode": "C",
    "category": "...",
    "agent": "...",
    "type": "...",
    "filePath": "...",
    "lineNumber": 0,
    "timesSeen": 0,
    "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "resolvedAt": "2026-01-15T10:30:00Z",
    "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Update issue status by fingerprint

Requires authentication
fingerprintrequiredstringpath

Issue fingerprint (SHA-256 hash, 16-64 chars)

projectrequiredstringquery
statusrequiredstring
opencompleteddeferredwontfixmergedfalse-positiveobservation
reasonstring
200Status updated
401Missing or invalid authentication
403INSUFFICIENT_ORG_ROLE — org role below `publisher` (writes into an org require publisher or higher; personal-org owners always pass) or ORG_ACCESS_DENIED — not a member of the org named by X-Org-Slug / X-Org-Id. On INSUFFICIENT_ORG_ROLE the body is rewritten: `details.orgSlug`, `details.applied: false`, and a message that forbids retrying without `org`.
404Resource not found

Response fields

dataobject
PATCH/api/v1/issues/by-fingerprint/{fingerprint}/status
curl -X PATCH "https://api.uluops.ai/api/v1/issues/by-fingerprint/a1b2c3d4e5f6g7h8/status?project=my-project" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "open"
  }'
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "fingerprint": "...",
    "previousStatus": "...",
    "newStatus": "...",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Bulk update issue statuses

Requires authentication
projectrequiredstring
updatesrequiredobject[]
200Statuses updated
401Missing or invalid authentication
403INSUFFICIENT_ORG_ROLE — org role below `publisher` (writes into an org require publisher or higher; personal-org owners always pass) or ORG_ACCESS_DENIED — not a member of the org named by X-Org-Slug / X-Org-Id. On INSUFFICIENT_ORG_ROLE the body is rewritten: `details.orgSlug`, `details.applied: false`, and a message that forbids retrying without `org`.

Response fields

dataobject
POST/api/v1/issues/bulk-status
curl -X POST "https://api.uluops.ai/api/v1/issues/bulk-status" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "my-project",
    "updates": [
      {
        "status": "open"
      }
    ]
  }'
Response
{
  "data": {
    "updated": 0,
    "failed": 0
  }
}

List issues by project

Requires authentication
projectIdrequiredstringpath
statusstringquery
opencompleteddeferredwontfixmergedfalse-positiveall
Default: open
prioritystringquery
criticalhighsuggestedbacklog
severitystringquery
criticalhighmediumlowinfo
failure_domainstringquery
STRSEMPRAEPI
agentstringquery

Filter by agent name

include_resolvedbooleanquery
limitintegerquery

Maximum number of results

Default: 50
offsetintegerquery

Number of results to skip

Default: 0
200List of issues
401Missing or invalid authentication

Response fields

dataIssue[]
countinteger
GET/api/v1/issues/project/{projectId}
curl -X GET "https://api.uluops.ai/api/v1/issues/project/my-project" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "projectId": "550e8400-e29b-41d4-a716-446655440000",
      "fingerprint": "...",
      "semanticFingerprint": "...",
      "title": "...",
      "status": "open",
      "priority": "critical",
      "severity": "critical",
      "failureCode": "...",
      "failureDomain": "STR",
      "failureMode": "...",
      "failureSeverityCode": "C",
      "category": "...",
      "agent": "...",
      "type": "...",
      "filePath": "...",
      "lineNumber": 0,
      "timesSeen": 0,
      "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
      "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
      "resolvedAt": "2026-01-15T10:30:00Z",
      "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
      "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
      "authorId": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T10:30:00Z"
    }
  ],
  "count": 0
}

Get an issue

Requires authentication
idrequiredstringuuidpath

Issue UUID

200Issue details
401Missing or invalid authentication
404Resource not found

Response fields

dataobject
GET/api/v1/issues/{id}
curl -X GET "https://api.uluops.ai/api/v1/issues/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "fingerprint": "...",
    "semanticFingerprint": "...",
    "title": "...",
    "status": "open",
    "priority": "critical",
    "severity": "critical",
    "failureCode": "...",
    "failureDomain": "STR",
    "failureMode": "...",
    "failureSeverityCode": "C",
    "category": "...",
    "agent": "...",
    "type": "...",
    "filePath": "...",
    "lineNumber": 0,
    "timesSeen": 0,
    "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "resolvedAt": "2026-01-15T10:30:00Z",
    "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Edit issue fields

Requires authentication
idrequiredstringuuidpath

Issue UUID

titlestring
filePathstring
categorystring
severitystring
criticalhighmediumlowinfo
failureCodestring
Pattern: ^(STR|SEM|PRA|EPI)-[A-Z]{3}/[CHMLI]$
lineNumberinteger
200Issue updated
401Missing or invalid authentication
403INSUFFICIENT_ORG_ROLE — org role below `publisher` (writes into an org require publisher or higher; personal-org owners always pass) or ORG_ACCESS_DENIED — not a member of the org named by X-Org-Slug / X-Org-Id. On INSUFFICIENT_ORG_ROLE the body is rewritten: `details.orgSlug`, `details.applied: false`, and a message that forbids retrying without `org`.
404Resource not found

Response fields

dataobject
PATCH/api/v1/issues/{id}
curl -X PATCH "https://api.uluops.ai/api/v1/issues/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "fingerprint": "...",
    "semanticFingerprint": "...",
    "title": "...",
    "status": "open",
    "priority": "critical",
    "severity": "critical",
    "failureCode": "...",
    "failureDomain": "STR",
    "failureMode": "...",
    "failureSeverityCode": "C",
    "category": "...",
    "agent": "...",
    "type": "...",
    "filePath": "...",
    "lineNumber": 0,
    "timesSeen": 0,
    "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "resolvedAt": "2026-01-15T10:30:00Z",
    "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Get full issue details with notes

Requires authentication
idrequiredstringuuidpath

Issue UUID

include_occurrencesbooleanquery
Default: true
include_relatedbooleanquery
Default: false
200Full issue details
401Missing or invalid authentication
404Resource not found

Response fields

dataobject
GET/api/v1/issues/{id}/details
curl -X GET "https://api.uluops.ai/api/v1/issues/550e8400-e29b-41d4-a716-446655440000/details" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "issue": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "fingerprint": "...",
    "semanticFingerprint": "...",
    "title": "...",
    "status": "open",
    "priority": "critical",
    "severity": "critical",
    "failureCode": "...",
    "failureDomain": "STR",
    "failureMode": "...",
    "failureSeverityCode": "C",
    "category": "...",
    "agent": "...",
    "type": "...",
    "filePath": "...",
    "lineNumber": 0,
    "timesSeen": 0,
    "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "resolvedAt": "2026-01-15T10:30:00Z",
    "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  },
    "notes": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "issueId": "550e8400-e29b-41d4-a716-446655440000",
      "content": "...",
      "noteType": "context",
      "createdBy": "...",
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ],
    "occurrences": [],
    "related": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "projectId": "550e8400-e29b-41d4-a716-446655440000",
      "fingerprint": "...",
      "semanticFingerprint": "...",
      "title": "...",
      "status": "open",
      "priority": "critical",
      "severity": "critical",
      "failureCode": "...",
      "failureDomain": "STR",
      "failureMode": "...",
      "failureSeverityCode": "C",
      "category": "...",
      "agent": "...",
      "type": "...",
      "filePath": "...",
      "lineNumber": 0,
      "timesSeen": 0,
      "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
      "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
      "resolvedAt": "2026-01-15T10:30:00Z",
      "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
      "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
      "authorId": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T10:30:00Z"
    }
  ]
  }
}

Get unified issue audit history (occurrences, status changes, notes)

Returns a merged audit history for an issue as a single timestamp- sorted event stream covering three sources: per-run occurrences, deliberate status transitions (and undo tombstones), and notes. Events are sorted by timestamp descending and capped at 1000 events post-merge. **BREAKING CHANGE** (live-tests T2 §3.1, F10): prior versions returned `{ issue, history: StatusHistory[] }` covering only status transitions, and the undo endpoint destroyed the row it reverted. The new envelope merges all three event sources and preserves the original row on undo via a tombstone with `transitionType: 'undo'` and `revertedChangeId` pointing at the change it reverts. Pre-migration rows (before migration 055) have `transitionType: null` and are semantically equivalent to `'change'`.

Requires authentication
idrequiredstringuuidpath

Issue UUID

200Merged history envelope
401Missing or invalid authentication
404Resource not found

Response fields

datarequiredobject
GET/api/v1/issues/{id}/history
curl -X GET "https://api.uluops.ai/api/v1/issues/550e8400-e29b-41d4-a716-446655440000/history" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "issueId": "550e8400-e29b-41d4-a716-446655440000",
    "events": [],
    "totalEvents": 0,
    "truncated": true
  }
}

Update issue status

Requires authentication
idrequiredstringuuidpath

Issue UUID

statusrequiredstring
opencompleteddeferredwontfixmergedfalse-positiveobservation
reasonstring
200Status updated
401Missing or invalid authentication
403INSUFFICIENT_ORG_ROLE — org role below `publisher` (writes into an org require publisher or higher; personal-org owners always pass) or ORG_ACCESS_DENIED — not a member of the org named by X-Org-Slug / X-Org-Id. On INSUFFICIENT_ORG_ROLE the body is rewritten: `details.orgSlug`, `details.applied: false`, and a message that forbids retrying without `org`.
404Resource not found

Response fields

dataobject
PATCH/api/v1/issues/{id}/status
curl -X PATCH "https://api.uluops.ai/api/v1/issues/550e8400-e29b-41d4-a716-446655440000/status" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "open"
  }'
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "fingerprint": "...",
    "semanticFingerprint": "...",
    "title": "...",
    "status": "open",
    "priority": "critical",
    "severity": "critical",
    "failureCode": "...",
    "failureDomain": "STR",
    "failureMode": "...",
    "failureSeverityCode": "C",
    "category": "...",
    "agent": "...",
    "type": "...",
    "filePath": "...",
    "lineNumber": 0,
    "timesSeen": 0,
    "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "resolvedAt": "2026-01-15T10:30:00Z",
    "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Add a note to an issue

Requires authentication
idrequiredstringuuidpath

Issue UUID

contentrequiredstring
noteTypestring
contextresolutionblocker
createdBystring
201Note added
401Missing or invalid authentication
403INSUFFICIENT_ORG_ROLE — org role below `publisher` (writes into an org require publisher or higher; personal-org owners always pass) or ORG_ACCESS_DENIED — not a member of the org named by X-Org-Slug / X-Org-Id. On INSUFFICIENT_ORG_ROLE the body is rewritten: `details.orgSlug`, `details.applied: false`, and a message that forbids retrying without `org`.
404Resource not found

Response fields

dataobject
POST/api/v1/issues/{id}/notes
curl -X POST "https://api.uluops.ai/api/v1/issues/550e8400-e29b-41d4-a716-446655440000/notes" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "name: example-agent\nversion: 1.0.0"
  }'
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "issueId": "550e8400-e29b-41d4-a716-446655440000",
    "content": "...",
    "noteType": "context",
    "createdBy": "...",
    "createdAt": "2026-01-15T10:30:00Z"
  }
}

Restore a deleted issue

Requires authentication
idrequiredstringuuidpath

Issue UUID

200Issue restored
401Missing or invalid authentication
403INSUFFICIENT_ORG_ROLE — org role below `publisher` (writes into an org require publisher or higher; personal-org owners always pass) or ORG_ACCESS_DENIED — not a member of the org named by X-Org-Slug / X-Org-Id. On INSUFFICIENT_ORG_ROLE the body is rewritten: `details.orgSlug`, `details.applied: false`, and a message that forbids retrying without `org`.
404Resource not found

Response fields

dataobject
POST/api/v1/issues/{id}/restore
curl -X POST "https://api.uluops.ai/api/v1/issues/550e8400-e29b-41d4-a716-446655440000/restore" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "fingerprint": "...",
    "semanticFingerprint": "...",
    "title": "...",
    "status": "open",
    "priority": "critical",
    "severity": "critical",
    "failureCode": "...",
    "failureDomain": "STR",
    "failureMode": "...",
    "failureSeverityCode": "C",
    "category": "...",
    "agent": "...",
    "type": "...",
    "filePath": "...",
    "lineNumber": 0,
    "timesSeen": 0,
    "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "resolvedAt": "2026-01-15T10:30:00Z",
    "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Soft-delete an issue

Reversible soft-delete — sets the issue's `deletedAt` timestamp without removing the row. Restore via `POST /issues/{id}/restore`. System-key callers cannot use this endpoint (write operation; system keys are read-only on issue routes per the dual-auth contract).

Requires authentication
idrequiredstringuuidpath

Issue UUID

204Issue soft-deleted (no content)
400Issue already deleted
401Missing or invalid authentication
403System-key callers cannot perform write operations on issues content: application/json: schema: $ref: '#/components/schemas/ErrorResponse'. Also INSUFFICIENT_ORG_ROLE — org role below `publisher` (writes into an org require publisher or higher; personal-org owners always pass) or ORG_ACCESS_DENIED — not a member of the org named by X-Org-Slug / X-Org-Id. On INSUFFICIENT_ORG_ROLE the body is rewritten: `details.orgSlug`, `details.applied: false`, and a message that forbids retrying without `org`.
404Resource not found
DELETE/api/v1/issues/{id}/soft
curl -X DELETE "https://api.uluops.ai/api/v1/issues/550e8400-e29b-41d4-a716-446655440000/soft" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"

Undo last status change

Reverts the most recent status change on an issue and writes a tombstone row (`transitionType: 'undo'`, `revertedChangeId: <reverted-row-id>`) to the audit log. The original row is preserved so the timeline stays monotonic — see GET /issues/:id/history for the full envelope including tombstones. **Cannot undo an undo** (live-tests T2 §3.1 Bug B follow-up): when the most recent row is itself a tombstone, this endpoint returns 400 to prevent chained tombstones from silently bouncing the issue between statuses.

Requires authentication
idrequiredstringuuidpath

Issue UUID

200Status change undone
400ValidationError. One of: - No status change to undo (issue has no history), - Cannot undo initial status (only one status change in history), - Latest entry is already an undo (double-undo not permitted).
401Missing or invalid authentication
403| ForbiddenError. The most recent status change is older than the 24-hour undo window (`UNDO_WINDOW_HOURS`) and cannot be reverted. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse'. Also INSUFFICIENT_ORG_ROLE — org role below `publisher` (writes into an org require publisher or higher; personal-org owners always pass) or ORG_ACCESS_DENIED — not a member of the org named by X-Org-Slug / X-Org-Id. On INSUFFICIENT_ORG_ROLE the body is rewritten: `details.orgSlug`, `details.applied: false`, and a message that forbids retrying without `org`.
404Resource not found

Response fields

dataobject
POST/api/v1/issues/{id}/undo
curl -X POST "https://api.uluops.ai/api/v1/issues/550e8400-e29b-41d4-a716-446655440000/undo" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "fingerprint": "...",
    "semanticFingerprint": "...",
    "title": "...",
    "status": "open",
    "priority": "critical",
    "severity": "critical",
    "failureCode": "...",
    "failureDomain": "STR",
    "failureMode": "...",
    "failureSeverityCode": "C",
    "category": "...",
    "agent": "...",
    "type": "...",
    "filePath": "...",
    "lineNumber": 0,
    "timesSeen": 0,
    "firstSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "lastSeenRunId": "550e8400-e29b-41d4-a716-446655440000",
    "resolvedAt": "2026-01-15T10:30:00Z",
    "resolutionRunId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}