Organizations
18 endpoints
List user's organizations
Responses
Response fields
dataobject/api/v1/orgscurl -X GET "https://api.uluops.ai/api/v1/orgs" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"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
Request BodyCreateOrgRequest
namerequiredstringslugrequiredstring^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$Responses
Response fields
dataobject/api/v1/orgscurl -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"
}'{
"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
Parameters
slugrequiredstringpathResponses
Response fields
dataobject/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"{
"data": {
"available": true,
"reason": "taken"
}
}Accept an invitation
Parameters
tokenrequiredstringpathResponses
/api/v1/orgs/invitations/{token}/acceptcurl -X POST "https://api.uluops.ai/api/v1/orgs/invitations/reset-token-abc123/accept" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Get organization details
Parameters
slugrequiredstringpathResponses
Response fields
dataobject/api/v1/orgs/{slug}curl -X GET "https://api.uluops.ai/api/v1/orgs/example-value" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"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
Parameters
slugrequiredstringpathRequest BodyUpdateOrgRequest
namerequiredstringResponses
/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)
Parameters
slugrequiredstringpathResponses
/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
Parameters
slugrequiredstringpathResponses
/api/v1/orgs/{slug}/restorecurl -X POST "https://api.uluops.ai/api/v1/orgs/example-value/restore" \
-H "Authorization: Bearer $ULUOPS_TOKEN"List organization members
Parameters
slugrequiredstringpathResponses
Response fields
dataobjectcountinteger/api/v1/orgs/{slug}/memberscurl -X GET "https://api.uluops.ai/api/v1/orgs/example-value/members" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": {
"members": [
{
"id": "...",
"userId": "550e8400-e29b-41d4-a716-446655440000",
"role": "viewer",
"email": "...",
"name": "...",
"username": "..."
}
]
},
"count": 0
}Update member role (admin+)
Parameters
slugrequiredstringpathmembershipIdrequiredstringpathRequest BodyUpdateMemberRoleRequest
rolerequiredstringviewerpublisheradminResponses
/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+)
Parameters
slugrequiredstringpathmembershipIdrequiredstringpathResponses
/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+)
Parameters
slugrequiredstringpathstatusstringquerypendingacceptedexpiredrevokedResponses
Response fields
dataobjectcountinteger/api/v1/orgs/{slug}/invitationscurl -X GET "https://api.uluops.ai/api/v1/orgs/example-value/invitations" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"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+)
Parameters
slugrequiredstringpathRequest BodySendInvitationRequest
emailrequiredstringemailrolerequiredstringviewerpublisheradminResponses
Response fields
dataobject/api/v1/orgs/{slug}/invitationscurl -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"
}'{
"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+)
Parameters
slugrequiredstringpathinvitationIdrequiredstringpathResponses
/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)
Parameters
slugrequiredstringpathRequest BodyTransferAdministratorRequest
targetUserIdrequiredstringuuidResponses
/api/v1/orgs/{slug}/transfer-administratorcurl -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+)
Parameters
slugrequiredstringpathactionstringquerycursorstringdate-timequerylimitintegerqueryResponses
Response fields
dataobjectcountintegerhasMorebooleannextCursorstringnullable/api/v1/orgs/{slug}/audit-logcurl -X GET "https://api.uluops.ai/api/v1/orgs/example-value/audit-log" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"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.
Parameters
slugrequiredstringpathsincestringdate-timequeryuntilstringdate-timequeryResponses
Response fields
dataobjectThe §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.
/api/v1/orgs/{slug}/log/statcurl -X GET "https://api.uluops.ai/api/v1/orgs/example-value/log/stat" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"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.
Parameters
slugrequiredstringpathcursorstringdate-timequerylimitintegerqueryResponses
Response fields
dataobjectcountintegerhasMorebooleannextCursorstringnullable/api/v1/orgs/{slug}/audit-log/globalcurl -X GET "https://api.uluops.ai/api/v1/orgs/example-value/audit-log/global" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": {
"entries": []
},
"count": 0,
"hasMore": true,
"nextCursor": "..."
}