# Recoup ## Docs - [Agents](https://developers.recoupable.com/agents.md): Programmatic agent onboarding — sign up and obtain API keys in one call, no dashboard, no human in the loop. - [Add Artist to Account](https://developers.recoupable.com/api-reference/accounts/add-artist.md): Add an artist to an account's list of associated artists. If the artist is already associated with the account, returns success without modification. - [Create Account](https://developers.recoupable.com/api-reference/accounts/create.md): Create a new account or retrieve an existing account by email or wallet address. If an account with the provided email or wallet already exists, returns that account. Otherwise creates a new account and initializes credits. - [Get Account](https://developers.recoupable.com/api-reference/accounts/get.md): Retrieve detailed account information by ID. Returns the account with associated profile info, emails, and wallet addresses. - [Get Account ID](https://developers.recoupable.com/api-reference/accounts/id.md): Retrieve the ID of the authenticated account associated with the provided credentials. This is useful when you have an API key or access token but do not yet know the corresponding accountId. - [Update Account](https://developers.recoupable.com/api-reference/accounts/update.md): Update an existing account's profile information including name, organization, image, instruction, job title, role type, company name, and knowledges. Requires authentication via x-api-key or Authorization Bearer token. The authenticated account may update itself or a permitted account_id override. - [List Agent Sign-Ups (Admin)](https://developers.recoupable.com/api-reference/admins/agent-signups.md): Returns API key sign-up records created by AI agents. Agent sign-ups are identified by the agent+ email prefix in the associated account email. Supports period filtering and returns individual API key records with their associated email and creation timestamp, suitable for building sign-up trend cha… - [List Pro Artists (Admin)](https://developers.recoupable.com/api-reference/admins/artists-pro.md): Retrieve the deduplicated list of artist IDs owned by pro accounts. An account is "pro" when its email belongs to an enterprise domain or it has an active Stripe subscription. Admin-scoped: requires an admin-flagged API key because the response identifies paying customer accounts. - [Check Admin Status](https://developers.recoupable.com/api-reference/admins/check.md): Check if the authenticated account is a Recoup admin. An account is considered an admin if it is a member of the Recoup organization. No input parameters required — authentication is performed via the x-api-key or Authorization header. - [List Coding Agent Slack Tags (Admin)](https://developers.recoupable.com/api-reference/admins/coding-agent-slack-tags.md): Returns a list of Slack mentions of the Recoup Coding 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 GitHub pull request URLs opened in response. Also returns aggregate pull… - [Get Coding Agent PR Merged Status (Admin)](https://developers.recoupable.com/api-reference/admins/coding-pr.md): Returns the status (open, closed, or merged) for each provided GitHub pull request URL. Accepts one or more `pull_requests` query parameters containing GitHub PR URLs. Uses the GitHub REST API to check each pull request's state. Requires the authenticated account to be a Recoup admin. Authentication… - [List Content Agent Slack Tags (Admin)](https://developers.recoupable.com/api-reference/admins/content-slack-tags.md): 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 measu… - [List Account Emails (Admin)](https://developers.recoupable.com/api-reference/admins/emails.md): Returns Resend emails including HTML content. Provide either account_id (returns all emails for an account) or email_id (returns a single email by Resend ID). Requires the authenticated account to be a Recoup admin. Authentication via x-api-key or Authorization Bearer token. Email response shape mat… - [List Privy Logins (Admin)](https://developers.recoupable.com/api-reference/admins/privy.md): Returns Privy login statistics for a given time period. Results include counts for new accounts (created_at), active accounts (latest_verified_at), total Privy accounts across all time, and the full, unmodified Privy account objects. See [Privy User object documentation](https://docs.privy.io/api-re… - [List Account Sandboxes (Admin)](https://developers.recoupable.com/api-reference/admins/sandboxes.md): Returns a list of all accounts and their sandbox usage statistics. Each item includes the account email, total number of sandboxes created, and the timestamp of the most recently created sandbox. Requires the authenticated account to be a Recoup admin. Authentication via x-api-key or Authorization B… - [List Org Repo Stats (Admin)](https://developers.recoupable.com/api-reference/admins/sandboxes-orgs.md): Returns commit statistics for each repository in the recoupable GitHub organization. Each item includes the repo name, URL, total commit count, latest 5 commit messages, earliest and latest commit timestamps, and the list of account repo URLs that include this org repo as a submodule. Requires the a… - [Agent Signup](https://developers.recoupable.com/api-reference/agents/signup.md): Register an agent. For new agent+ emails, returns an API key immediately. For all other cases, sends a verification code to the email — call [POST /api/agents/verify](/api-reference/agents/verify) with the code to get your API key. - [Verify Agent Email](https://developers.recoupable.com/api-reference/agents/verify.md): Verify an agent's email with the code sent during signup. Returns an API key on success. - [Scraper Results](https://developers.recoupable.com/api-reference/apify/scraper.md): Check the status and retrieve results from Apify scraper runs. This endpoint uses the Apify API Client to fetch the current status of a scraper run and its results if available. Use the runId returned from endpoints like Instagram Comments, Instagram Profiles, Social Scrape, or Artist Socials Scrape… - [Get Artist Profile](https://developers.recoupable.com/api-reference/artist/profile.md): Retrieve comprehensive profile information for an artist across all connected social media platforms, including profile details and post metrics. - [Socials scrape](https://developers.recoupable.com/api-reference/artist/socials-scrape.md): Trigger scrape jobs for all social profiles linked to an artist. Provide an artist_account_id, and the API will look up the artist's socials and invoke a scraping job for each social profile. Each scrape returns Apify run metadata so you can poll for status and retrieve results. - [Create Artist](https://developers.recoupable.com/api-reference/artists/create.md): Create a new artist account. The artist can optionally be linked to an organization. - [Delete Artist](https://developers.recoupable.com/api-reference/artists/delete.md): Delete an artist accessible to the authenticated account. - [Get Artists](https://developers.recoupable.com/api-reference/artists/list.md): 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 a… - [Pin Artist](https://developers.recoupable.com/api-reference/artists/pin.md): Pin an artist. This updates the caller's pinned preference for the artist. - [Get Artist Socials](https://developers.recoupable.com/api-reference/artists/socials.md): Retrieve all social media profiles associated with an artist. This endpoint should be called before using the Social Posts endpoint to obtain the necessary social IDs. - [Unpin Artist](https://developers.recoupable.com/api-reference/artists/unpin.md): Unpin an artist. This updates the caller's pinned preference for the artist. - [Update Artist](https://developers.recoupable.com/api-reference/artists/update.md): Update an artist. All body fields are optional, but at least one must be provided. Use this endpoint to set basic profile (name, image, label), AI instructions, knowledge base entries, social profile URLs (mapped by platform), and pinned state for the calling account. - [Get Chat Artist](https://developers.recoupable.com/api-reference/chat/artist.md): Retrieve the artist associated with a specific chat room. Returns 404 if the chat does not exist or is not accessible by the authenticated caller. - [Get Chats](https://developers.recoupable.com/api-reference/chat/chats.md): Retrieve chat rooms (conversations) for the authenticated account. If the account has access to organizations, pass account_id to filter to a specific account within those organizations. Optionally filter by an artist_account_id. The endpoint returns metadata about each room, including the topic, as… - [Compact Chats](https://developers.recoupable.com/api-reference/chat/compact.md): Compact one or more chat conversations into summarized versions. This reduces the size of chat history while preserving key information. Optionally provide a prompt to control what information gets preserved in the compacted summary. - [Create Chat](https://developers.recoupable.com/api-reference/chat/create.md): Create a new chat room. Optionally associate it with an artist and/or provide a client-generated chat ID. Pass accountId to create a chat on behalf of a specific account the API key has access to. - [Delete Chat](https://developers.recoupable.com/api-reference/chat/delete.md): Delete a chat room by ID. This operation also removes related room records (memory emails, memories) before deleting the room itself. - [Generate Chat](https://developers.recoupable.com/api-reference/chat/generate.md): Generate AI-powered text responses using the Recoup chat system. This endpoint processes chat requests and returns generated text along with metadata about the generation process. - [Get Chat Messages](https://developers.recoupable.com/api-reference/chat/messages.md): Retrieve all messages (memories) for a specific chat room in chronological order. - [Copy Chat Messages](https://developers.recoupable.com/api-reference/chat/messages-copy.md): Copy all messages from the source chat (`id` path param) to a target chat (`targetChatId` in request body). By default, existing target messages are cleared before copy. - [Delete Trailing Chat Messages](https://developers.recoupable.com/api-reference/chat/messages-trailing-delete.md): Delete all messages in a chat from a given message onward (inclusive), identified by `from_message_id`. - [Stream Chat](https://developers.recoupable.com/api-reference/chat/stream.md): Stream AI-powered chat responses using the Recoup chat system. This endpoint mirrors the request payload of the Chat Generate API but returns a streaming response compatible with the Vercel AI SDK `createUIMessageStreamResponse`. The stream emits UI message parts encoded as data chunks that can be p… - [Update Chat](https://developers.recoupable.com/api-reference/chat/update.md): Update a chat room's topic (display name). The chatId is required; the topic field will be updated. Topic must be between 3 and 50 characters. - [Get Comments](https://developers.recoupable.com/api-reference/comments/get.md): Retrieve comments associated with an artist or a specific post, with support for pagination. This endpoint returns raw comment data including the comment text, associated post, and commenter's social profile reference. - [Authorize Connector](https://developers.recoupable.com/api-reference/connectors/authorize.md): Generate an OAuth authorization URL for connecting a third-party service. Redirect to the returned URL to complete the OAuth flow. - [Disconnect Connector](https://developers.recoupable.com/api-reference/connectors/disconnect.md): Disconnect a connected account from a third-party service. This revokes the OAuth connection and removes stored credentials. - [Execute Connector Action](https://developers.recoupable.com/api-reference/connectors/execute-action.md): Execute a connector action with the given parameters. The `actionSlug` must come from a prior call to GET /api/connectors/actions, and `parameters` must match the `parameters` JSON Schema returned for that action. The action's parent connector must be currently connected (`isConnected: true` in the… - [List Connectors](https://developers.recoupable.com/api-reference/connectors/list.md): List available connectors and their connection status. Returns all supported third-party integrations (e.g., Google Sheets, TikTok) along with whether they are currently connected. - [List Connector Actions](https://developers.recoupable.com/api-reference/connectors/list-actions.md): List the executable actions available across the authenticated account's connectors. Each action is a single tool that can be invoked via POST /api/connectors/actions — for example, the `googlesheets` connector exposes actions like `GOOGLESHEETS_WRITE_SPREADSHEET`. Actions whose parent connector is… - [Task Callback](https://developers.recoupable.com/api-reference/content-agent/callback.md): Internal callback endpoint for the `poll-content-run` Trigger.dev task. Receives content generation results and posts them back to the originating Slack thread. Authenticated via the `x-callback-secret` header. - [Slack Webhook](https://developers.recoupable.com/api-reference/content-agent/webhook.md): 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 s… - [Analyze Video](https://developers.recoupable.com/api-reference/content/analyze-video.md): Analyze a video and answer questions about it. Pass a video URL and a text prompt — for example, "Describe what happens" or "Rate the visual quality 1-10." Returns the generated text. - [Create Content](https://developers.recoupable.com/api-reference/content/create.md): Trigger the content creation pipeline for an artist. Provide `artist_account_id` to identify the target artist. Validates the artist has all required files (face guide, songs) unless overridden via `songs` URLs or `images`, then triggers a background task that generates a short-form video. Returns `… - [Edit Content](https://developers.recoupable.com/api-reference/content/edit.md): Apply ffmpeg edits to a video — trim, crop, resize, or overlay text. Pass a `template` for a preset edit pipeline, or build your own with an `operations` array. - [Estimate Cost](https://developers.recoupable.com/api-reference/content/estimate.md): Estimate the cost of running the content creation pipeline. Calculates per-step and per-video costs based on current pricing. Supports comparing multiple workflow profiles (e.g., premium vs. budget) and projecting batch costs. This endpoint is informational only — it does not trigger any pipeline ex… - [Generate Caption](https://developers.recoupable.com/api-reference/content/generate-caption.md): Generate a short caption from a topic. Returns the text content and default styling (font, color, size). - [Generate Image](https://developers.recoupable.com/api-reference/content/generate-image.md): Generate an image from a text prompt. Pass a `reference_image_url` to guide the output toward a specific look or subject. Returns the image URL. - [Generate Video](https://developers.recoupable.com/api-reference/content/generate-video.md): Generate a video. Set `mode` to control what kind of video you get: - [Get Template Detail](https://developers.recoupable.com/api-reference/content/template-detail.md): Get the full configuration for a specific content creation template. Returns the complete creative recipe including image prompts, video motion config, caption style rules, and edit operations. - [List Templates](https://developers.recoupable.com/api-reference/content/templates.md): List all available content creation templates. Templates are optional — every content primitive works without one. When you do use a template, it provides a complete creative recipe: image prompts, video motion config, caption style rules, and edit operations. Returns template ID and description onl… - [Transcribe Audio](https://developers.recoupable.com/api-reference/content/transcribe-audio.md): Transcribe audio into text with word-level timestamps. Pass one or more audio file URLs in `audio_urls`. Returns the full transcript and an array of timed segments. - [Upscale Content](https://developers.recoupable.com/api-reference/content/upscale.md): Upscale an image or video to higher resolution. Pass the URL and specify the type. Returns the upscaled URL. - [Validate Artist](https://developers.recoupable.com/api-reference/content/validate.md): Check whether an artist has all the required files to run the content creation pipeline. Returns a structured report of each required and recommended file with its status. Required files must be present or the pipeline will fail. Recommended files improve output quality but are not strictly necessar… - [Get Artist Fans](https://developers.recoupable.com/api-reference/fans/get.md): Retrieve all social profiles from fans of an artist across all platforms. This endpoint aggregates fan data from all connected social media platforms. Supports pagination for large fan lists. - [Generate Image](https://developers.recoupable.com/api-reference/image/generation.md): Generate high-quality images using AI models. Images are automatically stored on Arweave and include In Process moment metadata for provenance and ownership tracking. - [Send Notification](https://developers.recoupable.com/api-reference/notifications/create.md): Send a notification email to the authenticated account's email address via the Resend API. Emails are sent from `Agent by Recoup `. The recipient is automatically resolved from the API key or Bearer token. Supports plain text (rendered as Markdown) or raw HTML bodies, optional… - [Add Artist to Organization](https://developers.recoupable.com/api-reference/organizations/add-artist.md): Add an artist to an organization. This allows organization members to access and manage the artist. This endpoint is idempotent - calling it multiple times with the same artistId and organizationId will not create duplicate records. - [Create Organization](https://developers.recoupable.com/api-reference/organizations/create.md): Create a new organization. The creator is automatically added as a member of the organization. - [Get Organizations](https://developers.recoupable.com/api-reference/organizations/list.md): Retrieve all organizations that the authenticated account belongs to. Pass account_id to retrieve organizations for a specific account the API key has access to. - [Get Artist Posts](https://developers.recoupable.com/api-reference/posts/get.md): Retrieve all social media posts from an artist across all platforms. This endpoint aggregates posts from all connected social media profiles for the specified artist. Supports pagination for large post collections. - [List Pulses](https://developers.recoupable.com/api-reference/pulses/list.md): Retrieve pulse information for the authenticated account. If the account has access to organizations, pass account_id to filter to a specific account within those organizations. - [Update Pulse](https://developers.recoupable.com/api-reference/pulses/update.md): Update the pulse settings for an account. Use this to enable or disable the pulse. Returns an array of pulses for consistency with the GET endpoint. - [Albums](https://developers.recoupable.com/api-reference/research/albums.md): Get the album discography — albums, EPs, and singles with release dates — for a Chartmetric `artist_id`. - [Audience Demographics](https://developers.recoupable.com/api-reference/research/audience.md): Get audience demographics for an artist on a specific platform — age, gender, and country breakdown. - [Career Timeline](https://developers.recoupable.com/api-reference/research/career.md): Get an artist's career timeline — key milestones, trajectory, and career stage. - [Charts](https://developers.recoupable.com/api-reference/research/charts.md): Get global chart positions for a platform — Spotify, Apple Music, TikTok, YouTube, iTunes, Shazam, etc. NOT artist-scoped. Returns ranked entries with track and artist info. - [Listener Cities](https://developers.recoupable.com/api-reference/research/cities.md): Get the top cities where an artist's fans listen, ranked by listener concentration. - [Curator](https://developers.recoupable.com/api-reference/research/curator.md): Get curator profile — name, image, follower counts across platforms, tag-based genre info, and Chartmetric playlist reach statistics. Requires a numeric Chartmetric curator ID (e.g. `2` for Spotify's own account). Discover a Chartmetric curator ID via [GET /api/research](/api-reference/research/sear… - [Deep Research](https://developers.recoupable.com/api-reference/research/deep.md): Perform deep, comprehensive research on a topic. Browses multiple sources extensively and returns a cited report. Use for full artist deep dives, competitive analysis, and any research requiring synthesis across many sources. - [Discover Artists](https://developers.recoupable.com/api-reference/research/discover.md): Discover artists by criteria — filter by country, genre, Spotify monthly listener range, and sort by growth metrics. - [Enrich](https://developers.recoupable.com/api-reference/research/enrich.md): Enrich an entity with structured data from web research. Provide a description of who or what to research and a JSON schema defining the fields to extract. Returns typed data with citations. **Important:** The `schema` object must include `"type": "object"` at the top level — requests without an exp… - [Extract URL](https://developers.recoupable.com/api-reference/research/extract.md): Extract clean markdown content from one or more public URLs. Handles JavaScript-heavy pages and PDFs. Returns focused excerpts aligned to an objective, or full page content. - [Festivals](https://developers.recoupable.com/api-reference/research/festivals.md): List music festivals. - [Genres](https://developers.recoupable.com/api-reference/research/genres.md): List all available genre IDs and names. Use these IDs with the discover endpoint at GET /api/research/discover. - [AI Insights](https://developers.recoupable.com/api-reference/research/insights.md): Get AI-generated insights about an artist — automatically surfaced trends, milestones, and observations. - [Instagram Posts](https://developers.recoupable.com/api-reference/research/instagram-posts.md): Get an artist's top Instagram posts and reels, sorted by engagement. - [Lookup by URL](https://developers.recoupable.com/api-reference/research/lookup.md): Look up an artist by a platform URL or ID — Spotify URL, Spotify ID, Apple Music URL, etc. - [Platform Metrics](https://developers.recoupable.com/api-reference/research/metrics.md): Get platform-specific metrics for an artist over time — followers, listeners, views, engagement. Supports 14 platforms. - [Milestones](https://developers.recoupable.com/api-reference/research/milestones.md): Get an artist's activity feed — playlist adds, chart entries, and other notable events. Each milestone includes a date, summary, platform, track name, and star rating. - [People Search](https://developers.recoupable.com/api-reference/research/people.md): Search for people in the music industry — artists, managers, A&R reps, producers. Returns multi-source profiles including LinkedIn data. - [Playlist](https://developers.recoupable.com/api-reference/research/playlist.md): Get playlist metadata — name, description, follower count, track count, and curator info. - [Playlist Placements](https://developers.recoupable.com/api-reference/research/playlists.md): Get an artist's playlist placements — editorial, algorithmic, and indie playlists across platforms. - [Artist Profile](https://developers.recoupable.com/api-reference/research/profile.md): Get a full artist profile — bio, genres, social URLs, label, career stage, and basic metrics. - [Radio Stations](https://developers.recoupable.com/api-reference/research/radio.md): List radio stations tracked by Chartmetric. NOT artist-scoped. Returns station names, formats, and markets. - [Artist Rank](https://developers.recoupable.com/api-reference/research/rank.md): Get an artist's global Chartmetric ranking as a single integer value. - [Search](https://developers.recoupable.com/api-reference/research/search.md): Unified Chartmetric search. This is the discovery primitive for the detail-lookup endpoints — use `type=artists` to find an `id` for [GET /api/research/albums](/api-reference/research/albums), `type=tracks` for [GET /api/research/track](/api-reference/research/track), `type=playlists` for [GET /api/… - [Similar Artists](https://developers.recoupable.com/api-reference/research/similar.md): Find similar artists based on audience overlap, genre, mood, and musicality. Use for competitive analysis and collaboration discovery. - [Track](https://developers.recoupable.com/api-reference/research/track.md): Get full Chartmetric track metadata by numeric track `id` — title, artists, albums, release date, genres, popularity, and platform IDs. - [Track Playlists](https://developers.recoupable.com/api-reference/research/track-playlists.md): Returns playlists featuring a specific track. Accepts a Chartmetric track ID (`id`) or a track name + optional artist (`q`, `artist`) for a Spotify-powered lookup. When no filter flag is passed, defaults to editorial + indie + majorCurator + popularIndie = `true`. Costs 5 credits per request. - [Tracks](https://developers.recoupable.com/api-reference/research/tracks.md): Get all tracks by an artist with popularity data. - [Social URLs](https://developers.recoupable.com/api-reference/research/urls.md): Get all social and streaming URLs for an artist — Spotify, Instagram, TikTok, YouTube, Twitter, SoundCloud, and more. - [Venues](https://developers.recoupable.com/api-reference/research/venues.md): Get venues an artist has performed at, including capacity and location data. - [Web Search](https://developers.recoupable.com/api-reference/research/web.md): Search the web for real-time information. Returns ranked results with titles, URLs, and content snippets. Use for narrative context, press coverage, and cultural research that structured data endpoints don't cover. - [Create Sandbox](https://developers.recoupable.com/api-reference/sandboxes/create.md): Create a new ephemeral sandbox environment. Optionally executes a command or an OpenCode prompt if provided. Sandboxes are isolated Linux microVMs that can be used to evaluate account-generated code, run AI agent output safely, or execute reproducible tasks. The sandbox will automatically stop after… - [Delete Sandbox](https://developers.recoupable.com/api-reference/sandboxes/delete.md): Delete a sandbox environment for the authenticated account. This permanently deletes the associated GitHub repository and removes the account's snapshot record from the database. By default, deletes the sandbox for the key owner's account. Pass account_id to target a specific account the API key has… - [Get File Contents](https://developers.recoupable.com/api-reference/sandboxes/file.md): Retrieve the raw contents of a file from the authenticated account's sandbox GitHub repository. Resolves the github_repo from the [account's snapshot](/api-reference/sandboxes/list), then fetches the file at the specified path from the repository's main branch. Authentication is handled via the x-ap… - [List Sandboxes](https://developers.recoupable.com/api-reference/sandboxes/list.md): List all sandboxes associated with the authenticated account and their current statuses. Returns sandbox details including lifecycle state, timeout remaining, and creation timestamp. Pass account_id to retrieve sandboxes for a specific account the API key has access to. Authentication is handled via… - [Setup Sandbox](https://developers.recoupable.com/api-reference/sandboxes/setup.md): Triggers the setup-sandbox background task to create a personal sandbox, provision a GitHub repo, take a snapshot, and shut down. By default, sets up the sandbox for the key owner's account. Pass account_id to target a specific account the API key has access to. Authentication is handled via the x-a… - [Update Snapshot](https://developers.recoupable.com/api-reference/sandboxes/snapshot.md): Set a custom snapshot ID for an account. By default, updates the key owner's account. Pass account_id to target a specific account the API key has access to. This allows accounts to use a specific sandbox snapshot when creating new sandboxes, enabling reproducible environments with pre-configured to… - [Upload Files](https://developers.recoupable.com/api-reference/sandboxes/upload.md): Upload one or more files to the authenticated account's sandbox GitHub repository. Accepts an array of file URLs and commits each file to the specified directory path within the repository. Supports submodule resolution — if the target path falls within a git submodule, the file is committed to the… - [Social Scrape](https://developers.recoupable.com/api-reference/social/scrape.md): Trigger a social profile scraping job for a given social profile. Use the [Get Artist Socials](/api-reference/artists/socials) endpoint first to retrieve the social profile id values. The response returns Apify run metadata for polling status and retrieving results via the [Apify Scraper Results API… - [Analyze Songs](https://developers.recoupable.com/api-reference/songs/analyze.md): Analyze music using a state-of-the-art Audio Language Model that listens directly to the audio waveform. Unlike text-based AI, this model processes the actual sound — identifying harmony, structure, timbre, lyrics, and cultural context through deep music understanding. Supports audio up to 20 minute… - [List Analyze Presets](https://developers.recoupable.com/api-reference/songs/analyze-presets.md): Lists all available music analysis presets. Each preset is a curated prompt with optimized generation parameters for a specific use case (e.g. catalog metadata enrichment, sync licensing analysis, audience profiling). Requires authentication via API key or Bearer token. - [Get Catalog Songs](https://developers.recoupable.com/api-reference/songs/catalog-songs.md): Retrieve songs within a specific catalog with pagination support. This endpoint joins catalog_songs with songs, song_artists, and accounts to provide comprehensive song information for a given catalog. - [Add Catalog Songs](https://developers.recoupable.com/api-reference/songs/catalog-songs-add.md): Batch add songs to a catalog by ISRC. For each song, the API attempts to look up metadata via internal search. If no data is found, optional fallback fields (name, album, notes, artists) are used. - [Remove Catalog Songs](https://developers.recoupable.com/api-reference/songs/catalog-songs-delete.md): Batch remove songs from a catalog by ISRC. Deletes the relationship in catalog_songs for each catalog_id and ISRC pair. - [Get Catalogs](https://developers.recoupable.com/api-reference/songs/catalogs.md): Retrieve catalogs associated with a specific account. The endpoint joins account_catalogs with catalogs to return catalog metadata for the specified account. - [Create Songs](https://developers.recoupable.com/api-reference/songs/create.md): Bulk create or fetch songs by ISRC. For each song, the API attempts to look up metadata via internal search. If no data is found, optional fallback fields (name, album, notes, artists) are used. - [Get Songs](https://developers.recoupable.com/api-reference/songs/songs.md): Retrieve songs from the database with optional filtering by ISRC (International Standard Recording Code) or artist account. This endpoint joins the songs table with song_artists and accounts tables to provide comprehensive song information. - [Get Album](https://developers.recoupable.com/api-reference/spotify/album.md): Get Spotify catalog information for a single album. - [Get Artist](https://developers.recoupable.com/api-reference/spotify/artist.md): Get Spotify catalog information for a single artist identified by their unique Spotify ID. - [Get Artist Albums](https://developers.recoupable.com/api-reference/spotify/artist-albums.md): Get Spotify catalog information about an artist's albums. - [Get Artist Top Tracks](https://developers.recoupable.com/api-reference/spotify/artist-top-tracks.md): Get an artist's top tracks by country. - [Search](https://developers.recoupable.com/api-reference/spotify/search.md): Search for artists, albums, tracks, and playlists using the Spotify API. This endpoint is a proxy to the official Spotify Search API. - [Create Subscription Session](https://developers.recoupable.com/api-reference/subscriptions/sessions-create.md): Create a checkout session to start a subscription for the authenticated account. Returns a hosted checkout URL that the client should redirect to. The session is pre-configured with a 30-day trial period. - [Create Task](https://developers.recoupable.com/api-reference/tasks/create.md): Create a new scheduled task that runs a prompt against an artist on a recurring cron schedule. The response matches the [GET endpoint](/api-reference/tasks/get) (a `TasksResponse` with the created task in the `tasks` array). - [Delete Task](https://developers.recoupable.com/api-reference/tasks/delete.md): Delete an existing scheduled task by `id`. Returns only the delete operation status. - [Get Tasks](https://developers.recoupable.com/api-reference/tasks/get.md): Retrieve scheduled tasks. Each task includes `recent_runs` (last 5 runs), `upcoming` (next scheduled run times) sourced directly from the Trigger.dev API, and `owner_email` when an account email exists for the task owner. Supports filtering by id, account_id, or artist_account_id. - [Get Task Runs](https://developers.recoupable.com/api-reference/tasks/runs.md): Returns task runs for the authenticated account. When `runId` is provided, the response contains that single run (`runs` length 1) or 404 if not found. When `runId` is omitted, returns recent runs filtered by account context (default authenticated account, or `account_id` override when authorized). - [Update Task](https://developers.recoupable.com/api-reference/tasks/update.md): Update an existing scheduled task. Only the id field is required; any additional fields you include will be updated on the task. The response shape matches the GET endpoint (an array containing the updated task). - [Transcribe Audio](https://developers.recoupable.com/api-reference/transcribe/audio.md): Transcribe audio files using OpenAI Whisper. The API saves both the original audio file and the generated markdown transcript to the customer's files in Supabase Storage. - [Create Workspace](https://developers.recoupable.com/api-reference/workspaces/create.md): Create a new workspace account. Workspaces can optionally be linked to an organization. - [Authentication](https://developers.recoupable.com/authentication.md): How authentication works in the Recoup API — API keys, access tokens, and organization access control. - [CLI](https://developers.recoupable.com/cli.md): Install the Recoup CLI and interact with the platform from your terminal. - [Content](https://developers.recoupable.com/content-agent.md): Generate images, videos, captions, and social-ready content using AI-powered primitives - [Recoup API Documentation](https://developers.recoupable.com/index.md): Use the Recoup API to build your record label. Access research, content creation, chat, artist analytics, social media, and platform management endpoints. - [MCP](https://developers.recoupable.com/mcp.md): Connect AI agents to the Recoup platform using the Model Context Protocol (MCP) server. - [Quickstart](https://developers.recoupable.com/quickstart.md): Get a Recoup API key in one call and make your first request — no browser, no dashboard. - [Create a New Artist](https://developers.recoupable.com/workflows/create-artist.md): End-to-end workflow to create, research and enrich a new artist account in a single session. ## OpenAPI Specs - [releases](https://developers.recoupable.com/api-reference/openapi/releases.json) - [social](https://developers.recoupable.com/api-reference/openapi/social.json) - [accounts](https://developers.recoupable.com/api-reference/openapi/accounts.json) - [research](https://developers.recoupable.com/api-reference/openapi/research.json) - [content](https://developers.recoupable.com/api-reference/openapi/content.json) ## Optional - [Recoup App](https://chat.recoupable.com) - [Website](https://recoupable.com) - [Blog](https://research.recoupable.com/)