# ColdState Auth API

**Canonical:** https://apis.io/apis/coldstate-ai/coldstate-ai-auth-api/  
**Provider:** ColdState — https://apis.io/providers/coldstate-ai/  
**Base URL:** https://cold-api.coldstate.ai  
**Documentation:** https://services.coldstate.ai/docs

ColdState Auth API is one of 8 APIs that [ColdState](https://apis.io/providers/coldstate-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 3 JSON Schema definitions. Tagged areas include Authentication. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and 3 JSON Schemas.

Accounts, sessions, API keys

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/auth/register` | Create an account (returns first API key) |
| POST | `/v1/auth/login` | Log in (returns a dashboard session token) |
| POST | `/v1/auth/forgot-password` | Request a password reset email |
| POST | `/v1/auth/reset-password` | Consume a reset token |
| GET | `/v1/auth/keys` | List API keys (prefixes only) |
| POST | `/v1/auth/keys/create` | Create an additional API key |
| POST | `/v1/auth/keys/rotate` | Deactivate all keys and issue a new one |
| DELETE | `/v1/auth/keys/{keyId}` | Delete a key |
| POST | `/v1/auth/keys/{keyId}/deactivate` | Deactivate a key |
| POST | `/v1/auth/logout` | Revoke the current session |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/coldstate-ai/openapi/coldstate-ai-auth-api-openapi.yml
- **Documentation** — https://services.coldstate.ai/docs
- **GettingStarted** — https://services.coldstate.ai/docs/quickstart
- **LLMsTxt** — https://cold-api.coldstate.ai/llms.txt
- **JSONSchema** — https://artifacts.apis.io/coldstate-ai/json-schema/coldstate-ai-register-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/coldstate-ai/json-schema/coldstate-ai-auth-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/coldstate-ai/json-schema/coldstate-ai-login-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/coldstate-ai/apis.yml

## Other ColdState APIs (7)

- [ColdState Billing API](https://apis.io/apis/coldstate-ai/coldstate-ai-billing-api/)
- [ColdState Indexes API](https://apis.io/apis/coldstate-ai/coldstate-ai-indexes-api/)
- [ColdState Knowledge API](https://apis.io/apis/coldstate-ai/coldstate-ai-knowledge-api/)
- [ColdState MCP API](https://apis.io/apis/coldstate-ai/coldstate-ai-mcp-api/)
- [ColdState Meta API](https://apis.io/apis/coldstate-ai/coldstate-ai-meta-api/)
- [ColdState Search API](https://apis.io/apis/coldstate-ai/coldstate-ai-search-api/)
- [ColdState Usage API](https://apis.io/apis/coldstate-ai/coldstate-ai-usage-api/)

## Tags

Authentication

---

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