Add link

Add a URL (webpage) as a new knowledge base data source for an AI Agent. The URL will be crawled and processed automatically. Returns status pending until processing completes.

POST/knowledge-base/add-link

Request parameters

Body

agent_idstringrequired

The UUID of the agent to add this source to.

urlstringrequired

The full URL to crawl and add to the knowledge base (e.g. https://yoursite.com/help).

Headers

Authorizationstringrequired

Your API Key formatted as Bearer sk_live_…

Response

Returns the newly created data source object with status pending. The source will be automatically crawled and processed in the background.

cURL

curl -X POST https://app.picobot.dev/api/knowledge-base/add-link \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "91981020-f783-4544-ad96-39857ac589cb", "url": "https://yoursite.com/help"}'

Node.js

fetch('https://app.picobot.dev/api/knowledge-base/add-link', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    agent_id: '91981020-f783-4544-ad96-39857ac589cb',
    url: 'https://yoursite.com/help'
  })
})
.then(res => res.json())
.then(console.log);

Python

import requests

headers = { "Authorization": "Bearer <token>" }
response = requests.post(
  "https://app.picobot.dev/api/knowledge-base/add-link",
  headers=headers,
  json={"agent_id": "91981020-f783-4544-ad96-39857ac589cb", "url": "https://yoursite.com/help"}
)
print(response.json())

{
  "data": {
    "id": "ds-0001-0000-0000-0000-000000000001",
    "type": "link",
    "url": "https://yoursite.com/help",
    "status": "pending",
    "created_at": "2024-06-14T10:00:00+00:00"
  }
}