Stars

Definition starring operations

3 endpoints

Check star status

Check if the authenticated user has starred a definition.

Requires authentication

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name with version (name@version format)

Responses

200Star status

401Authentication required

404Resource not found

Response fields

dataobject

GET/api/v1/definitions/{type}/{name}/star/status

curl -X GET "https://api.uluops.ai/api/v1/definitions/agent/my-project/star/status" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"

Response

{
  "data": {
    "starred": true,
    "starredAt": "2026-01-15T10:30:00Z"
  }
}

Star a definition

Star a definition. Idempotent — no-op if already starred.

Requires authentication

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name with version (name@version format)

Responses

200Definition starred (or already starred)

401Authentication required

404Resource not found

Response fields

dataobject

POST/api/v1/definitions/{type}/{name}/star

curl -X POST "https://api.uluops.ai/api/v1/definitions/agent/my-project/star" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"

Response

{
  "data": {
    "starred": true,
    "starCount": 0
  }
}

Unstar a definition

Remove a star from a definition. Idempotent — no-op if not starred.

Requires authentication

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name with version (name@version format)

Responses

200Definition unstarred (or was not starred)

401Authentication required

404Resource not found

Response fields

dataobject

DELETE/api/v1/definitions/{type}/{name}/star

curl -X DELETE "https://api.uluops.ai/api/v1/definitions/agent/my-project/star" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"

Response

{
  "data": {
    "starred": true,
    "starCount": 0
  }
}