WorkOS · Schema

AuthenticationChallenge

AuthenticationIdentity ProviderSSOSAMLOIDCSCIMDirectory SyncAuthorizationFGAAudit LogsMFAB2B SaaSAgentsMCP

Properties

Name	Type	Description
object	string	Distinguishes the authentication challenge object.
id	string	The unique ID of the authentication challenge.
expires_at	string	The timestamp when the challenge will expire. Does not apply to TOTP factors.
code	string	The one-time code for the challenge.
authentication_factor_id	string	The unique ID of the authentication factor the challenge belongs to.
created_at	string	An ISO 8601 timestamp.
updated_at	string	An ISO 8601 timestamp.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/AuthenticationChallenge",
  "title": "AuthenticationChallenge",
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "description": "Distinguishes the authentication challenge object.",
      "const": "authentication_challenge"
    },
    "id": {
      "type": "string",
      "description": "The unique ID of the authentication challenge.",
      "example": "auth_challenge_01FVYZ5QM8N98T9ME5BCB2BBMJ"
    },
    "expires_at": {
      "format": "date-time",
      "type": "string",
      "description": "The timestamp when the challenge will expire. Does not apply to TOTP factors.",
      "example": "2026-01-15T12:00:00.000Z"
    },
    "code": {
      "type": "string",
      "description": "The one-time code for the challenge.",
      "example": "123456"
    },
    "authentication_factor_id": {
      "type": "string",
      "description": "The unique ID of the authentication factor the challenge belongs to.",
      "example": "auth_factor_01FVYZ5QM8N98T9ME5BCB2BBMJ"
    },
    "created_at": {
      "format": "date-time",
      "type": "string",
      "description": "An ISO 8601 timestamp.",
      "example": "2026-01-15T12:00:00.000Z"
    },
    "updated_at": {
      "format": "date-time",
      "type": "string",
      "description": "An ISO 8601 timestamp.",
      "example": "2026-01-15T12:00:00.000Z"
    }
  },
  "required": [
    "object",
    "id",
    "authentication_factor_id",
    "created_at",
    "updated_at"
  ]
}