PushizoDocs
API reference

Identity verification keys

Identity verification keys — 3 operations (GET /v1/apps/{appId}/identity-keys, POST /v1/apps/{appId}/identity-keys, DELETE /v1/apps/{appId}/identity-keys/{keyId}). Generated from the OpenAPI 3.1.0 contract.

Per-app ES256 public keys (kid) for JWT identity verification; your server signs SDK login tokens with the private half of these keys.

Base URL: https://api.pushizo.com · Tag: identity-keys · Interactive docs (Scalar)

Operations

MethodPathOperation
GET/v1/apps/{appId}/identity-keysSDK authentication (JWT) public keys
POST/v1/apps/{appId}/identity-keysAdd a public key (ES256)
DELETE/v1/apps/{appId}/identity-keys/{keyId}Revoke a public key

Details

SDK authentication (JWT) public keys

GET/v1/apps/{appId}/identity-keysTry it (interactive API docs, new tab)

Authentication: API key — scope admin (admin includes every scope).

Parameters

NameInTypeRequiredDescriptionExample
appIdpathstringYes"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

Responses

200 — Success.

Schema: IdentityKeyList

FieldTypeRequiredDescription
dataarray<object>Yes
data[].idstringYes
data[].kidstringYes
data[].alg"ES256"Yes
data[].public_jwkmap<string, string>Yes
data[].labelstring | nullYes
data[].created_atstringYes
data[].revoked_atstring | nullYes

Example response:

{
  "data": [
    {
      "id": "key_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "kid": "key-2026-10",
      "alg": "ES256",
      "public_jwk": {
        "key": "user_42"
      },
      "label": "external_id",
      "created_at": "örnek",
      "revoked_at": "örnek"
    }
  ]
}

Errors use the common envelope (error.code, message, details, request_id): error catalog. Every response carries X-RateLimit-* headers (rate limits).

Examples

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/identity-keys" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Add a public key (ES256)

POST/v1/apps/{appId}/identity-keysTry it (interactive API docs, new tab)

Adds an ES256 (EC P-256) public key for SDK JWT identity verification; the private key is never sent. Tokens are signed on your server (sub = external_id, aud = app_id, exp ≤ 24 hours) and carried in SDK requests via the Authorization: Bearer <jwt> header. The mode is selected with the identity_verification_mode app setting.

Authentication: API key — scope admin (admin includes every scope).

Parameters

NameInTypeRequiredDescriptionExample
appIdpathstringYes"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

Request body (required)

Schema: CreateIdentityKeyDto

FieldTypeRequiredDescription
kidstringNoLength: 1–64
labelstringNoLength: 0–80
public_jwkmap<string, any>No
public_key_pemstringNoLength: 0–4000

Example:

{
  "kid": "key-2026-10",
  "label": "external_id",
  "public_jwk": {
    "key": "örnek"
  },
  "public_key_pem": "örnek"
}

Responses

201 — Success.

Schema: IdentityKey

FieldTypeRequiredDescription
idstringYes
kidstringYes
alg"ES256"Yes
public_jwkmap<string, string>Yes
labelstring | nullYes
created_atstringYes
revoked_atstring | nullYes

Example response:

{
  "id": "key_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "kid": "key-2026-10",
  "alg": "ES256",
  "public_jwk": {
    "key": "user_42"
  },
  "label": "external_id",
  "created_at": "örnek",
  "revoked_at": "örnek"
}

Errors use the common envelope (error.code, message, details, request_id): error catalog. Every response carries X-RateLimit-* headers (rate limits).

Examples

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/identity-keys" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kid": "key-2026-10",
  "label": "external_id",
  "public_jwk": {
    "key": "örnek"
  },
  "public_key_pem": "örnek"
}'

Revoke a public key

DELETE/v1/apps/{appId}/identity-keys/{keyId}Try it (interactive API docs, new tab)

Authentication: API key — scope admin (admin includes every scope).

Parameters

NameInTypeRequiredDescriptionExample
keyIdpathstringYes"key_01JD3W5Q7X9K2M4N6P8R0T1V3W"
appIdpathstringYes"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

Responses

200 — Success.

Schema: IdentityKey

FieldTypeRequiredDescription
idstringYes
kidstringYes
alg"ES256"Yes
public_jwkmap<string, string>Yes
labelstring | nullYes
created_atstringYes
revoked_atstring | nullYes

Example response:

{
  "id": "key_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "kid": "key-2026-10",
  "alg": "ES256",
  "public_jwk": {
    "key": "user_42"
  },
  "label": "external_id",
  "created_at": "örnek",
  "revoked_at": "örnek"
}

Errors use the common envelope (error.code, message, details, request_id): error catalog. Every response carries X-RateLimit-* headers (rate limits).

Examples

curl -X DELETE "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/identity-keys/key_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

On this page