Export
Streaming dataset export (paid tier)
7 endpoints
Stream a project dataset as a downloadable NDJSON or CSV file
Streams the full filtered result set (not a page) for one dataset of a project. Requires a paid subscription tier (free is denied). Rate-limited to 10 req/min, 2 req/sec. Success is a streamed body, not the standard JSON envelope; errors use the standard envelope and always occur before the first byte.
Parameters
projectIdrequiredstringpathProject UUID or name (org-scoped).
datasetrequiredstringpathissuesissue-notesstatus-historyoccurrencesrunsagent-snapshotsanalysis-summariesanalysis-recordsformatstringqueryndjsoncsvndjsonas_ofstringdate-timequeryISO 8601 insertion watermark; rows inserted after it are excluded. Default is server-now (rounded up one second). Pass the same explicit value to every call for a coherent multi-dataset snapshot.
include_deletedstringqueryIssues dataset — include soft-deleted rows. DEFAULT false (opt-in), unlike every other visibility flag here. Its default is load-bearing for an access-control decision: the whole-org job route gates deleted rows behind `admin`+ by testing the explicit value, so defaulting it on would let a publisher receive deletion history by omitting the flag.
truefalsefalseinclude_archivedstringqueryRuns dataset — include archived runs. DEFAULT true; pass `false` to narrow.
truefalsetrueinclude_supersededstringqueryAnalysis datasets — include superseded rows. DEFAULT true; pass `false` to narrow.
truefalsetrueinclude_raw_markdownstringqueryRuns dataset — add the raw_markdown column. DEFAULT true; pass `false` to omit it (MEDIUMTEXT, potentially large).
truefalsetrueinclude_resolvedstringqueryIssues dataset — include resolved statuses (`completed`, `wontfix`, `false-positive`). DEFAULT true; pass `false` to narrow to unresolved. Previously this defaulted to false, inherited from the list endpoint, and was the only exclusion no caller could turn off — it was implemented as a dataset filter rather than a visibility flag, so it reached neither the bundle endpoint nor any UI. An export of a real project delivered 81 of 591 rows as a result, with nothing in the file or headers recording it.
truefalsetrueResponses
/api/v1/export/projects/{projectId}/{dataset}curl -X GET "https://api.uluops.ai/api/v1/export/projects/my-project/issues" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Stream a whole-project bundle (ZIP of all 8 datasets)
Tier-1 bulk export (bulk-export spec D16–D21/D30). Streams a ZIP with one entry per dataset (`{dataset}.{ext}`) plus a top-level `manifest.json` (`schemaVersion`, `asOf`, `coherence: "insert-level"`, per-dataset `rowCounts`) — one insert-coherent snapshot at a single `as_of`. Bulk egress: system keys are denied, and the caller needs a paid tier AND a `publisher`+ org role. Success is a streamed ZIP; errors use the standard envelope before the first byte. A mid-stream failure truncates the ZIP so it fails to open (the client verifies at the archive layer).
Parameters
projectIdrequiredstringpathProject UUID or name (org-scoped).
formatstringqueryndjsoncsvndjsonas_ofstringdate-timequeryISO 8601 insertion watermark applied to every dataset.
include_deletedstringquerytruefalseinclude_archivedstringquerytruefalseinclude_supersededstringquerytruefalseinclude_raw_markdownstringquerytruefalseResponses
/api/v1/export/projects/{projectId}/bundlecurl -X GET "https://api.uluops.ai/api/v1/export/projects/my-project/bundle" \
-H "Authorization: Bearer $ULUOPS_TOKEN"List the org's export jobs
Returns the caller's org's export jobs, newest first (org-visibility — any publisher+ member sees them all; `requestedBy` is displayed).
Parameters
limitintegerquery20offsetintegerquery0Responses
Response fields
jobsExportJob[]/api/v1/export/jobscurl -X GET "https://api.uluops.ai/api/v1/export/jobs" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"jobs": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"format": "ndjson",
"asOf": "2026-01-15T10:30:00Z",
"createdAt": "2026-01-15T10:30:00Z",
"startedAt": "2026-01-15T10:30:00Z",
"finishedAt": "2026-01-15T10:30:00Z",
"expiresAt": "2026-01-15T10:30:00Z",
"requestedBy": "550e8400-e29b-41d4-a716-446655440000",
"rowCounts": "...",
"artifactBytes": 0,
"errorCode": "...",
"downloadUrl": "..."
}
]
}Queue an asynchronous whole-org export job
Tier-2 bulk export (bulk-export spec D22–D31). Queues a background job that builds a ZIP of every project in the caller's org. Returns `201` with a new job, or `200` with the org's existing active job (one active job per org). Bulk egress: system keys denied, `publisher`+ role (no tier requirement — export is available on every tier); `include_deleted: true` additionally requires `admin`+ org role (403 `INSUFFICIENT_ORG_ROLE` otherwise). Limited to 3 creates/hour/org.
Request Body
formatstringndjsoncsvas_ofstringdate-timeinclude_deletedbooleanInclude soft-deleted rows. Requires admin+ org role at the whole-org tier (A4).
include_archivedbooleaninclude_supersededbooleaninclude_raw_markdownbooleanResponses
Response fields
jobobjectAsync export job (bulk-export spec §4). NOTE: job endpoints return this under a resource-keyed envelope — `{ job }` for single, `{ jobs: [...] }` for lists — NOT the `{ data }` envelope used elsewhere in this API.
/api/v1/export/jobscurl -X POST "https://api.uluops.ai/api/v1/export/jobs" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'{
"job": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"format": "ndjson",
"asOf": "2026-01-15T10:30:00Z",
"createdAt": "2026-01-15T10:30:00Z",
"startedAt": "2026-01-15T10:30:00Z",
"finishedAt": "2026-01-15T10:30:00Z",
"expiresAt": "2026-01-15T10:30:00Z",
"requestedBy": "550e8400-e29b-41d4-a716-446655440000",
"rowCounts": "...",
"artifactBytes": 0,
"errorCode": "...",
"downloadUrl": "..."
}
}Poll an export job's status
Parameters
jobIdrequiredstringuuidpathResponses
Response fields
jobobjectAsync export job (bulk-export spec §4). NOTE: job endpoints return this under a resource-keyed envelope — `{ job }` for single, `{ jobs: [...] }` for lists — NOT the `{ data }` envelope used elsewhere in this API.
/api/v1/export/jobs/{jobId}curl -X GET "https://api.uluops.ai/api/v1/export/jobs/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"job": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"format": "ndjson",
"asOf": "2026-01-15T10:30:00Z",
"createdAt": "2026-01-15T10:30:00Z",
"startedAt": "2026-01-15T10:30:00Z",
"finishedAt": "2026-01-15T10:30:00Z",
"expiresAt": "2026-01-15T10:30:00Z",
"requestedBy": "550e8400-e29b-41d4-a716-446655440000",
"rowCounts": "...",
"artifactBytes": 0,
"errorCode": "...",
"downloadUrl": "..."
}
}Cancel a queued export job
v1 cancels queued jobs only; a running build cannot be canceled.
Parameters
jobIdrequiredstringuuidpathResponses
/api/v1/export/jobs/{jobId}curl -X DELETE "https://api.uluops.ai/api/v1/export/jobs/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Download a ready export job's ZIP artifact
Streams the artifact through the authed, org-scoped chain (D26 — the only read path; the ready email links here, never a direct file URL). Membership and role are re-checked at download time.
Parameters
jobIdrequiredstringuuidpathResponses
/api/v1/export/jobs/{jobId}/downloadcurl -X GET "https://api.uluops.ai/api/v1/export/jobs/550e8400-e29b-41d4-a716-446655440000/download" \
-H "Authorization: Bearer $ULUOPS_TOKEN"