Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

emnify subpackage_authentication API

The subpackage_authentication API from emnify — 8 operation(s) for subpackage_authentication.

emnify subpackage_authentication API is one of 29 APIs that emnify publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 5 JSON Schema definitions.

Tagged areas include subpackage_authentication. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 5 JSON Schemas.

This API exposes 8 operations across 8 paths, and defines 21 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://cdn.emnify.net.

8 operations 8 paths 21 schemas 2 DELETE3 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Server
https://cdn.emnify.net
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

emnify subpackage_authentication API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Retrieve a JWT via POST /api/v1/authenticate using an applicationtoken or user credentials, then send it as Authorization: Bearer .

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 2 DELETE, 3 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

subpackage_authentication 8
POST
/api/v1/authenticate
Retrieve authentication token
authenticate body → 200400401404
POST
/api/v1/user/mfa
Create an MFA key
post-mfa 1 param body → 200409422
GET
/api/v1/user/mfa/status
List MFA key statuses
user-mfa-status-get 1 param → 200
GET
/api/v1/user/mfa/type
List MFA key types
user-mfa-type-get 1 param → 200
PATCH
/api/v1/user/mfa/{key_id}
Activate MFA key
user-mfa-by-id-patch 2 params body → 204404409422
GET
/api/v1/user/{user_id}/mfa/trusted_device
List trusted devices
user-mfa-trusted-device-by-user-id-get 2 params → 200404
DELETE
/api/v1/user/{user_id}/mfa/trusted_device/{device_id}
Delete a trusted device
user-mfa-trusted-device-by-user-id-and-device-id-delete 3 params → 204404
DELETE
/api/v1/user/{user_id}/mfa/{key_id}
Delete an MFA key
user-mfa-by-user-id-and-key-id-delete 3 params → 204404

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are Authentication_postMfa_Response_200 (6 properties), ApiV1UserUserIdMfaTrustedDeviceGetResponsesContentApplicationJsonSchemaItems (4 properties), PostMfaRequestUnprocessableEntityError (4 properties), ApiV1AuthenticatePostRequestBodyContentApplicationJsonSchemaTrustedDevice (4 properties). Each schema is shown below with its type and property counts.

ApiV1UserMfaPostResponsesContentApplicationJsonSchemaErrorsItems
object
UserMfaByIdPatchRequestNotFoundError
object
3 properties
UserMfaTrustedDeviceByUserIdGetRequestNotFoundError
object
3 properties
PostMfaRequestUnprocessableEntityError
object
4 properties
AuthenticateRequestNotFoundError
object
3 properties
ApiV1UserMfaKeyIdPatchRequestBodyContentApplicationJsonSchemaStatus
object
The target status for the MFA key.
1 property 1 required
UserMfaByIdPatchRequestUnprocessableEntityError
object
3 properties
ApiV1UserMfaPostRequestBodyContentApplicationJsonSchemaType
object
UserMfaByIdPatchRequestConflictError
object
3 properties
Authentication_Authenticate_Response_200
object
3 properties
ApiV1UserUserIdMfaTrustedDeviceGetResponsesContentApplicationJsonSchemaItems
object
4 properties
UserMfaByUserIdAndKeyIdDeleteRequestNotFoundError
object
3 properties
ApiV1UserMfaPostResponsesContentApplicationJsonSchemaType
object
2 properties
PostMfaRequestConflictError
object
3 properties
ApiV1UserMfaTypeGetResponsesContentApplicationJsonSchemaItems
object
2 properties
ApiV1UserMfaStatusGetResponsesContentApplicationJsonSchemaItems
object
2 properties
UserMfaTrustedDeviceByUserIdAndDeviceIdDeleteRequestNotFoundError
object
3 properties
AuthenticateRequestUnauthorizedError
object
3 properties
Authentication_postMfa_Response_200
object
6 properties
ApiV1UserMfaPostResponsesContentApplicationJsonSchemaStatus
object
2 properties
ApiV1AuthenticatePostRequestBodyContentApplicationJsonSchemaTrustedDevice
object
Device information to register as trusted (90-day MFA exemption)
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

emnify-subpackage-authentication-api-openapi.yml Raw ↑

Other APIs emnify publishes across the network.

emnify GraphQL API
emnify Data Streamer
emnify Documentation MCP Server
emnify subpackage_applicationTokens API
emnify subpackage_automations API
emnify subpackage_cloudConnect API
emnify subpackage_customEvents API
emnify subpackage_endpoint API
emnify subpackage_euicc API
emnify subpackage_euiccOperation API
emnify subpackage_events API
emnify subpackage_integrations API