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}.
View as MarkdownRead the plain-text source
View .claudePlain-text page for your agent
View .agentPlain-text page for your agent
Open in ClaudeAsk questions about this page
Open in ChatGPTAsk questions about this page
Connect to CursorInstall the LangWatch MCP server
Connect to VS CodeInstall the LangWatch MCP server
Search the registry (ARD search)
ARD POST /search: query.text is matched against names, capabilities, descriptions, instructions and tools; query.filter keys are term paths (tags, capabilities, data.source, data.shadow), values within a key are OR-ed and keys AND-ed. Results carry a 0 to 100 relevance score. Searches the 1,000 active agents changed most recently. Federation is not performed.
Try this endpoint
app.langwatch.ai
API key · Authorization
Kept in this tab. Cleared when you reload.
This sends a live request to app.langwatch.ai.
Request and response examples
request.py
import osimport requestsorigin = "https://app.langwatch.ai"path = "/api/v1/governance/registry/ard/search"api_key = os.environ["LANGWATCH_API_KEY"]headers = { "Authorization": "Bearer " + api_key, "Content-Type": "application/json",}payload = { "query": { "text": "string", "filter": {}, }, "federation": "auto", "pageSize": 10, "pageToken": "string",}response = requests.post( origin + path, headers=headers, json=payload,)print(response.json())const url = "https://app.langwatch.ai/api/v1/governance/registry/ard/search";const response = await fetch(url, { method: "POST", headers: { "Authorization": "Bearer " + process.env.LANGWATCH_API_KEY, "Content-Type": "application/json", }, body: JSON.stringify({ "query": { "text": "string", "filter": {} }, "federation": "auto", "pageSize": 10, "pageToken": "string" }),});const data = await response.json();curl --request POST \ --url 'https://app.langwatch.ai/api/v1/governance/registry/ard/search' \ --header "Authorization: Bearer $LANGWATCH_API_KEY" \ --header 'Content-Type: application/json' \ --data '{"query":{"text":"string","filter":{}},"federation":"auto","pageSize":10,"pageToken":"string"}'Success
application/json · Generated from schema
{ "results": [ { "@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": {}, "score": 0, "source": "string" } ], "pageToken": "string"}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 ]}Unprocessable Entity
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 ]}Request body
application/json · Required
queryobjectrequiredfederationstringOne of
"auto""referrals""none"pageSizeintegerMinimum 1Maximum 100
Default:
10pageTokenstringPattern ^\d+$
Responses
200Success
application/json
resultsobject[]requiredpageTokenstring400Bad 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[]422Unprocessable Entity
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[]