Skip to contentSkip to page list

Docs

5,030
Open app

List the organisation's agent registry

Every agent LangWatch sees for the organisation: agents defined in its projects, agents a governance source listed (Databricks Genie, Copilot Studio) and agents its traces name in gen_ai.agent.name. Ordered by last change, oldest first; pass next_cursor back as cursor. updated_since returns only entries changed at or after that instant.

GET/api/v1/governance/registry/agents
Request and response examples
request.py
import osimport requests​origin = "https://app.langwatch.ai"path = "/api/v1/governance/registry/agents"api_key = os.environ["LANGWATCH_API_KEY"]headers = {    "Authorization": "Bearer " + api_key,}​response = requests.get(    origin + path,    headers=headers,)print(response.json())

Success

application/json · Generated from schema

{  "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": "string",        "name": "string"      },      "endpoints": [        {          "kind": "invoke",          "url": "string",          "protocol": "string"        }      ],      "model": {        "provider": "string",        "model": "string",        "parameters": {}      },      "instructions": "string",      "capabilities": [        "string"      ],      "tools": [        {          "name": "string",          "description": "string",          "input_schema": {},          "output_schema": null,          "status": "active",          "deprecated_in_version": null,          "deprecated_at": "string"        }      ],      "first_seen_at": "string",      "last_seen_at": "string",      "updated_at": "string",      "removed_at": "string"    }  ],  "next_cursor": "string"}
api-reference/governance-agent-registry/list-the-organisation-s-agent-registry

Authorization

Authorizationstringheaderrequired

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}.

Query parameters

limitinteger
Minimum 1Maximum 200
cursorstring
At least 1 character
updated_sincestring (date-time)
Pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
statusstring

Responses

200

Success

application/json

dataobject[]required
idstringrequired
sourcestringrequired
One of"langwatch""databricks""copilot_studio""traffic"
managementstringrequired
One of"managed""discovered""observed"
kindstringrequired
namestringrequired
descriptionstring | nullrequired
statusstringrequired
One of"active""removed"
shadowbooleanrequired
versionintegerrequired
Maximum 9007199254740991
source_versionstring | nullrequired
project_idstring | nullrequired
environmentstring | nullrequired
ownerobject | nullrequired
endpointsobject[]required
modelobject | nullrequired
instructionsstring | nullrequired
capabilitiesstring[]required
toolsobject[]required
first_seen_atstringrequired
last_seen_atstring | nullrequired
updated_atstringrequired
removed_atstring | nullrequired
next_cursorstring | nullrequired
400

Bad Request

application/json

typestringrequired
codestringrequired
messagestringrequired
retryablebooleanrequired
metaobject
trace_idstring
span_idstring
traceobject
traceIdstring
spanIdstring
traceUrlstring
logsUrlstring
tipsstring[]
docs_urlstring
faultstring
One of"customer""platform""provider""presumed_platform"
reasonsany[]
401

Unauthorized

application/json

typestringrequired
codestringrequired
messagestringrequired
retryablebooleanrequired
metaobject
trace_idstring
span_idstring
traceobject
traceIdstring
spanIdstring
traceUrlstring
logsUrlstring
tipsstring[]
docs_urlstring
faultstring
One of"customer""platform""provider""presumed_platform"
reasonsany[]
403

Forbidden

application/json

typestringrequired
codestringrequired
messagestringrequired
retryablebooleanrequired
metaobject
trace_idstring
span_idstring
traceobject
traceIdstring
spanIdstring
traceUrlstring
logsUrlstring
tipsstring[]
docs_urlstring
faultstring
One of"customer""platform""provider""presumed_platform"
reasonsany[]
422

Unprocessable Entity

application/json

typestringrequired
codestringrequired
messagestringrequired
retryablebooleanrequired
metaobject
trace_idstring
span_idstring
traceobject
traceIdstring
spanIdstring
traceUrlstring
logsUrlstring
tipsstring[]
docs_urlstring
faultstring
One of"customer""platform""provider""presumed_platform"
reasonsany[]
500

Internal Server Error

application/json

typestringrequired
codestringrequired
messagestringrequired
retryablebooleanrequired
metaobject
trace_idstring
span_idstring
traceobject
traceIdstring
spanIdstring
traceUrlstring
logsUrlstring
tipsstring[]
docs_urlstring
faultstring
One of"customer""platform""provider""presumed_platform"
reasonsany[]

Last updated

Documentation

Docs for agentsOpen app5,030