# esyURL Auth API

**Canonical:** https://apis.io/apis/esyurl-fyi/esyurl-fyi-auth-api/  
**Provider:** esyURL — https://apis.io/providers/esyurl-fyi/  
**Base URL:** https://esyurl.fyi  
**Documentation:** https://esyurl.fyi/llms.txt

esyURL Auth API is one of 8 APIs that [esyURL](https://apis.io/providers/esyurl-fyi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Authentication. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

The auth API from esyURL — 7 operation(s) for auth.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| GET | `/auth.md` | auth.md: how an agent signs itself up (the agentic-registration skill document) |
| GET | `/.well-known/oauth-protected-resource` | Protected Resource Metadata (RFC 9728) |
| GET | `/.well-known/oauth-authorization-server` | Authorization Server Metadata (RFC 8414) with the auth.md `agent_auth` block |
| POST | `/agent/identity` | Register an agent: creates a tenant, returns an identity_assertion |
| POST | `/agent/identity/claim` | Start the claim ceremony: emails a sign-in link to the human, returns the… |
| POST | `/oauth2/token` | Exchange an identity_assertion for an esy_ API key, or poll the claim ceremony |
| POST | `/oauth2/revoke` | Revoke an API key (RFC 7009); 200 whether or not it existed |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/esyurl-fyi/openapi/esyurl-fyi-auth-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/esyurl-fyi/json-schema/esyurl-fyi-agent-registration-schema.json
- **APIsJSON** — https://artifacts.apis.io/esyurl-fyi/apis.yml

## Other esyURL APIs (7)

- [esyURL Domain API](https://apis.io/apis/esyurl-fyi/esyurl-fyi-domain-api/)
- [esyURL Groups API](https://apis.io/apis/esyurl-fyi/esyurl-fyi-groups-api/)
- [esyURL Links API](https://apis.io/apis/esyurl-fyi/esyurl-fyi-links-api/)
- [esyURL MCP API](https://apis.io/apis/esyurl-fyi/esyurl-fyi-mcp-api/)
- [esyURL Me API](https://apis.io/apis/esyurl-fyi/esyurl-fyi-me-api/)
- [esyURL Public API](https://apis.io/apis/esyurl-fyi/esyurl-fyi-public-api/)
- [esyURL Render API](https://apis.io/apis/esyurl-fyi/esyurl-fyi-render-api/)

## Tags

Authentication

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/esyurl-fyi/esyurl-fyi-auth-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/esyurl-fyi/.