---
title: "Identify the calling agent (agent-auth address)"
method: GET
path: "/agent/identity"
tags: ["agents"]
---

# Identify the calling agent (agent-auth address)

`GET /agent/identity`

## Request

- Base URL: `https://justautomate.ai`
- URL: `https://justautomate.ai/agent/identity`
- Auth: OAuth 2 (authorization code, authorization URL `https://justautomate.ai/oauth/authorize/`, token URL `https://justautomate.ai/oauth/token/`, scopes: `mcp:read`)

Same as getAgentIdentity, at the address agent-auth clients look for.

## Response `200`

The agent behind the token.

- AgentIdentity
  - `authenticated` true, required
  - `sub` string, required: Agent identifier from the token.
  - `scope` string, required
  - `resource` string, uri, required
  - `rateLimit` object, required
    - `policy` string, required
    - `limit` integer, required
    - `windowSeconds` integer, required

## Other responses

- `401`: A bearer token is required (code unauthorized).
- `429`: Rate limit exceeded (code rate-limited). Wait Retry-After seconds.
- `500`: Unexpected error (code internal-error). Retry later.

---

[API](https://skmtc.dev/justautomate/apis/justautomate-public-api.md) · [All operations](https://skmtc.dev/justautomate/apis/justautomate-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/justautomate/apis/justautomate-public-api/revisions/b42d0226be7e?raw)