Skip to main content
POST
/
v1
/
faces
/
{face_id}
/
upload
Upload Face Source File
curl --request POST \
  --url https://api.faces.sh/v1/faces/{face_id}/upload \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=<string>'
{
  "document_id": "<string>",
  "model": "<string>",
  "label": "<string>",
  "source": "<string>",
  "version": 123,
  "content": "<string>",
  "token_count": 123,
  "tokens_used": 123,
  "tokens_limit": 123,
  "synced": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "type": "document"
}

Headers

​
authorization
string | null

Path Parameters

​
face_id
string
required

Query Parameters

​
type
string
default:document
Pattern: ^(document|thread)$
​
perspective
string
default:third-person
Pattern: ^(first-person|third-person)$
​
face_speaker
string | null

Body

multipart/form-data
​
file
string
required

Response

Successful Response

​
document_id
string
required
​
model
string
required
​
label
string
required
​
source
string
required
​
version
integer
required
​
content
string
required
​
token_count
integer
required
​
tokens_used
integer
required
​
tokens_limit
integer
required
​
synced
boolean
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
type
string
default:document