Skip to content

docs: add video stats to content/slack endpoint #82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sweetmantech merged 1 commit into from
Mar 26, 2026
Merged

docs: add video stats to content/slack endpoint #82

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions api-reference/openapi.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4300,7 +4300,7 @@
},
"/api/admins/content/slack": {
"get": {
"description": "Returns a list of Slack mentions of the Recoup Content Agent bot, pulled directly from the Slack API as the source of truth. Each entry includes the tagger's information, the prompt they sent, the timestamp, the channel, and any video link responses. Supports optional time-period filtering. Requires the authenticated account to be a Recoup admin. Authentication via x-api-key or Authorization Bearer token.",
"description": "Returns a list of Slack mentions of the Recoup Content Agent bot, pulled directly from the Slack API as the source of truth. Each entry includes the tagger's information, the prompt they sent, the timestamp, the channel, and any video link responses. Also returns aggregate video statistics for measuring tag-to-video conversion. Supports optional time-period filtering. Requires the authenticated account to be a Recoup admin. Authentication via x-api-key or Authorization Bearer token.",
"parameters": [
{
"name": "period",
Expand All @@ -4325,7 +4325,7 @@
"application/json": {
"schema": {
"type": "object",
"required": ["status", "total", "tags"],
"required": ["status", "total", "total_videos", "tags_with_videos", "tags"],
"properties": {
"status": {
"type": "string",
Expand All @@ -4337,6 +4337,16 @@
"description": "Total number of times the Content Agent was tagged in the requested period",
"example": 18
},
"total_videos": {
"type": "integer",
"description": "Total number of videos generated by the Content Agent across all tags in the requested period",
"example": 12
},
"tags_with_videos": {
"type": "integer",
"description": "Number of tags that resulted in at least one video being generated",
"example": 10
},
"tags": {
"type": "array",
"description": "List of Slack tag events",
Expand Down