Skip to main content
POST
/
api
/
v1
/
images
/
generate-headshots
curl -X POST https://api.runflow.io/api/v1/images/generate-headshots \ -H "x-api-key: YOUR_API_KEY" \ -F "callback_url=https://yourapp.com/webhook/headshots" \ -F "images=@/path/to/photo1.jpg" \ -F "images=@/path/to/photo2.jpg" \ -F "images=@/path/to/photo3.jpg" 
{
  "success": true,
  "data": {
    "headshots_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Authorizations

​
x-api-key
string
header
required

Your Runflow API key. Include it in the x-api-key header on every request. Keys are issued per customer — contact the founders to get one.

Body

​
callback_url
string<uri>
required

URL that receives the completed headshots webhook.

Example:

"https://yourapp.com/webhook/headshots"

​
images
file[]
required

One or more portrait image files (JPEG, PNG, or WebP). Send as repeated form fields named images.

Response

Job accepted. Processing continues asynchronously.

​
success
boolean
required

true when the job was accepted successfully.

Example:

true

​
data
object
required