# Kardinal Authenticate API

**Canonical:** https://apis.io/apis/kardinal/kardinal-authenticate-api/  
**Provider:** Kardinal — https://apis.io/providers/kardinal/  
**Base URL:** https://app.kardinal.ai/api/v2  
**Documentation:** https://developers.kardinal.ai/

Kardinal Authenticate API is one of 8 APIs that [Kardinal](https://apis.io/providers/kardinal/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Authenticate. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

How to authenticate, and manage the access and refresh tokens.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/public_key` | Get the public key which can be used to check the tokens |
| POST | `/auth/password/requestToken` | Request a password token |
| POST | `/auth/password/validateToken` | Check if a password token is valid |
| POST | `/auth/password/reset` | Reset a password for a user |
| GET | `/auth/mfa/config` | Fetch the actor's MFA config |
| POST | `/auth/mfa/disable` | Disable an OTP type in the actor's MFA config |
| POST | `/auth/mfa/request` | Request the update of the actor's MFA config |
| POST | `/auth/mfa/resendOTP` | Request a new OTP code for the MFA config update validation |
| POST | `/auth/mfa/validate` | Validate the update of the actor's MFA config |
| PUT | `/auth/mfa/preferredType` | Sets the actor's preferred OTP type in his MFA config |
| PUT | `/auth/mfa/regenerateBackupCodes` | Regenerate the actor's backup codes |
| GET | `/login/methods` | Retrieve the available login methods for a given username |
| POST | `/login` | Login (returns an OTP token if MFA is configured for the user) |
| POST | `/login/otp` | Confirm login with OTP |
| POST | `/login/resendOTP` | Request a new OTP code for login |
| POST | `/login/refresh` | Refresh the access token |
| POST | `/login/sso/azure` | Login with Azure SSO |
| POST | `/login/sso/google` | Login with Google SSO |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/openapi/kardinal-authenticate-api-openapi.yml
- **Documentation** — https://developers.kardinal.ai/
- **APIReference** — https://developers.kardinal.ai/api-reference/authenticate/request-a-password-token
- **GettingStarted** — https://developers.kardinal.ai/getting-started/first-api-call
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/authentication/kardinal-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/errors/kardinal-error-codes.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/data-model/kardinal-data-model.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/mcp/kardinal-tool-crosswalk.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/kardinal/refs/heads/main/apis.yml

## Other Kardinal APIs (7)

- [Kardinal Core API](https://apis.io/apis/kardinal/kardinal-core-api/)
- [Kardinal Management API](https://apis.io/apis/kardinal/kardinal-management-api/)
- [Kardinal Order API](https://apis.io/apis/kardinal/kardinal-order-api/)
- [Kardinal Plan API](https://apis.io/apis/kardinal/kardinal-plan-api/)
- [Kardinal Resource API](https://apis.io/apis/kardinal/kardinal-resource-api/)
- [Kardinal Simple Plan API](https://apis.io/apis/kardinal/kardinal-simpleplan-api/)
- [Kardinal Solution API](https://apis.io/apis/kardinal/kardinal-solution-api/)

## Tags

Authenticate

---

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