Skip to content

docs: add dsp parameter to content API and Slack bot docs (REC-63) #131

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

Open
recoup-coding-agent wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: add dsp parameter to content API and Slack bot docs (REC-63) #131

Show file tree
Hide file tree
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
13 changes: 12 additions & 1 deletion api-reference/openapi/content.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -921,7 +921,7 @@
},
"/api/content-agent/{platform}": {
"post": {
"description": "Webhook endpoint for the Recoup Content Agent Slack bot. Receives @mention events from Slack and triggers content generation for the mentioned artist. The bot parses the mention text for `<artist_account_id> [template] [batch=N] [lipsync]`, validates the artist, calls POST /api/content/create, and starts a background polling task that reports results back to the Slack thread.\n\nFor Slack, also handles `url_verification` challenges during app setup.",
"description": "Webhook endpoint for the Recoup Content Agent Slack bot. Receives @mention events from Slack and triggers content generation for the mentioned artist. The bot parses the mention text for `<artist_account_id> [template] [batch=N] [lipsync] [dsp=spotify|apple]`, validates the artist, calls POST /api/content/create, and starts a background polling task that reports results back to the Slack thread.\n\nFor Slack, also handles `url_verification` challenges during app setup.",
"parameters": [
{
"name": "platform",
Expand Down Expand Up @@ -2441,6 +2441,17 @@
"default": "none",
"example": "none"
},
"dsp": {
"type": "string",
"enum": [
"none",
"spotify",
"apple"
],
"description": "Which DSP (digital streaming platform) logo to overlay on the output video. `none` (default) omits the logo. `spotify` overlays the Spotify logo. `apple` overlays the Apple Music logo.",
"default": "none",
"example": "spotify"
},
"upscale": {
"type": "boolean",
"description": "Whether to upscale the generated image and video for higher resolution and detail. Adds approximately 2 minutes to the pipeline. Defaults to `false`.",
Expand Down
8 changes: 7 additions & 1 deletion content-agent.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ The **Recoup Content Agent** is a Slack bot that generates social-ready artist v
### @Mention Syntax

```
@RecoupContentAgent <artist_account_id> [template] [batch=N] [lipsync]
@RecoupContentAgent <artist_account_id> [template] [batch=N] [lipsync] [dsp=spotify|apple]
```

| Parameter | Required | Description |
Expand All @@ -118,6 +118,7 @@ The **Recoup Content Agent** is a Slack bot that generates social-ready artist v
| `template` | No | Content template name. Optional — when omitted, the pipeline runs with default settings. See [GET /api/content/templates](/api-reference/content/templates) for options. |
| `batch=N` | No | Number of videos to generate (1-30, default 1) |
| `lipsync` | No | Enable lipsync mode (audio baked into video) |
| `dsp` | No | DSP logo to overlay on the video: `spotify` or `apple`. Omit for no DSP logo. |

### Examples

Expand All @@ -136,6 +137,11 @@ The **Recoup Content Agent** is a Slack bot that generates social-ready artist v
@RecoupContentAgent abc-123-uuid batch=3 lipsync
```

**Editorial with Spotify DSP logo:**
```
@RecoupContentAgent abc-123-uuid artist-release-editorial for Spotify
Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai Bot Apr 14, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: The new DSP example uses for Spotify instead of the documented dsp=... parameter format.

Prompt for AI agents 
Check if this issue is valid — if so, understand the root cause and fix it. At content-agent.mdx, line 142:

<comment>The new DSP example uses `for Spotify` instead of the documented `dsp=...` parameter format.</comment>

<file context>
@@ -136,6 +137,11 @@ The **Recoup Content Agent** is a Slack bot that generates social-ready artist v
 
+**Editorial with Spotify DSP logo:**
+```
+@RecoupContentAgent abc-123-uuid artist-release-editorial for Spotify
+```
+
</file context>
Suggested change
@RecoupContentAgent abc-123-uuid artist-release-editorial for Spotify
@RecoupContentAgent abc-123-uuid artist-release-editorial dsp=spotify
Fix with Cubic

```

### Architecture

| Component | Location | Purpose |
Expand Down