Analytics

Definition effectiveness, health, and ecosystem analytics

8 endpoints

Ecosystem overview

Returns aggregate ecosystem metrics including definition counts, activity trends, and health distribution. Pro tier when tier gating enabled.

Requires authentication

Responses

200Ecosystem overview metrics

403Subscription tier required

Response fields

dataobject

Aggregate ecosystem metrics

GET/api/v1/analytics/ecosystem/overview

curl -X GET "https://api.uluops.ai/api/v1/analytics/ecosystem/overview" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"

Response

{
  "data": "..."
}

Definition effectiveness metrics

Returns pass rate, average score, issue yield, and resolution metrics for a definition. Free tier for basic metrics.

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name (lowercase alphanumeric with hyphens)

versionstringquery

Specific version to query (defaults to latest)

Default: latest

periodstringquery

Time period for metrics aggregation

Default: 30d

Responses

200Effectiveness metrics

400Invalid request parameters

422Insufficient data to compute metrics

Response fields

dataobject

Effectiveness metrics including pass rate, average score, issue yield

GET/api/v1/analytics/definitions/{type}/{name}/effectiveness

curl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/agent/my-project/effectiveness"

Response

{
  "data": "..."
}

Definition health score

Returns computed health score and contributing factors for a definition. Pro tier required.

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name (lowercase alphanumeric with hyphens)

versionstringquery

Specific version to query

Responses

200Health score and contributing factors

400Invalid request parameters

403Subscription tier required

422Insufficient data to compute health score

Response fields

dataobject

Health score and factor breakdown

GET/api/v1/analytics/definitions/{type}/{name}/health

curl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/agent/my-project/health"

Response

{
  "data": "..."
}

Definition version lineage

Returns version history with analytics per version for a definition. Pro tier required.

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name (lowercase alphanumeric with hyphens)

Responses

200Version lineage with per-version analytics

400Invalid request parameters

403Subscription tier required

422Insufficient data to compute lineage analytics

Response fields

dataobject

Version history with analytics per version

GET/api/v1/analytics/definitions/{type}/{name}/lineage

curl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/agent/my-project/lineage"

Response

{
  "data": "..."
}

Definition evolution metrics

Returns how definition metrics have changed over time. Pro tier required.

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name (lowercase alphanumeric with hyphens)

Responses

200Evolution metrics over time

400Invalid request parameters

403Subscription tier required

422Insufficient data to compute evolution metrics

Response fields

dataobject

Time-series metrics showing definition evolution

GET/api/v1/analytics/definitions/{type}/{name}/evolution

curl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/agent/my-project/evolution"

Response

{
  "data": "..."
}

Translation analytics

Returns translation pipeline metrics including version changes and rendering statistics. Pro tier required.

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name (lowercase alphanumeric with hyphens)

Responses

200Translation pipeline metrics

400Invalid request parameters

403Subscription tier required

422Insufficient data to compute translation analytics

Response fields

dataobject

Translation version changes and rendering stats

GET/api/v1/analytics/definitions/{type}/{name}/translation

curl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/agent/my-project/translation"

Response

{
  "data": "..."
}

Compare effectiveness across versions

Returns side-by-side effectiveness metrics for 2-5 versions of a definition. Pro tier required.

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name (lowercase alphanumeric with hyphens)

versionsrequiredstringquery

Comma-separated list of 2-5 versions to compare

Responses

200Side-by-side effectiveness comparison

400Invalid versions count (must be 2-5)

403Subscription tier required

422Insufficient data to compute comparison

Response fields

dataobject

Per-version effectiveness metrics for comparison

GET/api/v1/analytics/definitions/{type}/{name}/effectiveness/compare

curl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/agent/my-project/effectiveness/compare?versions=example-value"

Response

{
  "data": "..."
}

Version diff impact analysis

Returns how a version change impacted effectiveness metrics. Pro tier required.

Parameters

typerequiredstringpath

Definition type

agentcommandworkflowpipeline

namerequiredstringpath

Definition name (lowercase alphanumeric with hyphens)

fromVersionrequiredstringpath

Source version for diff

toVersionrequiredstringpath

Target version for diff

Responses

200Diff impact analysis

400Invalid request parameters

403Subscription tier required

422Insufficient data to compute impact analysis

Response fields

dataobject

Impact analysis of version change on effectiveness

GET/api/v1/analytics/definitions/{type}/{name}/diff/{fromVersion}/{toVersion}/impact

curl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/agent/my-project/diff/example-value/example-value/impact"

Response

{
  "data": "..."
}