Submit book for character extraction

Submits a book file for background processing. The backend downloads the file from the provided URL, validates it (.txt / .md only), queues a background job via Redis, and returns immediately with a 202 Accepted.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

book_id*string

UUID of the book record in Supabase (books table)

file_url*string

Signed URL or public URL to the .txt or .md file in Supabase Storage

user_id*string

UUID of the user making the request

Response Body

`application/json`

curl -X POST "https://example.com/character/processing" \  -H "Content-Type: application/json" \  -d '{    "book_id": "49cf97ac-d4b0-4fb1-a148-592152017f4d",    "file_url": "http://example.com",    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"  }'

{
  "status": "accepted",
  "data": {
    "book_id": "49cf97ac-d4b0-4fb1-a148-592152017f4d",
    "job": {},
    "queued": true
  }
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

Submit book for character extraction

Request Body

Response Body

202application/json

400application/json

422application/json

500application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`