Skip to main content
GET
/
projects
/
jobs
/
{jobId}
curl https://faces.app/api/v1/projects/jobs/cm1abc123... \
  -H "Authorization: Bearer $FACES_API_KEY"

{
  "jobId": "cm1abc123def456",
  "status": "completed",
  "editorUrl": "https://faces.app/s/xK9mP2qR",
  "publishedUrl": "https://your-subdomain.faces.site/project-slug",
  "createdAt": "2025-01-15T10:30:00.000Z"
}
​
jobId
string
required
The job ID returned by Generate project.
curl https://faces.app/api/v1/projects/jobs/cm1abc123... \
  -H "Authorization: Bearer $FACES_API_KEY"

{
  "jobId": "cm1abc123def456",
  "status": "completed",
  "editorUrl": "https://faces.app/s/xK9mP2qR",
  "publishedUrl": "https://your-subdomain.faces.site/project-slug",
  "createdAt": "2025-01-15T10:30:00.000Z"
}
​
status
string
One of processing, completed, or failed. Poll until it’s no longer processing.
​
editorUrl
string
URL to open the project in the editor.
​
publishedUrl
string
Public URL of the published project. Only present when status is completed and the project has a subdomain.
​
error
string
Error message. Only present when status is failed.
​
createdAt
string
ISO 8601 timestamp of when the job was created.