Skip to main content
POST
/
api
/
agents
/
{id}
/
import-url
Import source URL
curl --request POST \
  --url https://agent-evalserver-production.up.railway.app/api/agents/{id}/import-url \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "https://example.com/refund-policy"
}
'
{
  "success": true,
  "message": "Knowledge imported successfully",
  "article": {
    "url": "https://example.com/refund-policy",
    "title": "Refund Policy",
    "summary": "Policy details for customer refunds.",
    "wordCount": 1200,
    "chunkCount": 8,
    "preview": "Customers can request a refund within 30 days..."
  },
  "knowledge": {
    "qaPairsStored": 6,
    "usedDefaultFallback": false
  }
}

​
Import Source URL

Import source knowledge from a public web page. Use this for published docs, help center articles, product pages, or other public source material that should inform evaluation questions.

​
Endpoint

POST /api/agents/{id}/import-url

​
Authentication

Send your platform API key in the x-api-key header.

​
Path Parameters

NameTypeDescription
idstring<uuid>Evaluation agent ID.

​
Request Body

{
  "url": "https://example.com/refund-policy"
}

​
Success Response

Returns 200 OK with a summary of extracted article content and stored knowledge.

Authorizations

​
x-api-key
string
header
required

Platform API key for authenticated account-level API access

Path Parameters

​
id
string<uuid>
required

Evaluation agent ID.

Body

application/json

Import source knowledge from a public web page.

​
url
string<uri>
required

Public HTTPS URL to process.

Example:

"https://example.com/refund-policy"

Response

Knowledge imported successfully

Summary of the source URL import.

​
success
boolean
Example:

true

​
message
string
Example:

"Knowledge imported successfully"

​
article
object
​
knowledge
object