# Granite Auth API

**Canonical:** https://apis.io/apis/granite-md/granite-md-auth-api/  
**Provider:** Granite — https://apis.io/providers/granite-md/  
**Base URL:** https://api.granite.md  
**Documentation:** https://docs.granite.md/

Granite Auth API is one of 19 APIs that [Granite](https://apis.io/providers/granite-md/) 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.

Sign-up, login, sessions, and password reset.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/auth/signup` | Create an account |
| POST | `/v1/auth/signup/confirm` | Confirm a sign-up with the emailed code and sign in |
| POST | `/v1/auth/verify-email` | Confirm an email address |
| POST | `/v1/auth/verify-email/resend` | Send a new verification email |
| POST | `/v1/auth/login` | Sign in |
| POST | `/v1/auth/sso/start` | Start single sign-on |
| POST | `/v1/auth/sso/finish` | Finish single sign-on |
| POST | `/v1/auth/refresh` | Get new tokens |
| POST | `/v1/auth/logout` | Sign out this device |
| POST | `/v1/auth/password-reset` | Email a password reset link or code |
| POST | `/v1/auth/password-reset/confirm` | Set a new password |
| POST | `/v1/auth/password-reset/code/check` | Check an emailed reset code |
| POST | `/v1/auth/password-reset/code/confirm` | Set a new password with an emailed code and sign in |
| POST | `/v1/auth/login/2fa` | Finish signing in with a second factor |
| POST | `/v1/auth/step-up` | Confirm the password for sensitive actions |
| POST | `/v1/auth/app-handoff` | Hand a sign-in to the desktop app |
| POST | `/v1/auth/app-handoff/finish` | Redeem a sign-in handed to the app |
| POST | `/v1/auth/oidc/{provider}` | Sign in with Google or Apple |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/granite-md/openapi/granite-md-auth-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/granite-md/json-schema/granite-md-social-login-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/granite-md/apis.yml

## Other Granite APIs (12)

- [Granite Billing API](https://apis.io/apis/granite-md/granite-md-billing-api/)
- [Granite Comments API](https://apis.io/apis/granite-md/granite-md-comments-api/)
- [Granite Drive API](https://apis.io/apis/granite-md/granite-md-drive-api/)
- [Granite Folders API](https://apis.io/apis/granite-md/granite-md-folders-api/)
- [Granite knowledge base API](https://apis.io/apis/granite-md/granite-md-knowledge-base-api/)
- [Granite Me API](https://apis.io/apis/granite-md/granite-md-me-api/)
- [Granite Meta API](https://apis.io/apis/granite-md/granite-md-meta-api/)
- [Granite Note Shares API](https://apis.io/apis/granite-md/granite-md-note-shares-api/)
- [Granite Notes API](https://apis.io/apis/granite-md/granite-md-notes-api/)
- [Granite OAuth API](https://apis.io/apis/granite-md/granite-md-oauth-api/)
- [Granite Publish API](https://apis.io/apis/granite-md/granite-md-publish-api/)
- [Granite Search API](https://apis.io/apis/granite-md/granite-md-search-api/)

## Tags

Authentication

---

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