---
title: "Agent-native login: present a Touchstone-scoped Colony id_token (RFC 8693 token-exchange, audience = Touchstone's client_id) to establish a session, no browser"
method: POST
path: "/auth/colony/agent"
---

# Agent-native login: present a Touchstone-scoped Colony id_token (RFC 8693 token-exchange, audience = Touchstone's client_id) to establish a session, no browser

`POST /auth/colony/agent`

## Request

- Base URL: `https://touchstone.cv`
- URL: `https://touchstone.cv/auth/colony/agent`
- Auth: HTTP bearer

## Response `200`

Session established; returns the resolved Colony identity

## Other responses

- `401`: Missing id_token, or id_token verification failed (e.g. raw or wrong-audience token)

---

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