SOM activity
See what your organization's SOM bus has done: the messages it delivered, the skill runs, each story's progress and a 24-hour summary.
x-api-key<token>A service key (nvs_...) in the x-api-key header. A service key belongs to one organization: an X-Org-Id header is optional and, when sent, must name that organization. This header also accepts any credential the bearer scheme does, and when a request sends both headers, this one is used.
limit?integerMaximum items per page (1–100, default 25)
1 <= value <= 10025cursor?stringOpaque cursor from a prior nextCursor
status?stringRestrict the page to rows with this status
"received""skipped_unknown""skipped_echo""error"A page of som_inbox rows, newest-received first
application/json- response
items*array<>pagination*sort*filters*facets?Value/count breakdown for each field requested via ?facets=. Present only when facets were requested.
included?curl -X GET 'https://api.nuvelics.com/api/tenant/v1/som-activity/inbox'{ "items": [ { "messageId": "string", "topic": "string", "messageType": "string", "status": "received", "errorDetail": "string", "receivedAt": "2019-08-24T14:15:22Z", "storyId": "string" } ], "pagination": { "nextCursor": "string" }, "sort": { "applied": "string", "default": "string", "available": [ "string" ] }, "filters": { "applied": { "property1": null, "property2": null }, "available": [ { "field": "string", "kind": "string", "facetable": true } ] }, "facets": { "property1": { "values": [ { "value": "string", "count": 0 } ], "capped": true }, "property2": { "values": [ { "value": "string", "count": 0 } ], "capped": true } }, "included": { "datasources": { "property1": { "id": "string", "name": "string", "type": "string", "vendor": "datafactory", "iconId": "string" }, "property2": { "id": "string", "name": "string", "type": "string", "vendor": "datafactory", "iconId": "string" } }, "credentials": { "property1": { "id": "string", "name": "string", "schemeType": "string" }, "property2": { "id": "string", "name": "string", "schemeType": "string" } }, "users": { "property1": { "id": "string", "name": "string", "email": "string" }, "property2": { "id": "string", "name": "string", "email": "string" } }, "articlePitches": { "property1": [ { "id": "string", "title": "string", "status": "string", "newsdeskId": "string" } ], "property2": [ { "id": "string", "title": "string", "status": "string", "newsdeskId": "string" } ] } }}x-api-key<token>A service key (nvs_...) in the x-api-key header. A service key belongs to one organization: an X-Org-Id header is optional and, when sent, must name that organization. This header also accepts any credential the bearer scheme does, and when a request sends both headers, this one is used.
limit?integerMaximum items per page (1–100, default 25)
1 <= value <= 10025cursor?stringOpaque cursor from a prior nextCursor
status?stringRestrict the page to rows with this status
"pending_publish""completed""failed"A page of som_skill_runs rows, newest-started first
application/json- response
items*array<>pagination*sort*filters*facets?Value/count breakdown for each field requested via ?facets=. Present only when facets were requested.
included?curl -X GET 'https://api.nuvelics.com/api/tenant/v1/som-activity/skill-runs'{ "items": [ { "messageId": "string", "skillId": "string", "skillVersion": "string", "storyId": "string", "status": "pending_publish", "attempts": 0, "lastError": "string", "startedAt": "2019-08-24T14:15:22Z", "executedAt": "2019-08-24T14:15:22Z", "publishedAt": "2019-08-24T14:15:22Z", "summary": { "claimsEvaluated": 0, "warningsRaised": 0, "assessment": "confirmed", "model": "string", "promptVersion": "string" } } ], "pagination": { "nextCursor": "string" }, "sort": { "applied": "string", "default": "string", "available": [ "string" ] }, "filters": { "applied": { "property1": null, "property2": null }, "available": [ { "field": "string", "kind": "string", "facetable": true } ] }, "facets": { "property1": { "values": [ { "value": "string", "count": 0 } ], "capped": true }, "property2": { "values": [ { "value": "string", "count": 0 } ], "capped": true } }, "included": { "datasources": { "property1": { "id": "string", "name": "string", "type": "string", "vendor": "datafactory", "iconId": "string" }, "property2": { "id": "string", "name": "string", "type": "string", "vendor": "datafactory", "iconId": "string" } }, "credentials": { "property1": { "id": "string", "name": "string", "schemeType": "string" }, "property2": { "id": "string", "name": "string", "schemeType": "string" } }, "users": { "property1": { "id": "string", "name": "string", "email": "string" }, "property2": { "id": "string", "name": "string", "email": "string" } }, "articlePitches": { "property1": [ { "id": "string", "title": "string", "status": "string", "newsdeskId": "string" } ], "property2": [ { "id": "string", "title": "string", "status": "string", "newsdeskId": "string" } ] } }}x-api-key<token>A service key (nvs_...) in the x-api-key header. A service key belongs to one organization: an X-Org-Id header is optional and, when sent, must name that organization. This header also accepts any credential the bearer scheme does, and when a request sends both headers, this one is used.
limit?integerMaximum items per page (1–100, default 25)
1 <= value <= 10025cursor?stringOpaque cursor from a prior nextCursor
lifecyclePhase?stringRestrict the page to rows with this lifecycle phase
"DEVELOPING""READY_TO_AIR""BREAKING""PUBLISHED"state?stringRestrict the page to open stories (PLANNED, ACTIVE, ORPHAN) or closed ones (KILLED, SPIKED, ARCHIVED); absent lists both
"open""closed"A page of som_bus_stories rollup rows, most-recently-received first
application/json- response
items*array<>pagination*sort*filters*facets?Value/count breakdown for each field requested via ?facets=. Present only when facets were requested.
included?curl -X GET 'https://api.nuvelics.com/api/tenant/v1/som-activity/stories'{ "items": [ { "storyId": "string", "slug": "string", "headline": "string", "storyType": "PLANNED", "version": 0, "lifecyclePhase": "DEVELOPING", "priority": "ROUTINE", "assetsCount": 0, "newsroomId": "string", "correlationId": "string", "storyUpdatedAt": "2019-08-24T14:15:22Z", "snapshotCount": 0, "firstReceivedAt": "2019-08-24T14:15:22Z", "lastReceivedAt": "2019-08-24T14:15:22Z", "lastMessageId": "string", "latestRun": { "skillId": "string", "status": "pending_publish", "startedAt": "2019-08-24T14:15:22Z", "executedAt": "2019-08-24T14:15:22Z", "publishedAt": "2019-08-24T14:15:22Z", "summary": { "claimsEvaluated": 0, "warningsRaised": 0, "assessment": "confirmed", "model": "string", "promptVersion": "string" } }, "runCounts": { "pending_publish": 0, "completed": 0, "failed": 0, "published": 0 } } ], "pagination": { "nextCursor": "string" }, "sort": { "applied": "string", "default": "string", "available": [ "string" ] }, "filters": { "applied": { "property1": null, "property2": null }, "available": [ { "field": "string", "kind": "string", "facetable": true } ] }, "facets": { "property1": { "values": [ { "value": "string", "count": 0 } ], "capped": true }, "property2": { "values": [ { "value": "string", "count": 0 } ], "capped": true } }, "included": { "datasources": { "property1": { "id": "string", "name": "string", "type": "string", "vendor": "datafactory", "iconId": "string" }, "property2": { "id": "string", "name": "string", "type": "string", "vendor": "datafactory", "iconId": "string" } }, "credentials": { "property1": { "id": "string", "name": "string", "schemeType": "string" }, "property2": { "id": "string", "name": "string", "schemeType": "string" } }, "users": { "property1": { "id": "string", "name": "string", "email": "string" }, "property2": { "id": "string", "name": "string", "email": "string" } }, "articlePitches": { "property1": [ { "id": "string", "title": "string", "status": "string", "newsdeskId": "string" } ], "property2": [ { "id": "string", "title": "string", "status": "string", "newsdeskId": "string" } ] } }}x-api-key<token>A service key (nvs_...) in the x-api-key header. A service key belongs to one organization: an X-Org-Id header is optional and, when sent, must name that organization. This header also accepts any credential the bearer scheme does, and when a request sends both headers, this one is used.
storyId*string1 <= lengthlimit?integerMaximum items per page (1–100, default 25)
1 <= value <= 10025cursor?stringOpaque cursor from a prior nextCursor
The story's rollup row plus one page of its snapshot cycles, newest snapshot first
application/json- response
story*cycles*array<>This page's snapshot cycles, most recently received first. Runs within a cycle are ordered oldest first: the page is a feed of arrivals, while a single cycle is the causal sequence of one arrival.
pagination*curl -X GET 'https://api.nuvelics.com/api/tenant/v1/som-activity/stories/string'{ "story": { "storyId": "string", "slug": "string", "headline": "string", "storyType": "PLANNED", "version": 0, "lifecyclePhase": "DEVELOPING", "priority": "ROUTINE", "assetsCount": 0, "newsroomId": "string", "correlationId": "string", "storyUpdatedAt": "2019-08-24T14:15:22Z", "snapshotCount": 0, "firstReceivedAt": "2019-08-24T14:15:22Z", "lastReceivedAt": "2019-08-24T14:15:22Z", "lastMessageId": "string", "latestRun": { "skillId": "string", "status": "pending_publish", "startedAt": "2019-08-24T14:15:22Z", "executedAt": "2019-08-24T14:15:22Z", "publishedAt": "2019-08-24T14:15:22Z", "summary": { "claimsEvaluated": 0, "warningsRaised": 0, "assessment": "confirmed", "model": "string", "promptVersion": "string" } }, "runCounts": { "pending_publish": 0, "completed": 0, "failed": 0, "published": 0 } }, "cycles": [ { "snapshot": { "messageId": "string", "topic": "string", "messageType": "string", "status": "received", "errorDetail": "string", "receivedAt": "2019-08-24T14:15:22Z", "storyId": "string" }, "runs": [ { "messageId": "string", "skillId": "string", "skillVersion": "string", "storyId": "string", "status": "pending_publish", "attempts": 0, "lastError": "string", "startedAt": "2019-08-24T14:15:22Z", "executedAt": "2019-08-24T14:15:22Z", "publishedAt": "2019-08-24T14:15:22Z", "summary": { "claimsEvaluated": 0, "warningsRaised": 0, "assessment": "confirmed", "model": "string", "promptVersion": "string" }, "instanceId": "string", "result": { "claims": [ { "claim": "string", "status": "confirmed", "note": "string", "sourceIds": [ "string" ], "assertions": [ { "sourceId": "string", "value": "string", "quote": "string" } ] } ], "factCheck": { "assessment": "confirmed", "summary": "string" }, "sources": [ { "sourceId": "string", "origin": "snapshot", "provider": "string", "sourceType": "string", "credibility": "string", "uri": "string", "title": "string", "publishedAt": "2019-08-24" } ] } } ] } ], "pagination": { "nextCursor": "string" }}x-api-key<token>A service key (nvs_...) in the x-api-key header. A service key belongs to one organization: an X-Org-Id header is optional and, when sent, must name that organization. This header also accepts any credential the bearer scheme does, and when a request sends both headers, this one is used.
The org's 24-hour SOM bus activity funnel: inbox, skill runs, and publish
application/json- response
inboxCounts*Count of som_inbox rows received in the last 24 hours, by status
skillRunCounts*Count of som_skill_runs rows started in the last 24 hours, by status
publishedCount*integerRuns whose published_at fell in the last 24 hours
0 <= valueoldestPendingPublishAgeSeconds*numberAge in seconds of the oldest run still pending_publish, or null when nothing is pending
0 <= valuecurl -X GET 'https://api.nuvelics.com/api/tenant/v1/som-activity/summary'{ "inboxCounts": { "received": 0, "skipped_unknown": 0, "skipped_echo": 0, "error": 0 }, "skillRunCounts": { "pending_publish": 0, "completed": 0, "failed": 0 }, "publishedCount": 0, "oldestPendingPublishAgeSeconds": 0}