Registry↗Dashboard↗

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.

Requires authentication
projectIdrequiredstringpath

Project UUID or name (org-scoped).

datasetrequiredstringpath
issuesissue-notesstatus-historyoccurrencesrunsagent-snapshotsanalysis-summariesanalysis-records
formatstringquery
ndjsoncsv
Default: ndjson
as_ofstringdate-timequery

ISO 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_deletedstringquery

Issues 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.

truefalse
Default: false
include_archivedstringquery

Runs dataset — include archived runs. DEFAULT true; pass `false` to narrow.

truefalse
Default: true
include_supersededstringquery

Analysis datasets — include superseded rows. DEFAULT true; pass `false` to narrow.

truefalse
Default: true
include_raw_markdownstringquery

Runs dataset — add the raw_markdown column. DEFAULT true; pass `false` to omit it (MEDIUMTEXT, potentially large).

truefalse
Default: true
include_resolvedstringquery

Issues 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.

truefalse
Default: true
200Streamed dataset. Response headers carry X-Export-Schema-Version, X-Export-Total-Rows, X-Export-As-Of, X-Export-Dataset, Content-Disposition, and X-Accel-Buffering. Verify the received row count against X-Export-Total-Rows.
400Validation failed
401Authentication required
403SYSTEM_KEY_NOT_ALLOWED (system keys) or access denied to the project
404Project not found or not accessible
413EXPORT_TOO_LARGE — result exceeds the 100,000-row sync limit
422UNKNOWN_DATASET
429Rate limited
GET/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).

Requires authentication
projectIdrequiredstringpath

Project UUID or name (org-scoped).

formatstringquery
ndjsoncsv
Default: ndjson
as_ofstringdate-timequery

ISO 8601 insertion watermark applied to every dataset.

include_deletedstringquery
truefalse
include_archivedstringquery
truefalse
include_supersededstringquery
truefalse
include_raw_markdownstringquery
truefalse
200Streamed ZIP archive.
400VALIDATION_ERROR — per-dataset filters are rejected; bundles accept only format, as_of, and the four global visibility flags.
401Authentication required
403SYSTEM_KEY_NOT_ALLOWED (system keys) or INSUFFICIENT_ORG_ROLE (below publisher)
404Project not found or not accessible
413EXPORT_TOO_LARGE — aggregate exceeds the bundle row cap; `details.asyncEndpoint` points at `POST /api/v1/export/jobs`
429Rate limited
504EXPORT_PREPARE_TIMEOUT — counting the result set timed out
GET/api/v1/export/projects/{projectId}/bundle
curl -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).

Requires authentication
limitintegerquery
Default: 20
offsetintegerquery
Default: 0
200Org jobs (may be empty).
401Authentication required
403SYSTEM_KEY_NOT_ALLOWED or INSUFFICIENT_ORG_ROLE

Response fields

jobsExportJob[]
GET/api/v1/export/jobs
curl -X GET "https://api.uluops.ai/api/v1/export/jobs" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "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.

Requires authentication
formatstring
ndjsoncsv
as_ofstringdate-time
include_deletedboolean

Include soft-deleted rows. Requires admin+ org role at the whole-org tier (A4).

include_archivedboolean
include_supersededboolean
include_raw_markdownboolean
200The org's existing active job (dedupe, D27).
201New job queued.
400VALIDATION_ERROR — unknown body key or bad as_of
401Authentication required
403SYSTEM_KEY_NOT_ALLOWED or INSUFFICIENT_ORG_ROLE
413EXPORT_JOB_TOO_LARGE — projection exceeds the job row ceiling
429Rate limited (3 creates/hour/org)

Response fields

jobobject

Async 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.

POST/api/v1/export/jobs
curl -X POST "https://api.uluops.ai/api/v1/export/jobs" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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

Requires authentication
jobIdrequiredstringuuidpath
200The job.
401Authentication required
403SYSTEM_KEY_NOT_ALLOWED or INSUFFICIENT_ORG_ROLE
404JOB_NOT_FOUND — unknown job, or a job in another org (uniform 404, no existence leak)

Response fields

jobobject

Async 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.

GET/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"
Response
{
  "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.

Requires authentication
jobIdrequiredstringuuidpath
200Canceled.
401Authentication required
403SYSTEM_KEY_NOT_ALLOWED or INSUFFICIENT_ORG_ROLE
404JOB_NOT_FOUND (unknown, foreign-org, or not cancellable)
409JOB_RUNNING — a running build cannot be canceled in v1
DELETE/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.

Requires authentication
jobIdrequiredstringuuidpath
200Streamed ZIP artifact.
401Authentication required
403SYSTEM_KEY_NOT_ALLOWED or INSUFFICIENT_ORG_ROLE
404JOB_NOT_FOUND, or JOB_NOT_READY (not yet built)
410JOB_EXPIRED — artifact expired (72h retention) or missing (self-healed to expired)
GET/api/v1/export/jobs/{jobId}/download
curl -X GET "https://api.uluops.ai/api/v1/export/jobs/550e8400-e29b-41d4-a716-446655440000/download" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"