Stytch · Schema

Stytch M2M Client

A machine-to-machine OAuth 2.0 client used for service-to-service authentication via the client_credentials grant. Each client mints short-lived JWT access tokens scoped to a defined set of resources.

AuthenticationIdentityPasswordlessSecurityB2BConnected AppsMCPAI AgentsDeveloper Tools

Properties

Name Type Description
client_id string Identifier used in OAuth token requests.
client_secret string Returned only at creation and rotation.
client_name string
client_description string
status string
scopes array Scopes minted into the access token JWT (e.g. read:invoices, write:invoices).
trusted_metadata object
created_at string
next_rotation_started_at string Timestamp marking the start of an in-progress secret rotation.
View JSON Schema on GitHub

JSON Schema

stytch-m2m-client-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/stytch/main/json-schema/stytch-m2m-client-schema.json",
  "title": "Stytch M2M Client",
  "description": "A machine-to-machine OAuth 2.0 client used for service-to-service authentication via the client_credentials grant. Each client mints short-lived JWT access tokens scoped to a defined set of resources.",
  "type": "object",
  "required": ["client_id", "scopes"],
  "properties": {
    "client_id": {
      "type": "string",
      "description": "Identifier used in OAuth token requests."
    },
    "client_secret": {
      "type": "string",
      "description": "Returned only at creation and rotation.",
      "writeOnly": true
    },
    "client_name": {
      "type": "string"
    },
    "client_description": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": ["active", "inactive"]
    },
    "scopes": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Scopes minted into the access token JWT (e.g. read:invoices, write:invoices)."
    },
    "trusted_metadata": { "type": "object" },
    "created_at": { "type": "string", "format": "date-time" },
    "next_rotation_started_at": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp marking the start of an in-progress secret rotation."
    }
  }
}