curl --request GET \
--url https://api.roark.ai/v1/metric/definitions/{idOrSlug} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"metricId": "<string>",
"variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"versionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"calculationType": "PROVIDER",
"type": "COUNT",
"scope": "GLOBAL",
"supportedContexts": [
"CALL"
],
"unit": {
"name": "<string>",
"symbol": "<string>"
},
"threshold": {
"sourceMetricDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"operator": "GREATER_THAN",
"thresholdValue": "<string>",
"aggregationMode": "EACH",
"countThreshold": 123,
"sourceParticipantRole": "AGENT",
"sourceVariantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"formula": {
"expression": "<string>",
"sources": [
{
"sourceMetricDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sourceVariantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
},
"pattern": {
"operation": "PATTERN_EXISTS",
"windowMode": "<string>",
"triggerCombinator": "AND",
"triggers": [
{
"sourceMetricDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"operator": "GREATER_THAN",
"thresholdValue": "<string>",
"sourceParticipantRole": "AGENT",
"sourceVariantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"outcome": {
"sourceMetricDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"operator": "GREATER_THAN",
"thresholdValue": "<string>",
"sourceParticipantRole": "AGENT",
"sourceVariantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"windowBefore": 123,
"windowAfter": 123
}
}
}
}Fetch a single metric definition by its UUID or its stable metricId slug (e.g. customer_satisfaction). Slug resolution is scoped to the project — a project-owned metric wins over an org-wide one, which wins over a system metric of the same slug.
curl --request GET \
--url https://api.roark.ai/v1/metric/definitions/{idOrSlug} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"metricId": "<string>",
"variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"versionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"calculationType": "PROVIDER",
"type": "COUNT",
"scope": "GLOBAL",
"supportedContexts": [
"CALL"
],
"unit": {
"name": "<string>",
"symbol": "<string>"
},
"threshold": {
"sourceMetricDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"operator": "GREATER_THAN",
"thresholdValue": "<string>",
"aggregationMode": "EACH",
"countThreshold": 123,
"sourceParticipantRole": "AGENT",
"sourceVariantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"formula": {
"expression": "<string>",
"sources": [
{
"sourceMetricDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sourceVariantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
},
"pattern": {
"operation": "PATTERN_EXISTS",
"windowMode": "<string>",
"triggerCombinator": "AND",
"triggers": [
{
"sourceMetricDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"operator": "GREATER_THAN",
"thresholdValue": "<string>",
"sourceParticipantRole": "AGENT",
"sourceVariantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"outcome": {
"sourceMetricDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"operator": "GREATER_THAN",
"thresholdValue": "<string>",
"sourceParticipantRole": "AGENT",
"sourceVariantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"windowBefore": 123,
"windowAfter": 123
}
}
}
}Documentation Index
Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
Use this file to discover all available pages before exploring further.