Skip to main content
GET
/
projects
/
jobs
/
{jobId}
Get job status
curl --request GET \
  --url https://faces.app/api/v1/projects/jobs/{jobId} \
  --header 'Authorization: Bearer <token>'
{
  "jobId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "editorUrl": "<string>",
  "finalDuration": "45 seconds",
  "publishedUrl": "<string>",
  "error": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.faces.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key with "faces_" prefix. Create one at Settings > Developers.

Path Parameters

​
jobId
string
required

The job ID returned by generateProject.

Response

Job status

​
jobId
string
required
​
status
enum<string>
required
Available options:
processing,
completed,
failed
​
createdAt
string<date-time>
required
​
editorUrl
string<uri>
​
finalDuration
string

Actual generation time. Only present when status is completed.

Example:

"45 seconds"

​
publishedUrl
string<uri>

Available when status is completed.

​
error
string

Error message when status is failed.