From 30b4a99b5dffb12705d9553cbfdca14e26e36ed9 Mon Sep 17 00:00:00 2001 From: Recoup CTO Agent Date: Tue, 14 Apr 2026 20:27:57 +0000 Subject: [PATCH] docs: add dsp parameter to content API and Slack bot docs (REC-63) Document the new dsp enum parameter for DSP logo overlay in both the OpenAPI spec and the Content Agent Slack bot documentation. - Add dsp field to ContentCreateRequest schema in OpenAPI - Add dsp parameter to @mention syntax table and examples - Update content-agent webhook description Co-Authored-By: Paperclip --- api-reference/openapi/content.json | 13 ++++++++++++- content-agent.mdx | 8 +++++++- 2 files changed, 19 insertions(+), 2 deletions(-) diff --git a/api-reference/openapi/content.json b/api-reference/openapi/content.json index 56cb517..9b51cac 100644 --- a/api-reference/openapi/content.json +++ b/api-reference/openapi/content.json @@ -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 ` [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 ` [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", @@ -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`.", diff --git a/content-agent.mdx b/content-agent.mdx index 4f78a55..746ca25 100644 --- a/content-agent.mdx +++ b/content-agent.mdx @@ -109,7 +109,7 @@ The **Recoup Content Agent** is a Slack bot that generates social-ready artist v ### @Mention Syntax ``` -@RecoupContentAgent [template] [batch=N] [lipsync] +@RecoupContentAgent [template] [batch=N] [lipsync] [dsp=spotify|apple] ``` | Parameter | Required | Description | @@ -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 @@ -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 +``` + ### Architecture | Component | Location | Purpose |