Skip to main content
GET
/
api
/
content
/
validate
cURL
curl --request GET \
  --url https://recoup-api.vercel.app/api/content/validate \
  --header 'x-api-key: <api-key>'
{
  "ready": true,
  "artist_account_id": "1873859c-dd37-4e9a-9bac-80d3558527a9",
  "songs": 17,
  "templates": [
    "artist-caption-bedroom",
    "artist-caption-outside",
    "artist-caption-stage"
  ],
  "checks": {
    "face_guide": {
      "status": "ok"
    },
    "artist_context": {
      "status": "ok"
    },
    "audience_context": {
      "status": "ok"
    },
    "era_config": {
      "status": "ok"
    },
    "pipeline_config": {
      "status": "ok"
    },
    "songs": {
      "status": "ok",
      "count": 17
    }
  },
  "missing": [
    {
      "file": "context/images/face-guide.png",
      "severity": "required",
      "description": "Face guide image used for AI image generation",
      "fix": "Generate a face guide using fal-ai/nano-banana-pro/edit with 2-3 reference photos of the artist"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Your Recoup API key. Learn more.

Query Parameters

​
artist_account_id
string<uuid>
required

UUID of the artist account to validate. Use GET /api/artists to find artist account IDs.

Example:

"1873859c-dd37-4e9a-9bac-80d3558527a9"

Response

Validation completed. Check the ready field to determine if the artist can run the pipeline.

Validation report for an artist's content creation readiness.

​
ready
boolean
required

true if the artist has all required files and the pipeline can run. false if required files are missing.

Example:

true

​
artist_account_id
string<uuid>
required

UUID of the artist account that was validated

Example:

"1873859c-dd37-4e9a-9bac-80d3558527a9"

​
songs
integer

Number of songs found in the artist's songs/ directory

Example:

17

​
templates
string[]

Available templates that can be used with this artist

Example:
[
  "artist-caption-bedroom",
  "artist-caption-outside",
  "artist-caption-stage"
]
​
checks
object

Per-file validation results. Only present when ready is true.

​
missing
object[]

List of missing files with severity and fix instructions. Only present when ready is false.