DocsAPI Reference
POST /import-agent
Pre-populate a registration from a domain's A2A agent card (/.well-known/agent.json). Returns a preview with the fields Aidress could extract, plus a list of fields you still need to provide before calling /register.
This is a read-only preview — nothing is written to the registry.
Request body
| Name | Type | Required | Description |
|---|---|---|---|
domain_url | string | Yes | Domain to fetch from. Scheme optional — "example.com" or "https://example.com" both work. |
bash
curl -X POST https://api.aidress.ai/import-agent \
-H "Content-Type: application/json" \
-d '{"domain_url": "https://freightbot.io"}'Response 200
json
{
"source_url": "https://freightbot.io/.well-known/agent.json",
"preview": {
"org_name": "FreightBot Logistics",
"specialty": "Cross-border freight coordination",
"endpoint_url": "https://api.freightbot.io/run",
"capabilities": [
{ "name": "freight_booking", "weight": 1 }
]
},
"missing_fields": ["agent_id", "org_domain"],
"note": "Review the preview and fill missing fields, then POST to /register."
}