POST
/
v1
/
upload-url

​
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.

​
Headers

​
Content-Type
string
required

Must be set to application/json

​
x-api-key
string
required

Your Personal AI API key

​
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

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
503Authorization Failure - API key is invalid
400Invalid URL - URL cannot be accessed or is invalid
422Processing Error - Content cannot be extracted from URL
Upload FileMemory API