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

​
Overview

API endpoint for uploading content from URLs to your memory. Supports various types of content including public Youtube URLs, LinkedIn profiles, news articles, and blogs.

​
Authorization

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

​
Headers

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

​
Body

​
Url
string
required
URL to upload (includes public Youtube URLs, LinkedIn profiles, news articles, blogs, etc)
Example Request
"Url": "https://www.youtube.com/watch?v=-9F20HckH8w"
​
Title
string
Title of the uploaded content
Example Request
 "Title": "Personal AI Company Overview (2024)"
​
DomainName
string
required
Domain name of AI Persona to upload to
Example Request
"DomainName": "paidevelopers-company"
​
StartTime
string
ISO timestamp string indicating start time (UTC)
Example Request
"StartTime": "2024-10-09T10:00:00.000Z"
​
EndTime
string
ISO timestamp string indicating end time (UTC)
Example Request
"EndTime": "2024-10-10T10:00:00.000Z"
​
Tags
string
Comma delimited list of tags for context and reference
Example Request
"Tags": "personal ai,youtube,company,overview"
​
is_stack
boolean
Boolean to specify whether to add the content to memory. Defaults to true.
Example Request
"is_stack": true
Example
{
    "Url": "https://www.youtube.com/watch?v=-9F20HckH8w",
    "Title": "Personal AI Company Overview (2024)",
    "DomainName": "paidvelopers-company",
    "Tags": "personal ai,youtube,company,overview",
    "is_stack": true,
    "StartTime": "2024-10-09T10:00:00.000Z",
    "EndTime": "2024-10-10T10:00:00.000Z"
}

​
Example Responses

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

​
Example cURL

cURL
curl --location 'https://api.personal.ai/v1/upload-url' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <your-api-key>' \
--data '{
    "Url": "https://personal.ai",
    "Title": "Personal AI",
    "DomainName": "ai",
    "is_stack": false
}'

​
Error Codes

CodeDescription
403Forbidden - Check that API key is invalid
400Invalid URL - URL cannot be accessed or is invalid
422Processing Error - Content cannot be extracted from URL