POST
/
v1
/
upload-file
Upload File
curl --request POST \
  --url https://api.personal.ai/v1/upload-file \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "message_request": "<any>"
}'
{
  "Title": "<string>",
  "Starttime": "<string>",
  "EndTime": "<string>",
  "Tags": "<string>",
  "is_stack": true,
  "message": "<string>"
}

​
Overview

API endpoint for uploading files (PDF, DOCX, etc.) to your Personal AI memory.

​
Authorization

​
x-api-key
string
required
Your Personal AI API key

​
Headers

​
Content-Type
string
required
Must be set to application/json

​
Query Params

​
DomainName
string
required
The hyphenated text below the AI’s name when clicked into a Persona.DomainName

​
File

​
file
File
required
The file to be uploaded
​
message_request
JSON
required
A JSON-encoded string containing additional request parameters
Example message_request
{"DomainName": "product-demo-jebzrhw", "Title": "Uploaded Files"}

​
Body

​
Title
string
Title of the uploaded document
Example Request
"Title": "My Document"
​
Starttime
string
ISO timestamp string indicating start time (UTC). Defaults to current time.
Example Request
"Starttime": "2024-10-09T10:00:00.000Z"
​
EndTime
string
ISO timestamp string indicating end time (UTC). Defaults to current time.
Example Request
"EndTime": "2024-10-10T10:00:00.000Z"
​
Tags
string
Comma delimited list of tags for context and reference
Example Request
"Tags": "documents,developers,coding"
​
is_stack
boolean
Boolean to specify whether to add the document to memory. If false, upload shows up as draft in Documents. Defaults to true.
Example Request
"is_stack": true

​
Example Responses

​
message
string
Success or error message
Example Success Response
{
  "message": "file accepted and processing"
}
Example Error Response
{
  "detail": "AI memory api unauthorized."
}

​
Example cURL

cURL
curl --location 'https://api.personal.ai/v1/upload-file?DomainName={DomainName}' \
--header 'x-api-key: <your-api-key>' \
--form 'file=@"/path/to/file.pdf"' \
--form 'message_request="{\"DomainName\": \"product-demo-jebzrhw\", \"Title\": \"My Document\"}"'

​
Error Codes

CodeDescription
403Forbidden - Check that API key is invalid