> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.

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

> Page: https://langwatch.ai/docs/api-reference/governance-agent-registry/list-the-organisation-s-agent-registry
> Source: https://github.com/langwatch/langwatch/blob/main/docs/api-reference/governance-agent-registry/list-the-organisation-s-agent-registry.mdx
> Index of all pages: https://langwatch.ai/docs/llms.txt

## Endpoint

`GET https://app.langwatch.ai/api/v1/governance/registry/agents`

## Authentication

### admin_api_key

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

```json
{"id":"admin_api_key","type":"http","scheme":"bearer"}
```

## Parameters

### limit (query, optional)

```json
{"default":50,"type":"integer","minimum":1,"maximum":200}
```

### cursor (query, optional)

```json
{"type":"string","minLength":1}
```

### updated_since (query, optional)

```json
{
  "type": "string",
  "format": "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)))$"
}
```

### status (query, optional)

```json
{"type":"string","enum":["active","removed"]}
```

## Request example

```bash
curl --request GET \
  --url 'https://app.langwatch.ai/api/v1/governance/registry/agents' \
  --header "Authorization: Bearer $LANGWATCH_API_KEY"
```

## Responses

### 200

Success

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {"type":"string"},
          "source": {
            "type": "string",
            "enum": ["langwatch","databricks","copilot_studio","traffic"]
          },
          "management": {"type":"string","enum":["managed","discovered","observed"]},
          "kind": {"type":"string"},
          "name": {"type":"string"},
          "description": {"type":["string","null"]},
          "status": {"type":"string","enum":["active","removed"]},
          "shadow": {"type":"boolean"},
          "version": {"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},
          "source_version": {"type":["string","null"]},
          "project_id": {"type":["string","null"]},
          "environment": {"type":["string","null"]},
          "owner": {
            "anyOf": [
              {
                "type": "object",
                "properties": {"user_id":{"type":"string"},"name":{"type":["string","null"]}},
                "required": ["user_id","name"],
                "additionalProperties": false
              },
              {"type":"null"}
            ]
          },
          "endpoints": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {"type":"string","enum":["invoke","definition","console"]},
                "url": {"type":"string"},
                "protocol": {"type":"string"}
              },
              "required": ["kind","url","protocol"],
              "additionalProperties": false
            }
          },
          "model": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "provider": {"type":["string","null"]},
                  "model": {"type":"string"},
                  "parameters": {
                    "type": "object",
                    "propertyNames": {"type":"string"},
                    "additionalProperties": {"type":["string","number","boolean"]}
                  }
                },
                "required": ["provider","model","parameters"],
                "additionalProperties": false
              },
              {"type":"null"}
            ]
          },
          "instructions": {"type":["string","null"]},
          "capabilities": {"type":"array","items":{"type":"string"}},
          "tools": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {"type":"string"},
                "description": {"type":["string","null"]},
                "input_schema": {
                  "type": "object",
                  "propertyNames": {"type":"string"},
                  "additionalProperties": {}
                },
                "output_schema": {
                  "anyOf": [
                    {
                      "type": "object",
                      "propertyNames": {"type":"string"},
                      "additionalProperties": {}
                    },
                    {"type":"null"}
                  ]
                },
                "status": {"type":"string","enum":["active","deprecated"]},
                "deprecated_in_version": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991
                    },
                    {"type":"null"}
                  ]
                },
                "deprecated_at": {"type":["string","null"]}
              },
              "required": [
                "name",
                "description",
                "input_schema",
                "output_schema",
                "status",
                "deprecated_in_version",
                "deprecated_at"
              ],
              "additionalProperties": false
            }
          },
          "first_seen_at": {"type":"string"},
          "last_seen_at": {"type":["string","null"]},
          "updated_at": {"type":"string"},
          "removed_at": {"type":["string","null"]}
        },
        "required": [
          "id",
          "source",
          "management",
          "kind",
          "name",
          "description",
          "status",
          "shadow",
          "version",
          "source_version",
          "project_id",
          "environment",
          "owner",
          "endpoints",
          "model",
          "instructions",
          "capabilities",
          "tools",
          "first_seen_at",
          "last_seen_at",
          "updated_at",
          "removed_at"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {"type":["string","null"]}
  },
  "required": ["data","next_cursor"],
  "additionalProperties": false
}
```

### 400

Bad Request

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "type": {"type":"string"},
    "code": {"type":"string"},
    "message": {"type":"string"},
    "retryable": {"type":"boolean"},
    "meta": {
      "type": "object",
      "propertyNames": {"type":"string"},
      "additionalProperties": {}
    },
    "trace_id": {"type":"string"},
    "span_id": {"type":"string"},
    "trace": {
      "type": "object",
      "properties": {
        "traceId": {"type":"string"},
        "spanId": {"type":"string"},
        "traceUrl": {"type":"string"},
        "logsUrl": {"type":"string"}
      }
    },
    "tips": {"type":"array","items":{"type":"string"}},
    "docs_url": {"type":"string"},
    "fault": {
      "type": "string",
      "enum": ["customer","platform","provider","presumed_platform"]
    },
    "reasons": {"type":"array","items":{}}
  },
  "required": ["type","code","message","retryable"]
}
```

### 401

Unauthorized

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "type": {"type":"string"},
    "code": {"type":"string"},
    "message": {"type":"string"},
    "retryable": {"type":"boolean"},
    "meta": {
      "type": "object",
      "propertyNames": {"type":"string"},
      "additionalProperties": {}
    },
    "trace_id": {"type":"string"},
    "span_id": {"type":"string"},
    "trace": {
      "type": "object",
      "properties": {
        "traceId": {"type":"string"},
        "spanId": {"type":"string"},
        "traceUrl": {"type":"string"},
        "logsUrl": {"type":"string"}
      }
    },
    "tips": {"type":"array","items":{"type":"string"}},
    "docs_url": {"type":"string"},
    "fault": {
      "type": "string",
      "enum": ["customer","platform","provider","presumed_platform"]
    },
    "reasons": {"type":"array","items":{}}
  },
  "required": ["type","code","message","retryable"]
}
```

### 403

Forbidden

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "type": {"type":"string"},
    "code": {"type":"string"},
    "message": {"type":"string"},
    "retryable": {"type":"boolean"},
    "meta": {
      "type": "object",
      "propertyNames": {"type":"string"},
      "additionalProperties": {}
    },
    "trace_id": {"type":"string"},
    "span_id": {"type":"string"},
    "trace": {
      "type": "object",
      "properties": {
        "traceId": {"type":"string"},
        "spanId": {"type":"string"},
        "traceUrl": {"type":"string"},
        "logsUrl": {"type":"string"}
      }
    },
    "tips": {"type":"array","items":{"type":"string"}},
    "docs_url": {"type":"string"},
    "fault": {
      "type": "string",
      "enum": ["customer","platform","provider","presumed_platform"]
    },
    "reasons": {"type":"array","items":{}}
  },
  "required": ["type","code","message","retryable"]
}
```

### 422

Unprocessable Entity

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "type": {"type":"string"},
    "code": {"type":"string"},
    "message": {"type":"string"},
    "retryable": {"type":"boolean"},
    "meta": {
      "type": "object",
      "propertyNames": {"type":"string"},
      "additionalProperties": {}
    },
    "trace_id": {"type":"string"},
    "span_id": {"type":"string"},
    "trace": {
      "type": "object",
      "properties": {
        "traceId": {"type":"string"},
        "spanId": {"type":"string"},
        "traceUrl": {"type":"string"},
        "logsUrl": {"type":"string"}
      }
    },
    "tips": {"type":"array","items":{"type":"string"}},
    "docs_url": {"type":"string"},
    "fault": {
      "type": "string",
      "enum": ["customer","platform","provider","presumed_platform"]
    },
    "reasons": {"type":"array","items":{}}
  },
  "required": ["type","code","message","retryable"]
}
```

### 500

Internal Server Error

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "type": {"type":"string"},
    "code": {"type":"string"},
    "message": {"type":"string"},
    "retryable": {"type":"boolean"},
    "meta": {
      "type": "object",
      "propertyNames": {"type":"string"},
      "additionalProperties": {}
    },
    "trace_id": {"type":"string"},
    "span_id": {"type":"string"},
    "trace": {
      "type": "object",
      "properties": {
        "traceId": {"type":"string"},
        "spanId": {"type":"string"},
        "traceUrl": {"type":"string"},
        "logsUrl": {"type":"string"}
      }
    },
    "tips": {"type":"array","items":{"type":"string"}},
    "docs_url": {"type":"string"},
    "fault": {
      "type": "string",
      "enum": ["customer","platform","provider","presumed_platform"]
    },
    "reasons": {"type":"array","items":{}}
  },
  "required": ["type","code","message","retryable"]
}
```