Get one registry agent

GET/api/v1/governance/registry/agents/{agentId}

Request and response examples

request.py

import osimport requestsorigin = "https://app.langwatch.ai"path = "/api/v1/governance/registry/agents/<agentId>"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/agents/<agentId>";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/agents/<agentId>' \  --header "Authorization: Bearer $LANGWATCH_API_KEY"

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": {},        "status": "active",        "deprecated_in_version": 0,        "deprecated_at": "string"      }    ],    "first_seen_at": "string",    "last_seen_at": "string",    "updated_at": "string",    "removed_at": "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  ]}

Not Found

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

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

Path parameters

agentIdstringrequired

At least 1 character

Responses

200

Success

application/json

dataobjectrequired

Show 22 child attributesHide 22 child attributes

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

Show 2 variantsHide 2 variants

endpointsobject[]required

Show 3 child attributesHide 3 child attributes

modelobject | nullrequired

Show 2 variantsHide 2 variants

instructionsstring | nullrequired

capabilitiesstring[]required

toolsobject[]required

Show 7 child attributesHide 7 child attributes

first_seen_atstringrequired

last_seen_atstring | nullrequired

updated_atstringrequired

removed_atstring | nullrequired

400

Bad Request

application/json

typestringrequired

codestringrequired

messagestringrequired

retryablebooleanrequired

metaobject

trace_idstring

span_idstring

traceobject

Show 4 child attributesHide 4 child attributes

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

Show 4 child attributesHide 4 child attributes

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

Show 4 child attributesHide 4 child attributes

traceIdstring

spanIdstring

traceUrlstring

logsUrlstring

tipsstring[]

docs_urlstring

faultstring

One of"customer""platform""provider""presumed_platform"

reasonsany[]

404

Not Found

application/json

typestringrequired

codestringrequired

messagestringrequired

retryablebooleanrequired

metaobject

trace_idstring

span_idstring

traceobject

Show 4 child attributesHide 4 child attributes

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

Show 4 child attributesHide 4 child attributes

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

Show 4 child attributesHide 4 child attributes

traceIdstring

spanIdstring

traceUrlstring

logsUrlstring

tipsstring[]

docs_urlstring

faultstring

One of"customer""platform""provider""presumed_platform"

reasonsany[]

Get one registry agent

Try this endpoint

Authorization

Path parameters

Responses