Projects
Project management
17 endpoints
List all projects
Responses
Response fields
dataProject[]countintegerTotal number of projects
/api/v1/projectscurl -X GET "https://api.uluops.ai/api/v1/projects" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "...",
"domain": "software",
"ownerId": "550e8400-e29b-41d4-a716-446655440000",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"deletedAt": "2026-01-15T10:30:00Z"
}
],
"count": 0
}Create a project
Request BodyCreateProjectRequest
namerequiredstringdomainstringProject domain category (defaults to 'software')
Responses
Response fields
dataobject/api/v1/projectscurl -X POST "https://api.uluops.ai/api/v1/projects" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "my-project"
}'{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "...",
"domain": "software",
"ownerId": "550e8400-e29b-41d4-a716-446655440000",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"deletedAt": "2026-01-15T10:30:00Z"
}
}Rename a project
Request BodyRenameProjectRequest
old_namerequiredstringnew_namerequiredstringResponses
Response fields
dataobject/api/v1/projects/renamecurl -X POST "https://api.uluops.ai/api/v1/projects/rename" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"old_name": "my-project",
"new_name": "my-project-v2"
}'{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "...",
"domain": "software",
"ownerId": "550e8400-e29b-41d4-a716-446655440000",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"deletedAt": "2026-01-15T10:30:00Z"
}
}Merge one project into another
Re-keys the source project's runs and issues into the target inside one transaction serialized by two-key MySQL advisory locks (source + target), deduplicates issues on fingerprint collisions, writes a project_merges audit row, and soft-deletes the source (merge-projects spec v0.3.4). Error codes are stability-pinned per the spec's §5 policy.
Request BodyMergeProjectsRequest
sourcerequiredstringSource project name or UUID (consumed by the merge)
targetrequiredstringTarget project name or UUID (survives, absorbs the source)
dry_runbooleanPreview only — the merge transaction is rolled back
Default:falsedelete_sourcebooleanSoft-delete the source after the merge (false keeps it as an empty project, reserving the name)
Default:trueconfirm_cross_orgbooleanRequired true for system-actor cross-org merges (Q15). No-op for human callers — human cross-org merges are always rejected.
Default:falseResponses
Response fields
dataobjectMerge outcome (spec §5, 0.3.5 — camelCase; the snake_case pin was retired at API 2.0.0)
/api/v1/projects/mergecurl -X POST "https://api.uluops.ai/api/v1/projects/merge" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"source": "example-value",
"target": "example-value"
}'{
"data": {
"source": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "...",
"runCount": 0,
"issueCount": 0,
"statusAfter": "soft-deleted"
},
"target": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "...",
"runCountBefore": 0,
"issueCountBefore": 0,
"runCountAfter": 0,
"issueCountAfter": 0
},
"moved": {
"runs": 0,
"issues": 0,
"issueDedupes": 0,
"occurrencesReparented": 0,
"issueNotesReparented": 0,
"statusHistoryReparented": 0
},
"conflicts": [
{
"kind": "fingerprint_dedup",
"sourceId": "550e8400-e29b-41d4-a716-446655440000",
"targetId": "550e8400-e29b-41d4-a716-446655440000",
"resolution": "..."
}
],
"audit": {
"mergeId": "...",
"timestamp": "2026-01-15T10:30:00Z",
"actorId": "...",
"dryRun": true
}
}
}Move a project to another organization
Moves the project's `org_id` to the target organization inside one transaction serialized by the per-project advisory lock, writes a forward tombstone at the address it vacates, and emits one audit row in each org (project-org-routing-and-rehome spec §4, D14). The SOURCE organization is the caller's org context — resolved from `:slug` / `X-Org-Id` / `X-Org-Slug` / the personal org — and never the project's own org. A caller moving a project out of a work org must name that org on the request; without a header they are addressing their personal org and will get a 404. Requires `admin` or `owner` in BOTH organizations. Everything the project carries — runs, issues, analysis, fingerprints — is `project_id`-keyed and moves with it untouched; `owner_id` is deliberately NOT changed. After a move, by-name writes at the old address are refused with `410 PROJECT_REHOMED` rather than silently creating a new project there.
Parameters
idrequiredstringpathProject UUID or name (resolved within the caller's org)
Request BodyRehomeProjectRequest
target_orgrequiredstringSlug of the organization to move the project into
reasonstringWhy the project moved. Optional here and REQUIRED on the admin path, where it is the target organization's only standing (that route has no target-membership check). Stored on the tombstone and returned by the admin listing; deliberately never rendered into an error message or relayed to an MCP client.
Responses
Response fields
dataobjectThe moved project's read projection, plus a record of the move.
/api/v1/projects/{id}/rehomecurl -X POST "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/rehome" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"target_org": "example-value"
}'{
"data": {
"id": "...",
"name": "...",
"domain": "...",
"ownerId": "...",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"rehome": {
"from_org": {
"id": "...",
"slug": "..."
},
"to_org": {
"id": "...",
"slug": "..."
},
"audit_ids": []
}
}
}Get a project
Parameters
idrequiredstringpathProject UUID or name
Responses
Response fields
dataobject/api/v1/projects/{id}curl -X GET "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "...",
"domain": "software",
"ownerId": "550e8400-e29b-41d4-a716-446655440000",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"deletedAt": "2026-01-15T10:30:00Z"
}
}Update a project
Parameters
idrequiredstringpathProject UUID or name
Request BodyUpdateProjectRequest
namestringResponses
Response fields
dataobject/api/v1/projects/{id}curl -X PATCH "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "...",
"domain": "software",
"ownerId": "550e8400-e29b-41d4-a716-446655440000",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"deletedAt": "2026-01-15T10:30:00Z"
}
}Hard delete a project
Parameters
idrequiredstringpathProject UUID or name
Request Body
confirmrequiredbooleanconfirmation_phraserequiredstringResponses
/api/v1/projects/{id}curl -X DELETE "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"confirm": true,
"confirmation_phrase": "DELETE my-project"
}'Soft delete a project
Parameters
idrequiredstringpathProject UUID or name
Responses
/api/v1/projects/{id}/softcurl -X DELETE "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/soft" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Restore a soft-deleted project
Restore is a create-shaped transition for quota purposes: at the project cap it fails with the same 402 as create (free a slot first).
Parameters
idrequiredstringpathProject UUID or name
Responses
/api/v1/projects/{id}/restorecurl -X POST "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/restore" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Get project summary
Parameters
idrequiredstringpathProject UUID or name
Responses
Response fields
dataobject/api/v1/projects/{id}/summarycurl -X GET "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/summary" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": {
"project": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "...",
"domain": "software",
"ownerId": "550e8400-e29b-41d4-a716-446655440000",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z",
"deletedAt": "2026-01-15T10:30:00Z"
},
"issueCounts": {
"total": 0,
"open": 0,
"completed": 0,
"deferred": 0,
"wontfix": 0,
"false_positive": 0
},
"recentRuns": [
{
"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 project trends
Parameters
idrequiredstringpathProject UUID or name
daysintegerqueryTime window in days
Default:30Responses
Response fields
dataobject/api/v1/projects/{id}/trendscurl -X GET "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/trends" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}The project log — runs, decisions and regressions interleaved, newest first
`ulu log`'s stream (spec v0.1.9 §3.2). Three event types share one keyset-paged list: `run` (from the run table, with `agents[]` from the snapshots; `counts` stays `null` on runs saved before migration 065), `decision` (a status-history row — `reason` may be `null`; `source` is `'agent'` or `null`, and `null` means *unattributed*, never *human*), and `regression` (a resolved→open row a RUN wrote — it resolves to `viaRunNumber`; the same row is never also a `decision`). A resolved→open row without a run is a `decision`: reopened by decision, never "by hand". Excluded: undo tombstones, rows a later undo retracted, rows on merged or soft-deleted issues, self-transitions (re-stated dispositions — counted by `/log/stat` as `activity.restated`, D13), and archived runs unless `includeArchived`. **Ordering is a display convention, not a causal claim.** Ledger events sort by `(changedAt, seq)`, runs by `(timestamp, runNumber)`; the merge compares at second precision and puts runs before ledger events inside an equal second. Run times are as reported by the saving client; ledger times are the server clock. `seq` is insertion order — arbitrary but frozen inside a second for rows recorded before millisecond timestamps (migration 080) — and is what makes the cursor exact.
Parameters
idrequiredstringpathProject UUID or name
sincestringdate-timequeryuntilstringdate-timequeryMust be >= `since` (400 otherwise). Both optional; default all time.
limitintegerquery50cursorstringqueryOpaque; pass back a `nextCursor`. Anything else is `400 cursor must be a value returned as nextCursor`.
kindstringqueryComma-separated subset of `run,decision,regression`.
workflowTypestringqueryFilters `run` events only — ledger events have no workflow and pass through.
agentstringqueryFilters `run` events by snapshot name and ledger events by the issue's agent.
includeArchivedstringquerytruefalseResponses
Response fields
datarequiredLogEvent[]countrequiredintegerhasMorerequiredbooleannextCursorstringPresent only when `hasMore` is true.
/api/v1/projects/{id}/logcurl -X GET "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/log" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": [],
"count": 0,
"hasMore": true,
"nextCursor": "..."
}The log's rollup — examined / found / decided / cameBack / activity
`ulu log --stat` (spec v0.1.9 §3.3). Two frames on two clocks: the COHORT frame (`examined`, `found`, `decided`) windows on run timestamps; the ACTIVITY frame (`activity`, `cameBack`) windows on ledger timestamps. `decided` is the current status of each `found` issue and sums to `found.issues` — it is not "decisions made in the window"; that is `activity.decisions`. The regression unit is distinct issues, with the row count beside it. `lastDetectedAtAllTime` ignores the window by definition. No window means all time.
Parameters
idrequiredstringpathProject UUID or name
sincestringdate-timequeryuntilstringdate-timequeryResponses
Response fields
dataobject/api/v1/projects/{id}/log/statcurl -X GET "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/log/stat" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}List issues for a project
Parameters
idrequiredstringpathProject UUID or name
statusstringqueryopencompleteddeferredwontfixmergedfalse-positiveallopenprioritystringquerycriticalhighsuggestedbacklogseveritystringquerycriticalhighmediumlowinfofailure_domainstringquerySTRSEMPRAEPIagentstringqueryinclude_resolvedbooleanqueryfalsemin_times_seenintegerquerydate_startstringdate-timequeryFilter issues created on or after this ISO 8601 timestamp
date_endstringdate-timequeryFilter issues created on or before this ISO 8601 timestamp
limitintegerqueryMaximum number of results
Default:50offsetintegerqueryNumber of results to skip
Default:0Responses
Response fields
dataIssue[]countinteger/api/v1/projects/{id}/issuescurl -X GET "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/issues" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"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
}Bulk update issue statuses
Parameters
idrequiredstringpathProject UUID or name
Request Body
updatesrequiredobject[]Responses
Response fields
dataobject/api/v1/projects/{id}/issues/statuscurl -X PATCH "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/issues/status" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"updates": [
{
"status": "open"
}
]
}'{
"data": {
"updated": 0,
"failed": 0
}
}Merge issues
Parameters
idrequiredstringpathProject UUID or name
Request BodyMergeIssuesRequest
target_issue_idrequiredstringuuidsource_issue_idsrequiredstring[]strategystringkeep_targetkeep_highest_prioritykeep_targetResponses
Response fields
dataobject/api/v1/projects/{id}/issues/mergecurl -X POST "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/issues/merge" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"target_issue_id": "550e8400-e29b-41d4-a716-446655440000",
"source_issue_ids": []
}'{
"data": {
"mergedIssue": {
"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"
},
"sourceIssuesMerged": 0
}
}