Admin API key for organization-level operations (managing projects, API keys). Create one in Settings > API Keys or via POST /api/api-keys. Format: sk-lw-{id}_{secret}.
Get the registry as an ARD manifest
The organisation's active agents, the 1,000 changed most recently, as an Agentic Resource Discovery (ARD v0.91) manifest. Each entry has a urn:air:<host>:<organization id>:agent:<id> identifier, type application/agent-card+json and the registry entry inline as data.
Try this endpoint
app.langwatch.ai
API key · Authorization
Kept in this tab. Cleared when you reload.
Request and response examples
request.py
import osimport requestsorigin = "https://app.langwatch.ai"path = "/api/v1/governance/registry/ard.json"api_key = os.environ["LANGWATCH_API_KEY"]headers = { "Authorization": "Bearer " + api_key,}response = requests.get( origin + path, headers=headers,)print(response.json())const url = "https://app.langwatch.ai/api/v1/governance/registry/ard.json";const response = await fetch(url, { method: "GET", headers: { "Authorization": "Bearer " + process.env.LANGWATCH_API_KEY, },});const data = await response.json();curl --request GET \ --url 'https://app.langwatch.ai/api/v1/governance/registry/ard.json' \ --header "Authorization: Bearer $LANGWATCH_API_KEY"Success
application/json · Generated from schema
{ "specVersion": "0.91", "publisher": "string", "updatedAt": "string", "entries": [ { "@context": "https://agenticresourcediscovery.org/context/v1", "identifier": "string", "displayName": "string", "type": "application/agent-card+json", "description": "string", "version": "string", "updatedAt": "string", "tags": [ "string" ], "capabilities": [ "string" ], "data": { "id": "string", "source": "langwatch", "management": "managed", "kind": "string", "name": "string", "description": "string", "status": "active", "shadow": false, "version": 0, "source_version": "string", "project_id": "string", "environment": "string", "owner": { "user_id": null, "name": null }, "endpoints": [ { "kind": null, "url": null, "protocol": null } ], "model": { "provider": null, "model": null, "parameters": null }, "instructions": "string", "capabilities": [ "string" ], "tools": [ { "name": null, "description": null, "input_schema": null, "output_schema": null, "status": null, "deprecated_in_version": null, "deprecated_at": null } ], "first_seen_at": "string", "last_seen_at": "string", "updated_at": "string", "removed_at": "string" }, "metadata": {} } ]}Bad Request
application/json · Generated from schema
{ "type": "string", "code": "string", "message": "string", "retryable": false, "meta": {}, "trace_id": "string", "span_id": "string", "trace": { "traceId": "string", "spanId": "string", "traceUrl": "string", "logsUrl": "string" }, "tips": [ "string" ], "docs_url": "string", "fault": "customer", "reasons": [ null ]}Unauthorized
application/json · Generated from schema
{ "type": "string", "code": "string", "message": "string", "retryable": false, "meta": {}, "trace_id": "string", "span_id": "string", "trace": { "traceId": "string", "spanId": "string", "traceUrl": "string", "logsUrl": "string" }, "tips": [ "string" ], "docs_url": "string", "fault": "customer", "reasons": [ null ]}Forbidden
application/json · Generated from schema
{ "type": "string", "code": "string", "message": "string", "retryable": false, "meta": {}, "trace_id": "string", "span_id": "string", "trace": { "traceId": "string", "spanId": "string", "traceUrl": "string", "logsUrl": "string" }, "tips": [ "string" ], "docs_url": "string", "fault": "customer", "reasons": [ null ]}Internal Server Error
application/json · Generated from schema
{ "type": "string", "code": "string", "message": "string", "retryable": false, "meta": {}, "trace_id": "string", "span_id": "string", "trace": { "traceId": "string", "spanId": "string", "traceUrl": "string", "logsUrl": "string" }, "tips": [ "string" ], "docs_url": "string", "fault": "customer", "reasons": [ null ]}Responses
200Success
application/json
specVersionstringrequiredAlways
"0.91"publisherstringrequiredupdatedAtstringrequiredentriesobject[]required400Bad Request
application/json
typestringrequiredcodestringrequiredmessagestringrequiredretryablebooleanrequiredmetaobjecttrace_idstringspan_idstringtraceobjecttipsstring[]docs_urlstringfaultstringOne of
"customer""platform""provider""presumed_platform"reasonsany[]401Unauthorized
application/json
typestringrequiredcodestringrequiredmessagestringrequiredretryablebooleanrequiredmetaobjecttrace_idstringspan_idstringtraceobjecttipsstring[]docs_urlstringfaultstringOne of
"customer""platform""provider""presumed_platform"reasonsany[]403Forbidden
application/json
typestringrequiredcodestringrequiredmessagestringrequiredretryablebooleanrequiredmetaobjecttrace_idstringspan_idstringtraceobjecttipsstring[]docs_urlstringfaultstringOne of
"customer""platform""provider""presumed_platform"reasonsany[]500Internal Server Error
application/json
typestringrequiredcodestringrequiredmessagestringrequiredretryablebooleanrequiredmetaobjecttrace_idstringspan_idstringtraceobjecttipsstring[]docs_urlstringfaultstringOne of
"customer""platform""provider""presumed_platform"reasonsany[]