UluOps Registry API

REST API for managing definitions, versions, models, and the definition lifecycle.

Base URL

https://api.uluops.ai/api/v1

The API supports two authentication methods:

Method	Details
API Keys	Prefixed with `ulr_`, created via the Platform API
Session Tokens	Obtained via `POST /auth/login` on the Platform API

Both are passed in the Authorization header as Bearer {token}.

Read-only endpoints use optional authentication — unauthenticated requests see only public definitions.

All successful responses wrap data in a data envelope:

json

{
  "data": {
    "name": "code-validator",
    "type": "agent",
    "version": "1.0.0"
  }
}

Errors return a consistent format:

json

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Definition not found: agent/example"
  }
}

Definition CRUD and lifecycle operations

Version history and comparison

Definition YAML validation without storage

Model catalog operations

Definition rendering to markdown

Definition starring operations

Definition languages and current JSON schemas

Public user lookup endpoints

Definition effectiveness, health, and ecosystem analytics

Organization management and profiles