Registry↗Dashboard↗

Runs

Validation run management

13 endpoints

Save features list (create validation run)

Requires authentication
projectrequiredstring

Project name

workflow_typerequiredstring
agentsrequiredAgentInput[]
recommendationsrequiredRecommendationInput[]
timestampstringdate-time
raw_markdownstringnullable
summaryobject
idempotency_keystringnullable
definition_typestringnullable
definition_namestringnullable
definition_versionstringnullable
definition_hashstringnullable
definition_idstringuuidnullable

Registry definition UUID — enables direct identity linkage between tracker and registry

analysis_recordsAnalysisRecordInput[]
analysis_summaryobject
200Run already exists (deduplicated)
201Run 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`.
410PROJECT_MERGED — the named project was merged into a successor (merge-projects v0.3.4 §9.6). Update the caller's project name to details.target_project_name and retry. (An owned soft-deleted project WITHOUT a merge keeps the 409 soft_deleted_conflict restore-hint behavior.)
503MERGE_IN_PROGRESS — a project merge currently holds this project's advisory lock and is re-keying rows. Retry after details.retry_after_seconds; the merge typically commits within a second.

Response fields

dataobject
POST/api/v1/runs
curl -X POST "https://api.uluops.ai/api/v1/runs" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "my-project",
    "workflow_type": "ship",
    "agents": [
      {
        "name": "my-project",
        "decision": "example-value"
      }
    ],
    "recommendations": [
      {
        "agent": "code-validator",
        "title": "Missing error handler in auth middleware",
        "priority": "critical"
      }
    ]
  }'
Response
{
  "data": {
    "run": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "runNumber": 0,
    "workflowType": "...",
    "timestamp": "2026-01-15T10:30:00Z",
    "allGatesPassed": true,
    "averageScore": 0,
    "rawMarkdown": "...",
    "archivedAt": "2026-01-15T10:30:00Z",
    "archiveReason": "...",
    "idempotencyKey": "...",
    "payloadHash": "...",
    "definitionType": "...",
    "definitionName": "...",
    "definitionVersion": "...",
    "definitionHash": "...",
    "definitionId": "550e8400-e29b-41d4-a716-446655440000",
    "registrySyncedAt": "2026-01-15T10:30:00Z",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromRunNumber": 0,
    "mergedFromIdempotencyKey": "...",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "projectSlug": "...",
    "orgSlug": "...",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  },
    "agents": [],
    "correlation": {
    "newIssues": 0,
    "recurringIssues": 0,
    "regressions": 0,
    "observed": 0,
    "duplicatesSkipped": 0,
    "crossAgentMatches": [
    {
      "issueId": "550e8400-e29b-41d4-a716-446655440000",
      "title": "...",
      "agent": "...",
      "crossAgentMatches": []
    }
  ]
  },
    "deduplicated": true
  }
}

Preview save_run without saving

Requires authentication
projectrequiredstring

Project name

workflow_typerequiredstring
agentsrequiredAgentInput[]
recommendationsrequiredRecommendationInput[]
timestampstringdate-time
raw_markdownstringnullable
summaryobject
idempotency_keystringnullable
definition_typestringnullable
definition_namestringnullable
definition_versionstringnullable
definition_hashstringnullable
definition_idstringuuidnullable

Registry definition UUID — enables direct identity linkage between tracker and registry

analysis_recordsAnalysisRecordInput[]
analysis_summaryobject
200Validation preview
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. Read-only preview: the platform's generic body is returned unchanged.

Response fields

dataobject
POST/api/v1/runs/validate
curl -X POST "https://api.uluops.ai/api/v1/runs/validate" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "my-project",
    "workflow_type": "ship",
    "agents": [
      {
        "name": "my-project",
        "decision": "example-value"
      }
    ],
    "recommendations": [
      {
        "agent": "code-validator",
        "title": "Missing error handler in auth middleware",
        "priority": "critical"
      }
    ]
  }'
Response
{
  "data": {
    "wouldCreate": 0,
    "wouldUpdate": 0,
    "wouldRegress": 0,
    "wouldObserve": 0,
    "validationErrors": [],
    "preview": {
    "newIssues": [
    {
      "title": "...",
      "agent": "..."
    }
  ],
    "recurringIssues": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "...",
      "timesSeen": 0
    }
  ],
    "regressions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "...",
      "lastStatus": "..."
    }
  ],
    "observations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "..."
    }
  ]
  }
  }
}

Archive old runs

Requires authentication
projectrequiredstring
before_run_numberinteger
before_datestringdate-time
keep_lastinteger
reasonstring
200Runs archived
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/runs/archive
curl -X POST "https://api.uluops.ai/api/v1/runs/archive" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "my-project"
  }'
Response
{
  "data": {
    "archived": 0
  }
}

Update run by project and run number

Requires authentication
projectrequiredstring
run_numberrequiredinteger
workflow_typestring
all_gates_passedboolean
average_scorenumber
raw_markdownstring
agentsAgentTokenUpdate[]
recommendationsRecommendationInput[]
analysis_recordsUpdateAnalysisRecordInput[]
analysis_summaryobject
record_write_modestring

Records-only write mode (spec §3.2, 1b; default replace). replace = set-replacement within each named agent (omission retires); merge = upsert on (agent_name, record_id) — matched keys superseded, unmatched keys appended, nothing retired. Summaries have no mode (always per-agent replace). Unknown values 400; sending the mode without analysis_records 400.

replacemerge
200Run updated. Analysis writes are per-agent scoped (replacement-semantics phase 1a) — see PATCH /runs/{id}; analysis-bearing responses carry the additive analysisWrite echo.
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`.
404Resource not found

Response fields

dataobject
analysisWriteobject

Additive block on analysis-bearing update responses (replacement-semantics spec §3.9), serialized camelCase beside the data envelope. New SDKs assert recordMode equals the mode they sent, converting silent version skew into a loud error; old consumers strip the block harmlessly.

PATCH/api/v1/runs/update
curl -X PATCH "https://api.uluops.ai/api/v1/runs/update" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "my-project",
    "run_number": 5
  }'
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "runNumber": 0,
    "workflowType": "...",
    "timestamp": "2026-01-15T10:30:00Z",
    "allGatesPassed": true,
    "averageScore": 0,
    "rawMarkdown": "...",
    "archivedAt": "2026-01-15T10:30:00Z",
    "archiveReason": "...",
    "idempotencyKey": "...",
    "payloadHash": "...",
    "definitionType": "...",
    "definitionName": "...",
    "definitionVersion": "...",
    "definitionHash": "...",
    "definitionId": "550e8400-e29b-41d4-a716-446655440000",
    "registrySyncedAt": "2026-01-15T10:30:00Z",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromRunNumber": 0,
    "mergedFromIdempotencyKey": "...",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "projectSlug": "...",
    "orgSlug": "...",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  },
  "analysisWrite": {
    "recordMode": "replace",
    "supersededRecords": 0,
    "supersededSummaries": 0,
    "createdRecords": 0,
    "createdSummaries": 0
  }
}

Preview an analysis-bearing update by project and run number (read-only)

By-project sibling of POST /runs/{id}/update-preview. Accepts analysis concerns only — a body carrying agents, recommendations, or run metadata fields is a 400, never a silent strip. Shares its resolution and plan computation with the write path; nothing is written.

Requires authentication
projectrequiredstring
run_numberrequiredinteger
analysis_recordsUpdateAnalysisRecordInput[]
analysis_summaryobject
record_write_modestring

Records-only write mode (spec §3.2, 1b; default replace). replace = set-replacement within each named agent (omission retires); merge = upsert on (agent_name, record_id) — matched keys superseded, unmatched keys appended, nothing retired. Summaries have no mode (always per-agent replace). Unknown values 400; sending the mode without analysis_records 400.

replacemerge
200Per-agent preview of what the write would supersede, create, and retire
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. Read-only preview: the platform's generic body is returned unchanged.
404Resource not found

Response fields

datarequiredobject
POST/api/v1/runs/update-preview
curl -X POST "https://api.uluops.ai/api/v1/runs/update-preview" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "my-project",
    "run_number": 5
  }'
Response
{
  "data": {
    "preview": "true",
    "recordMode": "replace",
    "byAgent": "..."
  }
}

Compare two runs

Requires authentication
projectrequiredstringquery
base_runrequiredintegerquery
compare_runrequiredintegerquery
workflow_typestringquery
200Run comparison
401Missing or invalid authentication

Response fields

dataobject
GET/api/v1/runs/diff
curl -X GET "https://api.uluops.ai/api/v1/runs/diff?project=my-project&base_run=1&compare_run=1" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "fixed": [
    {
      "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"
    }
  ],
    "new": [
    {
      "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"
    }
  ],
    "unchanged": [
    {
      "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"
    }
  ],
    "agentChanges": []
  }
}

List runs for a project

Requires authentication
projectIdrequiredstringpath
workflow_typestringquery
showArchivedbooleanquery

Include archived runs in the result set (default false)

Default: false
limitintegerquery

Maximum number of results

Default: 50
offsetintegerquery

Number of results to skip

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

Response fields

dataRun[]
totalinteger

Total matching runs across all pages

countinteger

Number of runs in the current response (length of data)

GET/api/v1/runs/project/{projectId}
curl -X GET "https://api.uluops.ai/api/v1/runs/project/my-project" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "projectId": "550e8400-e29b-41d4-a716-446655440000",
      "runNumber": 0,
      "workflowType": "...",
      "timestamp": "2026-01-15T10:30:00Z",
      "allGatesPassed": true,
      "averageScore": 0,
      "rawMarkdown": "...",
      "archivedAt": "2026-01-15T10:30:00Z",
      "archiveReason": "...",
      "idempotencyKey": "...",
      "payloadHash": "...",
      "definitionType": "...",
      "definitionName": "...",
      "definitionVersion": "...",
      "definitionHash": "...",
      "definitionId": "550e8400-e29b-41d4-a716-446655440000",
      "registrySyncedAt": "2026-01-15T10:30:00Z",
      "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
      "mergedFromRunNumber": 0,
      "mergedFromIdempotencyKey": "...",
      "authorId": "550e8400-e29b-41d4-a716-446655440000",
      "projectSlug": "...",
      "orgSlug": "...",
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T10:30:00Z"
    }
  ],
  "total": 0,
  "count": 0
}

Get latest run for a project

Returns the latest VALIDATION run. The synthetic per-project 'manual' run (the anchor row for issues logged outside a validation run) is excluded unless workflow_type=manual is passed explicitly — it executed no gates and must not answer "did the latest run pass?" (T8).

Requires authentication
projectIdrequiredstringpath
workflow_typestringquery
200Latest run
401Missing or invalid authentication
404Resource not found

Response fields

dataobject
GET/api/v1/runs/project/{projectId}/latest
curl -X GET "https://api.uluops.ai/api/v1/runs/project/my-project/latest" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "runNumber": 0,
    "workflowType": "...",
    "timestamp": "2026-01-15T10:30:00Z",
    "allGatesPassed": true,
    "averageScore": 0,
    "rawMarkdown": "...",
    "archivedAt": "2026-01-15T10:30:00Z",
    "archiveReason": "...",
    "idempotencyKey": "...",
    "payloadHash": "...",
    "definitionType": "...",
    "definitionName": "...",
    "definitionVersion": "...",
    "definitionHash": "...",
    "definitionId": "550e8400-e29b-41d4-a716-446655440000",
    "registrySyncedAt": "2026-01-15T10:30:00Z",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromRunNumber": 0,
    "mergedFromIdempotencyKey": "...",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "projectSlug": "...",
    "orgSlug": "...",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Get run details for a project

Requires authentication
projectIdrequiredstringpath
run_numberintegerquery
workflow_typestringquery
200Run details with agents and issues
401Missing or invalid authentication
404Resource not found

Response fields

dataobject
GET/api/v1/runs/project/{projectId}/details
curl -X GET "https://api.uluops.ai/api/v1/runs/project/my-project/details" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "run": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "runNumber": 0,
    "workflowType": "...",
    "timestamp": "2026-01-15T10:30:00Z",
    "allGatesPassed": true,
    "averageScore": 0,
    "rawMarkdown": "...",
    "archivedAt": "2026-01-15T10:30:00Z",
    "archiveReason": "...",
    "idempotencyKey": "...",
    "payloadHash": "...",
    "definitionType": "...",
    "definitionName": "...",
    "definitionVersion": "...",
    "definitionHash": "...",
    "definitionId": "550e8400-e29b-41d4-a716-446655440000",
    "registrySyncedAt": "2026-01-15T10:30:00Z",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromRunNumber": 0,
    "mergedFromIdempotencyKey": "...",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "projectSlug": "...",
    "orgSlug": "...",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  },
    "agents": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "runId": "550e8400-e29b-41d4-a716-446655440000",
      "name": "...",
      "definitionVersion": "...",
      "score": 0,
      "maxScore": 0,
      "decision": "...",
      "summary": "...",
      "model": "...",
      "inputTokens": 0,
      "outputTokens": 0,
      "cacheCreationTokens": 0,
      "cacheReadTokens": 0,
      "totalEffectiveTokens": 0,
      "durationMs": 0,
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T10:30:00Z"
    }
  ],
    "recommendations": [
    {
      "issueId": "550e8400-e29b-41d4-a716-446655440000",
      "title": "...",
      "priority": "critical",
      "status": "new",
      "issueStatus": "open",
      "agent": "..."
    }
  ]
  }
}

Get a run by ID

Requires authentication
idrequiredstringuuidpath

Run UUID

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

Response fields

dataobject
GET/api/v1/runs/{id}
curl -X GET "https://api.uluops.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "runNumber": 0,
    "workflowType": "...",
    "timestamp": "2026-01-15T10:30:00Z",
    "allGatesPassed": true,
    "averageScore": 0,
    "rawMarkdown": "...",
    "archivedAt": "2026-01-15T10:30:00Z",
    "archiveReason": "...",
    "idempotencyKey": "...",
    "payloadHash": "...",
    "definitionType": "...",
    "definitionName": "...",
    "definitionVersion": "...",
    "definitionHash": "...",
    "definitionId": "550e8400-e29b-41d4-a716-446655440000",
    "registrySyncedAt": "2026-01-15T10:30:00Z",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromRunNumber": 0,
    "mergedFromIdempotencyKey": "...",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "projectSlug": "...",
    "orgSlug": "...",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Update a run

Requires authentication
idrequiredstringuuidpath

Run UUID

all_gates_passedboolean
average_scorenumber
raw_markdownstring
workflow_typestring
archived_atstringdate-timenullable

ISO 8601 timestamp marking the run archived. Null clears the archive.

archived_reasonstringnullable

Optional human-readable reason for archiving (max 500 chars).

agentsAgentTokenUpdate[]
recommendationsRecommendationInput[]
analysis_recordsUpdateAnalysisRecordInput[]
analysis_summaryobject
record_write_modestring

Records-only write mode (spec §3.2, 1b; default replace). replace = set-replacement within each named agent (omission retires); merge = upsert on (agent_name, record_id) — matched keys superseded, unmatched keys appended, nothing retired. Summaries have no mode (always per-agent replace). Unknown values 400; sending the mode without analysis_records 400.

replacemerge
200Run updated. Analysis writes are per-agent scoped (replacement-semantics phase 1a): the payload's analysis rows supersede live rows only for the agents named in it (after defaulting from the run's stored definition_name); other agents' rows and the un-written kind are untouched. Analysis-bearing responses carry the additive analysisWrite echo.
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`.
404Resource not found

Response fields

dataobject
analysisWriteobject

Additive block on analysis-bearing update responses (replacement-semantics spec §3.9), serialized camelCase beside the data envelope. New SDKs assert recordMode equals the mode they sent, converting silent version skew into a loud error; old consumers strip the block harmlessly.

PATCH/api/v1/runs/{id}
curl -X PATCH "https://api.uluops.ai/api/v1/runs/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",
    "runNumber": 0,
    "workflowType": "...",
    "timestamp": "2026-01-15T10:30:00Z",
    "allGatesPassed": true,
    "averageScore": 0,
    "rawMarkdown": "...",
    "archivedAt": "2026-01-15T10:30:00Z",
    "archiveReason": "...",
    "idempotencyKey": "...",
    "payloadHash": "...",
    "definitionType": "...",
    "definitionName": "...",
    "definitionVersion": "...",
    "definitionHash": "...",
    "definitionId": "550e8400-e29b-41d4-a716-446655440000",
    "registrySyncedAt": "2026-01-15T10:30:00Z",
    "mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
    "mergedFromRunNumber": 0,
    "mergedFromIdempotencyKey": "...",
    "authorId": "550e8400-e29b-41d4-a716-446655440000",
    "projectSlug": "...",
    "orgSlug": "...",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  },
  "analysisWrite": {
    "recordMode": "replace",
    "supersededRecords": 0,
    "supersededSummaries": 0,
    "createdRecords": 0,
    "createdSummaries": 0
  }
}

Delete a run

Requires authentication
idrequiredstringuuidpath

Run UUID

X-Confirm-Deleterequiredstringheader

Must match the run ID exactly for confirmation

200Run deleted
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
DELETE/api/v1/runs/{id}
curl -X DELETE "https://api.uluops.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "X-Confirm-Delete: true"
Response
{
  "data": {
    "deleted": true
  }
}

Preview an analysis-bearing update without writing (read-only)

Returns, per agent named in the payload (after defaulting from the run's stored definition_name), what a PATCH with this analysis payload would supersede, create, and retire by omission. Accepts analysis concerns only — a body carrying agents, recommendations, or run metadata fields is a 400, never a silent strip. Deliberately a separate endpoint rather than a dry-run flag on PATCH: a flag sent to an older API would be stripped and the write would execute; this endpoint on an old API 404s.

Requires authentication
idrequiredstringuuidpath

Run UUID

analysis_recordsUpdateAnalysisRecordInput[]
analysis_summaryobject
record_write_modestring

Records-only write mode (spec §3.2, 1b; default replace). replace = set-replacement within each named agent (omission retires); merge = upsert on (agent_name, record_id) — matched keys superseded, unmatched keys appended, nothing retired. Summaries have no mode (always per-agent replace). Unknown values 400; sending the mode without analysis_records 400.

replacemerge
200Per-agent preview of what the write would supersede, create, and retire
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. Read-only preview: the platform's generic body is returned unchanged.
404Resource not found

Response fields

datarequiredobject
POST/api/v1/runs/{id}/update-preview
curl -X POST "https://api.uluops.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000/update-preview" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "data": {
    "preview": "true",
    "recordMode": "replace",
    "byAgent": "..."
  }
}