How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Authentik Authenticators API

Authenticator device management for TOTP, static, WebAuthn, SMS, email, Duo and endpoint devices, from both the admin and end-user perspectives.

Authentik Authenticators API is one of 27 APIs that Authentik publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include authenticators. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a GitHub repository.

This API exposes 83 operations across 37 paths, and defines 38 schemas. It is described by OpenAPI 3.2.0, at version 2026.11.0-rc1.

Requests are made against a single base URL, /api/v3.

83 operations 37 paths 38 schemas 13 DELETE37 GET13 PATCH7 POST13 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026.11.0-rc1
Base URL
https://{authentik_host}/api/v3
Authentication
HTTP Bearer, HTTP Bearer+Agent, HTTP Bearer, HTTP Bearer
License
Resource Areas
1

Authentication & Security 4

Authentik Authenticators API declares 4 security schemes for authenticating requests. It accepts HTTP bearer tokens (authentik). It uses HTTP bearer+agent authentication (authentik_device_auth). It accepts HTTP bearer tokens (authentik_device_enroll). It accepts HTTP bearer tokens (authentik_device_federation).

Paths & Operations 83

Across 37 paths, the API surfaces 83 operations — 13 DELETE, 37 GET, 13 PATCH, 7 POST, 13 PUT. Each is listed below with its method, path, parameters, and response codes.

authenticators 83
GET
/authenticators/admin/all/
Get all devices for current user
authenticators_admin_all_list 1 param → 200400403
GET
/authenticators/admin/duo/
Viewset for Duo authenticator devices (for admins)
authenticators_admin_duo_list 5 params → 200400403
POST
/authenticators/admin/duo/
Viewset for Duo authenticator devices (for admins)
authenticators_admin_duo_create body → 201400403
GET
/authenticators/admin/duo/{id}/
Viewset for Duo authenticator devices (for admins)
authenticators_admin_duo_retrieve 1 param → 200400403
PUT
/authenticators/admin/duo/{id}/
Viewset for Duo authenticator devices (for admins)
authenticators_admin_duo_update 1 param body → 200400403
PATCH
/authenticators/admin/duo/{id}/
Viewset for Duo authenticator devices (for admins)
authenticators_admin_duo_partial_update 1 param body → 200400403
DELETE
/authenticators/admin/duo/{id}/
Viewset for Duo authenticator devices (for admins)
authenticators_admin_duo_destroy 1 param → 204400403
GET
/authenticators/admin/email/
Viewset for email authenticator devices (for admins)
authenticators_admin_email_list 5 params → 200400403
POST
/authenticators/admin/email/
Viewset for email authenticator devices (for admins)
authenticators_admin_email_create body → 201400403
GET
/authenticators/admin/email/{id}/
Viewset for email authenticator devices (for admins)
authenticators_admin_email_retrieve 1 param → 200400403
PUT
/authenticators/admin/email/{id}/
Viewset for email authenticator devices (for admins)
authenticators_admin_email_update 1 param body → 200400403
PATCH
/authenticators/admin/email/{id}/
Viewset for email authenticator devices (for admins)
authenticators_admin_email_partial_update 1 param body → 200400403
DELETE
/authenticators/admin/email/{id}/
Viewset for email authenticator devices (for admins)
authenticators_admin_email_destroy 1 param → 204400403
GET
/authenticators/admin/endpoint/
Viewset for Endpoint authenticator devices (for admins)
authenticators_admin_endpoint_list 5 params → 200400403
POST
/authenticators/admin/endpoint/
Viewset for Endpoint authenticator devices (for admins)
authenticators_admin_endpoint_create body → 201400403
GET
/authenticators/admin/endpoint/{uuid}/
Viewset for Endpoint authenticator devices (for admins)
authenticators_admin_endpoint_retrieve 1 param → 200400403
PUT
/authenticators/admin/endpoint/{uuid}/
Viewset for Endpoint authenticator devices (for admins)
authenticators_admin_endpoint_update 1 param body → 200400403
PATCH
/authenticators/admin/endpoint/{uuid}/
Viewset for Endpoint authenticator devices (for admins)
authenticators_admin_endpoint_partial_update 1 param body → 200400403
DELETE
/authenticators/admin/endpoint/{uuid}/
Viewset for Endpoint authenticator devices (for admins)
authenticators_admin_endpoint_destroy 1 param → 204400403
GET
/authenticators/admin/sms/
Viewset for sms authenticator devices (for admins)
authenticators_admin_sms_list 5 params → 200400403
POST
/authenticators/admin/sms/
Viewset for sms authenticator devices (for admins)
authenticators_admin_sms_create body → 201400403
GET
/authenticators/admin/sms/{id}/
Viewset for sms authenticator devices (for admins)
authenticators_admin_sms_retrieve 1 param → 200400403
PUT
/authenticators/admin/sms/{id}/
Viewset for sms authenticator devices (for admins)
authenticators_admin_sms_update 1 param body → 200400403
PATCH
/authenticators/admin/sms/{id}/
Viewset for sms authenticator devices (for admins)
authenticators_admin_sms_partial_update 1 param body → 200400403
DELETE
/authenticators/admin/sms/{id}/
Viewset for sms authenticator devices (for admins)
authenticators_admin_sms_destroy 1 param → 204400403
GET
/authenticators/admin/static/
Viewset for static authenticator devices (for admins)
authenticators_admin_static_list 5 params → 200400403
POST
/authenticators/admin/static/
Viewset for static authenticator devices (for admins)
authenticators_admin_static_create body → 201400403
GET
/authenticators/admin/static/{id}/
Viewset for static authenticator devices (for admins)
authenticators_admin_static_retrieve 1 param → 200400403
PUT
/authenticators/admin/static/{id}/
Viewset for static authenticator devices (for admins)
authenticators_admin_static_update 1 param body → 200400403
PATCH
/authenticators/admin/static/{id}/
Viewset for static authenticator devices (for admins)
authenticators_admin_static_partial_update 1 param body → 200400403
DELETE
/authenticators/admin/static/{id}/
Viewset for static authenticator devices (for admins)
authenticators_admin_static_destroy 1 param → 204400403
GET
/authenticators/admin/totp/
Viewset for totp authenticator devices (for admins)
authenticators_admin_totp_list 5 params → 200400403
POST
/authenticators/admin/totp/
Viewset for totp authenticator devices (for admins)
authenticators_admin_totp_create body → 201400403
GET
/authenticators/admin/totp/{id}/
Viewset for totp authenticator devices (for admins)
authenticators_admin_totp_retrieve 1 param → 200400403
PUT
/authenticators/admin/totp/{id}/
Viewset for totp authenticator devices (for admins)
authenticators_admin_totp_update 1 param body → 200400403
PATCH
/authenticators/admin/totp/{id}/
Viewset for totp authenticator devices (for admins)
authenticators_admin_totp_partial_update 1 param body → 200400403
DELETE
/authenticators/admin/totp/{id}/
Viewset for totp authenticator devices (for admins)
authenticators_admin_totp_destroy 1 param → 204400403
GET
/authenticators/admin/webauthn/
Viewset for WebAuthn authenticator devices (for admins)
authenticators_admin_webauthn_list 5 params → 200400403
POST
/authenticators/admin/webauthn/
Viewset for WebAuthn authenticator devices (for admins)
authenticators_admin_webauthn_create body → 201400403
GET
/authenticators/admin/webauthn/{id}/
Viewset for WebAuthn authenticator devices (for admins)
authenticators_admin_webauthn_retrieve 1 param → 200400403
PUT
/authenticators/admin/webauthn/{id}/
Viewset for WebAuthn authenticator devices (for admins)
authenticators_admin_webauthn_update 1 param body → 200400403
PATCH
/authenticators/admin/webauthn/{id}/
Viewset for WebAuthn authenticator devices (for admins)
authenticators_admin_webauthn_partial_update 1 param body → 200400403
DELETE
/authenticators/admin/webauthn/{id}/
Viewset for WebAuthn authenticator devices (for admins)
authenticators_admin_webauthn_destroy 1 param → 204400403
GET
/authenticators/all/
Get all devices for current user
authenticators_all_list → 200400403
GET
/authenticators/duo/
Viewset for Duo authenticator devices
authenticators_duo_list 5 params → 200400403
GET
/authenticators/duo/{id}/
Viewset for Duo authenticator devices
authenticators_duo_retrieve 1 param → 200400403
PUT
/authenticators/duo/{id}/
Viewset for Duo authenticator devices
authenticators_duo_update 1 param body → 200400403
PATCH
/authenticators/duo/{id}/
Viewset for Duo authenticator devices
authenticators_duo_partial_update 1 param body → 200400403
DELETE
/authenticators/duo/{id}/
Viewset for Duo authenticator devices
authenticators_duo_destroy 1 param → 204400403
GET
/authenticators/duo/{id}/used_by/
Get a list of all objects that use this object
authenticators_duo_used_by_list 1 param → 200400403
GET
/authenticators/email/
Viewset for email authenticator devices
authenticators_email_list 5 params → 200400403
GET
/authenticators/email/{id}/
Viewset for email authenticator devices
authenticators_email_retrieve 1 param → 200400403
PUT
/authenticators/email/{id}/
Viewset for email authenticator devices
authenticators_email_update 1 param body → 200400403
PATCH
/authenticators/email/{id}/
Viewset for email authenticator devices
authenticators_email_partial_update 1 param body → 200400403
DELETE
/authenticators/email/{id}/
Viewset for email authenticator devices
authenticators_email_destroy 1 param → 204400403
GET
/authenticators/email/{id}/used_by/
Get a list of all objects that use this object
authenticators_email_used_by_list 1 param → 200400403
GET
/authenticators/endpoint/
Viewset for Endpoint authenticator devices
authenticators_endpoint_list 5 params → 200400403
GET
/authenticators/endpoint/{uuid}/
Viewset for Endpoint authenticator devices
authenticators_endpoint_retrieve 1 param → 200400403
GET
/authenticators/endpoint/{uuid}/used_by/
Get a list of all objects that use this object
authenticators_endpoint_used_by_list 1 param → 200400403
GET
/authenticators/sms/
Viewset for sms authenticator devices
authenticators_sms_list 5 params → 200400403
GET
/authenticators/sms/{id}/
Viewset for sms authenticator devices
authenticators_sms_retrieve 1 param → 200400403
PUT
/authenticators/sms/{id}/
Viewset for sms authenticator devices
authenticators_sms_update 1 param body → 200400403
PATCH
/authenticators/sms/{id}/
Viewset for sms authenticator devices
authenticators_sms_partial_update 1 param body → 200400403
DELETE
/authenticators/sms/{id}/
Viewset for sms authenticator devices
authenticators_sms_destroy 1 param → 204400403
GET
/authenticators/sms/{id}/used_by/
Get a list of all objects that use this object
authenticators_sms_used_by_list 1 param → 200400403
GET
/authenticators/static/
Viewset for static authenticator devices
authenticators_static_list 5 params → 200400403
GET
/authenticators/static/{id}/
Viewset for static authenticator devices
authenticators_static_retrieve 1 param → 200400403
PUT
/authenticators/static/{id}/
Viewset for static authenticator devices
authenticators_static_update 1 param body → 200400403
PATCH
/authenticators/static/{id}/
Viewset for static authenticator devices
authenticators_static_partial_update 1 param body → 200400403
DELETE
/authenticators/static/{id}/
Viewset for static authenticator devices
authenticators_static_destroy 1 param → 204400403
GET
/authenticators/static/{id}/used_by/
Get a list of all objects that use this object
authenticators_static_used_by_list 1 param → 200400403
GET
/authenticators/totp/
Viewset for totp authenticator devices
authenticators_totp_list 5 params → 200400403
GET
/authenticators/totp/{id}/
Viewset for totp authenticator devices
authenticators_totp_retrieve 1 param → 200400403
PUT
/authenticators/totp/{id}/
Viewset for totp authenticator devices
authenticators_totp_update 1 param body → 200400403
PATCH
/authenticators/totp/{id}/
Viewset for totp authenticator devices
authenticators_totp_partial_update 1 param body → 200400403
DELETE
/authenticators/totp/{id}/
Viewset for totp authenticator devices
authenticators_totp_destroy 1 param → 204400403
GET
/authenticators/totp/{id}/used_by/
Get a list of all objects that use this object
authenticators_totp_used_by_list 1 param → 200400403
GET
/authenticators/webauthn/
Viewset for WebAuthn authenticator devices
authenticators_webauthn_list 5 params → 200400403
GET
/authenticators/webauthn/{id}/
Viewset for WebAuthn authenticator devices
authenticators_webauthn_retrieve 1 param → 200400403
PUT
/authenticators/webauthn/{id}/
Viewset for WebAuthn authenticator devices
authenticators_webauthn_update 1 param body → 200400403
PATCH
/authenticators/webauthn/{id}/
Viewset for WebAuthn authenticator devices
authenticators_webauthn_partial_update 1 param body → 200400403
DELETE
/authenticators/webauthn/{id}/
Viewset for WebAuthn authenticator devices
authenticators_webauthn_destroy 1 param → 204400403
GET
/authenticators/webauthn/{id}/used_by/
Get a list of all objects that use this object
authenticators_webauthn_used_by_list 1 param → 200400403

Schemas 38

The contract defines 38 schemas that model the data the API accepts and returns. The most detailed are Device (12 properties), PartialUser (8 properties), Pagination (7 properties), WebAuthnDevice (6 properties). Each schema is shown below with its type and property counts.

PaginatedDuoDeviceList
object
3 properties 3 required
PatchedEmailDeviceRequest
object
Serializer for email authenticator devices
1 property
PaginatedStaticDeviceList
object
3 properties 3 required
WebAuthnDeviceType
object
WebAuthnDeviceType Serializer
2 properties 2 required
GoogleEndpointDevice
object
Serializer for Endpoint authenticator devices
2 properties 1 required
PatchedWebAuthnDeviceRequest
object
Serializer for WebAuthn authenticator devices
1 property
PaginatedGoogleEndpointDeviceList
object
3 properties 3 required
PaginatedTOTPDeviceList
object
3 properties 3 required
EmailDeviceRequest
object
Serializer for email authenticator devices
1 property 1 required
GoogleEndpointDeviceRequest
object
Serializer for Endpoint authenticator devices
2 properties 1 required
PaginatedSMSDeviceList
object
3 properties 3 required
Pagination
object
7 properties 7 required
PatchedStaticDeviceRequest
object
Serializer for static authenticator devices
1 property
TOTPDevice
object
Serializer for totp authenticator devices
3 properties 3 required
ValidationError
object
Validation Error
2 properties
WebAuthnDevice
object
Serializer for WebAuthn authenticator devices
6 properties 6 required
StaticDevice
object
Serializer for static authenticator devices
4 properties 4 required
UsedByActionEnum
string
PaginatedWebAuthnDeviceList
object
3 properties 3 required
WebAuthnDeviceRequest
object
Serializer for WebAuthn authenticator devices
1 property 1 required
Autocomplete
object
StaticDeviceToken
object
Serializer for static device's tokens
1 property 1 required
StaticDeviceRequest
object
Serializer for static authenticator devices
1 property 1 required
PatchedGoogleEndpointDeviceRequest
object
Serializer for Endpoint authenticator devices
2 properties
PatchedSMSDeviceRequest
object
Serializer for sms authenticator devices
1 property
SMSDeviceRequest
object
Serializer for sms authenticator devices
1 property 1 required
PaginatedEmailDeviceList
object
3 properties 3 required
DuoDevice
object
Serializer for Duo authenticator devices
3 properties 3 required
PatchedTOTPDeviceRequest
object
Serializer for totp authenticator devices
1 property
PartialUser
object
Partial User Serializer, does not include child relations.
8 properties 4 required
EmailDevice
object
Serializer for email authenticator devices
4 properties 4 required
PatchedDuoDeviceRequest
object
Serializer for Duo authenticator devices
1 property
DuoDeviceRequest
object
Serializer for Duo authenticator devices
1 property 1 required
Device
object
Serializer for authenticator devices
12 properties 12 required
TOTPDeviceRequest
object
Serializer for totp authenticator devices
1 property 1 required
UsedBy
object
A list of all objects referencing the queried object
5 properties 5 required
GenericError
object
Generic API Error
2 properties 1 required
SMSDevice
object
Serializer for sms authenticator devices
4 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

authentik-authenticators-api-openapi.yml Raw ↑

Other APIs Authentik publishes across the network.

Authentik Core API
Authentik Crypto API
Authentik Events API
Authentik Flows API
Authentik Policies API
Authentik Providers API
Authentik RBAC API
Authentik Schema API
Authentik Sources API
Authentik Stages API
Authentik Admin API
Authentik Agents API
Where this information came from

This is an independent, third-party profile of Authentik Authenticators API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.