Registry↗Dashboard↗

Organizations

18 endpoints

List user's organizations

Requires authentication
200List of organizations

Response fields

dataobject
GET/api/v1/orgs
curl -X GET "https://api.uluops.ai/api/v1/orgs" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "organizations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "...",
      "slug": "...",
      "isPersonal": true,
      "subscriptionTier": "free",
      "maxProjects": 0,
      "maxMembers": 0,
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ]
  }
}

Create a team organization

Requires authentication
namerequiredstring
slugrequiredstring
Pattern: ^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$
201Organization created
400Validation failed
402Free team org limit reached
409Slug taken or retired

Response fields

dataobject
POST/api/v1/orgs
curl -X POST "https://api.uluops.ai/api/v1/orgs" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-project",
    "slug": "example-value"
  }'
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "...",
    "slug": "...",
    "isPersonal": true,
    "subscriptionTier": "free",
    "maxProjects": 0,
    "maxMembers": 0,
    "createdAt": "2026-01-15T10:30:00Z"
  }
}

Check org slug availability

Requires authentication
slugrequiredstringpath
200Availability result
400Validation failed
401Missing or invalid authentication

Response fields

dataobject
GET/api/v1/orgs/check-slug/{slug}
curl -X GET "https://api.uluops.ai/api/v1/orgs/check-slug/example-value" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "available": true,
    "reason": "taken"
  }
}

Accept an invitation

Requires authentication
tokenrequiredstringpath
200Invitation accepted
400Invalid status (already accepted/revoked)
404Resource not found
409Already a member
410Invitation expired
POST/api/v1/orgs/invitations/{token}/accept
curl -X POST "https://api.uluops.ai/api/v1/orgs/invitations/reset-token-abc123/accept" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"

Get organization details

Requires authentication
slugrequiredstringpath
200Organization details
404Resource not found

Response fields

dataobject
GET/api/v1/orgs/{slug}
curl -X GET "https://api.uluops.ai/api/v1/orgs/example-value" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "...",
    "slug": "...",
    "isPersonal": true,
    "subscriptionTier": "free",
    "maxProjects": 0,
    "maxMembers": 0,
    "createdAt": "2026-01-15T10:30:00Z"
  }
}

Update organization name

Requires authentication
slugrequiredstringpath
namerequiredstring
200Organization updated
400Validation failed
404Resource not found
PATCH/api/v1/orgs/{slug}
curl -X PATCH "https://api.uluops.ai/api/v1/orgs/example-value" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-project"
  }'

Soft-delete organization (administrator only)

Requires authentication
slugrequiredstringpath
200Organization soft-deleted
400Cannot delete personal org
404Resource not found
DELETE/api/v1/orgs/{slug}
curl -X DELETE "https://api.uluops.ai/api/v1/orgs/example-value" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"

Restore soft-deleted org within 30-day window

Requires authentication
slugrequiredstringpath
200Organization restored
404Resource not found
410Restoration window expired
POST/api/v1/orgs/{slug}/restore
curl -X POST "https://api.uluops.ai/api/v1/orgs/example-value/restore" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"

List organization members

Requires authentication
slugrequiredstringpath
200Member list

Response fields

dataobject
countinteger
GET/api/v1/orgs/{slug}/members
curl -X GET "https://api.uluops.ai/api/v1/orgs/example-value/members" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "members": [
    {
      "id": "...",
      "userId": "550e8400-e29b-41d4-a716-446655440000",
      "role": "viewer",
      "email": "...",
      "name": "...",
      "username": "..."
    }
  ]
  },
  "count": 0
}

Update member role (admin+)

Requires authentication
slugrequiredstringpath
membershipIdrequiredstringpath
rolerequiredstring
viewerpublisheradmin
200Role updated
400Cannot change administrator role
404Resource not found
PATCH/api/v1/orgs/{slug}/members/{membershipId}
curl -X PATCH "https://api.uluops.ai/api/v1/orgs/example-value/members/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "viewer"
  }'

Remove member (admin+)

Requires authentication
slugrequiredstringpath
membershipIdrequiredstringpath
200Member removed
400Cannot remove administrator
404Resource not found
DELETE/api/v1/orgs/{slug}/members/{membershipId}
curl -X DELETE "https://api.uluops.ai/api/v1/orgs/example-value/members/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"

List invitations (admin+)

Requires authentication
slugrequiredstringpath
statusstringquery
pendingacceptedexpiredrevoked
200Invitation list

Response fields

dataobject
countinteger
GET/api/v1/orgs/{slug}/invitations
curl -X GET "https://api.uluops.ai/api/v1/orgs/example-value/invitations" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "invitations": [
    {
      "id": "...",
      "orgId": "550e8400-e29b-41d4-a716-446655440000",
      "email": "user@example.com",
      "role": "viewer",
      "status": "pending",
      "expiresAt": "2026-01-15T10:30:00Z",
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ]
  },
  "count": 0
}

Send invitation (admin+)

Requires authentication
slugrequiredstringpath
emailrequiredstringemail
rolerequiredstring
viewerpublisheradmin
201Invitation sent
402Member limit reached
409Already a member or invitation exists

Response fields

dataobject
POST/api/v1/orgs/{slug}/invitations
curl -X POST "https://api.uluops.ai/api/v1/orgs/example-value/invitations" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "role": "viewer"
  }'
Response
{
  "data": {
    "id": "...",
    "orgId": "550e8400-e29b-41d4-a716-446655440000",
    "email": "user@example.com",
    "role": "viewer",
    "status": "pending",
    "expiresAt": "2026-01-15T10:30:00Z",
    "createdAt": "2026-01-15T10:30:00Z"
  }
}

Revoke invitation (admin+)

Requires authentication
slugrequiredstringpath
invitationIdrequiredstringpath
200Invitation revoked
400Invalid status (not pending)
404Resource not found
DELETE/api/v1/orgs/{slug}/invitations/{invitationId}
curl -X DELETE "https://api.uluops.ai/api/v1/orgs/example-value/invitations/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"

Transfer administrator role (administrator only)

Requires authentication
slugrequiredstringpath
targetUserIdrequiredstringuuid
200Administrator transferred
400Cannot transfer personal org
404Resource not found
POST/api/v1/orgs/{slug}/transfer-administrator
curl -X POST "https://api.uluops.ai/api/v1/orgs/example-value/transfer-administrator" \
  -H "Authorization: Bearer $ULUOPS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "targetUserId": "550e8400-e29b-41d4-a716-446655440000"
  }'

Audit log with cursor pagination (admin+)

Requires authentication
slugrequiredstringpath
actionstringquery
cursorstringdate-timequery
limitintegerquery
200Audit log entries

Response fields

dataobject
countinteger
hasMoreboolean
nextCursorstringnullable
GET/api/v1/orgs/{slug}/audit-log
curl -X GET "https://api.uluops.ai/api/v1/orgs/example-value/audit-log" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "entries": []
  },
  "count": 0,
  "hasMore": true,
  "nextCursor": "..."
}

The log's rollup org-wide, with a per-project summary table

`ulu log --orgs` (spec v0.1.11 §3.6 D6). The same rollup as `GET /projects/{id}/log/stat` — two frames on two clocks, every exclusion unchanged — computed over the org's live projects, plus `projects[]` (the summary shape, last run desc, capped at 100 with `hasMoreProjects`). Same window params. Any member can read (`orgContext` is the whole gate, like `/orgs/{slug}/members`); an unknown slug is `404 ORG_NOT_FOUND`; an API key bound to another org is `403 ORG_ACCESS_DENIED`. No window means all time.

Requires authentication
slugrequiredstringpath
sincestringdate-timequery
untilstringdate-timequery
200The org rollup.
400Validation failed
401Missing or invalid authentication
403Insufficient permissions
404Resource not found

Response fields

dataobject

The §3.3 rollup org-wide (spec §3.6 D6) — every field of `LogStatBody` over the org's live projects, the same two frames on the same two clocks — plus a per-project summary table. `projects[]` is the SUMMARY shape, not nested rollups: each column is the same windowed measure the project's own `/log/stat` reports (`runs` = examined.runs, `issues` = found.issues, `fixed` = decided.completed, `regressions` = cameBack.detected — distinct issues a run re-detected, not reopens by decision). Ordered by last run in the window desc, then name; a project with no run in the window carries `lastRunAt: null` and sorts last. Capped at 100 rows — stated as a cap: `hasMoreProjects` says when it bit; the body still counts every project. `examined.definitions` is distinct across the org, not a sum. Served from a per-(org, window) TTL cache (`ORG_LOG_STAT_CACHE_TTL`, default 60 s; OQ5's org half measured ~630 ms server on prod, over the 500 ms trigger) — so a response can be up to that old, and `computedAt` says exactly how old. The project rollup is not cached.

GET/api/v1/orgs/{slug}/log/stat
curl -X GET "https://api.uluops.ai/api/v1/orgs/example-value/log/stat" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": "..."
}

Org-visible audit actions — every member can read (D19)

The subset of the org's audit log whose writer marked `details.visibility = "org"`. Membership is the floor: the full log stays admin+, this feed is what "everyone in the org can see" means. Today one event class is marked — a project moved out of this org into a **personal** org (`details.action = "project.rehome_out"`, `details.to_personal_org = true`), by either the member or the admin path. The row carries the destination slug and the actor. Reads walk the underlying `org.updated` rows in pages of 200 and keep the marked ones; the walk is bounded, so `hasMore: true` with a `nextCursor` can mean "keep paging", not "more marked rows were seen". Resume with `cursor`. Paging is by keyset `(created_at, id)` — `@uluops/platform` ≥ 1.28.4 — so `nextCursor` (`<iso>|<uuid>`) resumes exactly, including inside a second. A bare ISO date is accepted as `cursor` for compatibility but pages on `created_at` alone (second-precision, lossy at a boundary); round-trip `nextCursor` instead.

Requires authentication
slugrequiredstringpath
cursorstringdate-timequery
limitintegerquery
200Org-visible audit entries, newest first

Response fields

dataobject
countinteger
hasMoreboolean
nextCursorstringnullable
GET/api/v1/orgs/{slug}/audit-log/global
curl -X GET "https://api.uluops.ai/api/v1/orgs/example-value/audit-log/global" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "entries": []
  },
  "count": 0,
  "hasMore": true,
  "nextCursor": "..."
}