Grasco
Profile Picture API & SDK
POST
/profile-picture/selection

Queue a profile picture processing job and stream progress via SSE.

Response format: text/event-stream

SSE Event sequence:

  1. registered — Job queued successfully, includes jobId
  2. progress — Step updates (fetching → normalizing → cropping → styling → matting → resizing → uploading)
  3. completed — Processing finished, includes extCustomerId

Error events can occur at any point and include a retryable flag.

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

generationId*string

Response Body

curl -X POST "https://api.grasco.dev/profile-picture/selection" \  -H "Content-Type: application/json" \  -d '{    "generationId": "string"  }'
{
  "type": "registered",
  "jobId": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}