From 829693ba19d0e3e9e8bdd56c0c39643a6c817dd0 Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Sun, 5 Apr 2026 20:07:53 -0500 Subject: [PATCH 1/6] fix PR #102 review feedback MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Fix section count: "five" → "six" to match actual card count - Add missing research endpoints (track, instagram-posts) to LLM reference - Revert base URL to api.recoupable.com for consistency with authentication.mdx and openapi.json Co-Authored-By: Claude Opus 4.6 (1M context) --- index.mdx | 10 +++++----- quickstart.mdx | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/index.mdx b/index.mdx index 7d6fef4..f55d33e 100644 --- a/index.mdx +++ b/index.mdx @@ -18,7 +18,7 @@ This is where record labels, musicians, and managers start to build on Recoup AI All API requests should be made to: ```bash -https://recoup-api.vercel.app/api +https://api.recoupable.com/api ``` ## Authentication @@ -30,7 +30,7 @@ All API endpoints are authenticated using an API key passed in the `x-api-key` h 3. Create a new API key and copy it immediately (it's only shown once) ```bash -curl -X GET "https://recoup-api.vercel.app/api/artists?accountId=YOUR_ACCOUNT_ID" \ +curl -X GET "https://api.recoupable.com/api/artists?accountId=YOUR_ACCOUNT_ID" \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" ``` @@ -67,7 +67,7 @@ Keep your API key secure. Do not share it publicly or commit it to version contr ## API Sections -The API is organized into five main sections. Use these links to jump to the right area. +The API is organized into six main sections. Use these links to jump to the right area. ```bash cURL -curl -X GET "https://recoup-api.vercel.app/api/tasks" \ +curl -X GET "https://api.recoupable.com/api/tasks" \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" ``` @@ -51,14 +51,14 @@ headers = { } response = requests.get( - "https://recoup-api.vercel.app/api/tasks", + "https://api.recoupable.com/api/tasks", headers=headers ) print(response.json()) ``` ```javascript JavaScript -const response = await fetch("https://recoup-api.vercel.app/api/tasks", { +const response = await fetch("https://api.recoupable.com/api/tasks", { headers: { "Content-Type": "application/json", "x-api-key": "YOUR_API_KEY", @@ -84,7 +84,7 @@ interface TasksResponse { tasks: Task[]; } -const response = await fetch("https://recoup-api.vercel.app/api/tasks", { +const response = await fetch("https://api.recoupable.com/api/tasks", { headers: { "Content-Type": "application/json", "x-api-key": "YOUR_API_KEY", From 5a726d78a7566b59f17d3f567e3fd2ff650db32c Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Sun, 5 Apr 2026 20:09:45 -0500 Subject: [PATCH 2/6] use recoup-api.vercel.app as global base URL Update index, quickstart, and authentication pages to consistently use recoup-api.vercel.app as the canonical API base URL. Co-Authored-By: Claude Opus 4.6 (1M context) --- authentication.mdx | 4 ++-- index.mdx | 6 +++--- quickstart.mdx | 10 +++++----- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/authentication.mdx b/authentication.mdx index c3f5019..c25d42f 100644 --- a/authentication.mdx +++ b/authentication.mdx @@ -35,7 +35,7 @@ Copy your API key immediately — it is only shown once. Keys are stored as a se Pass your key in the `x-api-key` header: ```bash -curl -X GET "https://api.recoupable.com/api/tasks" \ +curl -X GET "https://recoup-api.vercel.app/api/tasks" \ -H "x-api-key: YOUR_API_KEY" ``` @@ -57,7 +57,7 @@ Org membership is determined by the account's [organizations](/api-reference/org If you're building a frontend application that authenticates users via [Privy](https://privy.io), you can pass the user's Privy JWT as a Bearer token instead of an API key. ```bash -curl -X GET "https://api.recoupable.com/api/tasks" \ +curl -X GET "https://recoup-api.vercel.app/api/tasks" \ -H "Authorization: Bearer YOUR_PRIVY_JWT" ``` diff --git a/index.mdx b/index.mdx index f55d33e..d790294 100644 --- a/index.mdx +++ b/index.mdx @@ -18,7 +18,7 @@ This is where record labels, musicians, and managers start to build on Recoup AI All API requests should be made to: ```bash -https://api.recoupable.com/api +https://recoup-api.vercel.app/api ``` ## Authentication @@ -30,7 +30,7 @@ All API endpoints are authenticated using an API key passed in the `x-api-key` h 3. Create a new API key and copy it immediately (it's only shown once) ```bash -curl -X GET "https://api.recoupable.com/api/artists?accountId=YOUR_ACCOUNT_ID" \ +curl -X GET "https://recoup-api.vercel.app/api/artists?accountId=YOUR_ACCOUNT_ID" \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" ``` @@ -152,7 +152,7 @@ If you are an LLM navigating these docs, here is a summary of the endpoint struc - **`/api/sandboxes/*`** — Sandboxes (list, create, snapshot, delete, setup, file, upload) - **`/api/content-agent/*`** — Content agent webhooks (webhook, callback) -Base URL: `https://api.recoupable.com/api` +Base URL: `https://recoup-api.vercel.app/api` [OpenAPI Specification](https://github.com/sweetmantech/docs/blob/main/api-reference/openapi.json) diff --git a/quickstart.mdx b/quickstart.mdx index cc7e37b..90ac94c 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -8,7 +8,7 @@ description: "Get your API key and make your first request to the Recoup API." All API requests should be made to: ```bash -https://api.recoupable.com/api +https://recoup-api.vercel.app/api ``` ## API Keys @@ -37,7 +37,7 @@ Once you have your API key, include it in the `x-api-key` header for all authent ```bash cURL -curl -X GET "https://api.recoupable.com/api/tasks" \ +curl -X GET "https://recoup-api.vercel.app/api/tasks" \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" ``` @@ -51,14 +51,14 @@ headers = { } response = requests.get( - "https://api.recoupable.com/api/tasks", + "https://recoup-api.vercel.app/api/tasks", headers=headers ) print(response.json()) ``` ```javascript JavaScript -const response = await fetch("https://api.recoupable.com/api/tasks", { +const response = await fetch("https://recoup-api.vercel.app/api/tasks", { headers: { "Content-Type": "application/json", "x-api-key": "YOUR_API_KEY", @@ -84,7 +84,7 @@ interface TasksResponse { tasks: Task[]; } -const response = await fetch("https://api.recoupable.com/api/tasks", { +const response = await fetch("https://recoup-api.vercel.app/api/tasks", { headers: { "Content-Type": "application/json", "x-api-key": "YOUR_API_KEY", From dcd7d25cdb10674a39a31efa56d24987141d1154 Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Sun, 5 Apr 2026 20:12:04 -0500 Subject: [PATCH 3/6] address sweetmantech review comments from PR #102 - Update intro text to highlight content generation and catalogs - KISS: remove "AI-powered" from Chat card description - KISS: remove "AI" from Content Agent card description - Move /api/artists/* to first in LLM quick reference Co-Authored-By: Claude Opus 4.6 (1M context) --- index.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/index.mdx b/index.mdx index d790294..4771ac0 100644 --- a/index.mdx +++ b/index.mdx @@ -5,7 +5,7 @@ description: "Use the Recoup API to build your record label. Access research, co # Welcome to the Recoup API -Use the Recoup API to build your record label. Access artist analytics, fan segmentation, AI-powered chat, content creation, and task automation to power your music business. +Use the Recoup API to build your record label. Generate content, Access artist analytics, Manage your catalogs, AI-powered chat, and task automation to power your music business. ## What is Recoup? @@ -89,7 +89,7 @@ The API is organized into six main sections. Use these links to jump to the righ icon="comments" href="/api-reference/chat/chats" > - AI-powered conversations with artist context. Create, stream, and generate messages. Copy messages, delete trailing messages, and manage chat history. + Conversations with artist context. Create, stream, and generate messages. Copy messages, delete trailing messages, and manage chat history. - AI content creation agent accessible via Slack. Generates images, videos, and captions for artists automatically. + Content creation agent accessible via Slack. Generates images, videos, and captions for artists automatically. Date: Sun, 5 Apr 2026 20:13:18 -0500 Subject: [PATCH 4/6] make Content Creation first group in Content tab Co-Authored-By: Claude Opus 4.6 (1M context) --- docs.json | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs.json b/docs.json index 119390f..7fa83a6 100644 --- a/docs.json +++ b/docs.json @@ -139,14 +139,6 @@ { "tab": "Content", "groups": [ - { - "group": "Posts & Comments", - "pages": [ - "api-reference/posts/get", - "api-reference/post/comments", - "api-reference/comments/get" - ] - }, { "group": "Content Creation", "pages": [ @@ -163,6 +155,14 @@ "api-reference/content/estimate" ] }, + { + "group": "Posts & Comments", + "pages": [ + "api-reference/posts/get", + "api-reference/post/comments", + "api-reference/comments/get" + ] + }, { "group": "Content Agent", "pages": [ From 38c66714531bf7c8ee9923ed8ce34a5dd0776156 Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Sun, 5 Apr 2026 20:16:47 -0500 Subject: [PATCH 5/6] KISS: simplify intro text per review feedback Co-Authored-By: Claude Opus 4.6 (1M context) --- index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.mdx b/index.mdx index 4771ac0..8290ccb 100644 --- a/index.mdx +++ b/index.mdx @@ -5,7 +5,7 @@ description: "Use the Recoup API to build your record label. Access research, co # Welcome to the Recoup API -Use the Recoup API to build your record label. Generate content, Access artist analytics, Manage your catalogs, AI-powered chat, and task automation to power your music business. +Use the Recoup API to build your record label. Generate content, Access artist analytics, Manage catalogs, Team chats, and task automation to power your record labels. ## What is Recoup? From 200c2e83b0291065ef8fe5b059fc7197e8d1f4bb Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Sun, 5 Apr 2026 20:18:39 -0500 Subject: [PATCH 6/6] update artists list endpoint description Co-Authored-By: Claude Opus 4.6 (1M context) --- api-reference/openapi.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/openapi.json b/api-reference/openapi.json index 2393a65..ac64a21 100644 --- a/api-reference/openapi.json +++ b/api-reference/openapi.json @@ -455,7 +455,7 @@ }, "/api/artists": { "get": { - "description": "Retrieve artists accessible to the authenticated account. The account is derived from the API key or Bearer token. When org_id is omitted, returns only the account's own artists. Pass org_id to view artists in a specific organization. Pass account_id to filter to a specific account the API key has access to.", + "description": "Retrieve artists. Artists can have socials. Artists can create songs and content.", "parameters": [ { "name": "account_id",