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
| Method | Path | Operation |
|---|---|---|
GET | /v1/apps/{appId}/identity-keys | SDK authentication (JWT) public keys |
POST | /v1/apps/{appId}/identity-keys | Add a public key (ES256) |
DELETE | /v1/apps/{appId}/identity-keys/{keyId} | Revoke a public key |
Details
SDK authentication (JWT) public keys
Authentication: API key — scope admin (admin includes every scope).
Parameters
| Name | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
appId | path | string | Yes | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Responses
200 — Success.
Schema: IdentityKeyList
| Field | Type | Required | Description |
|---|---|---|---|
data | array<object> | Yes | |
data[].id | string | Yes | |
data[].kid | string | Yes | |
data[].alg | "ES256" | Yes | |
data[].public_jwk | map<string, string> | Yes | |
data[].label | string | null | Yes | |
data[].created_at | string | Yes | |
data[].revoked_at | string | null | Yes |
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)
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
| Name | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
appId | path | string | Yes | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Request body (required)
Schema: CreateIdentityKeyDto
| Field | Type | Required | Description |
|---|---|---|---|
kid | string | No | Length: 1–64 |
label | string | No | Length: 0–80 |
public_jwk | map<string, any> | No | |
public_key_pem | string | No | Length: 0–4000 |
Example:
{
"kid": "key-2026-10",
"label": "external_id",
"public_jwk": {
"key": "örnek"
},
"public_key_pem": "örnek"
}Responses
201 — Success.
Schema: IdentityKey
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
kid | string | Yes | |
alg | "ES256" | Yes | |
public_jwk | map<string, string> | Yes | |
label | string | null | Yes | |
created_at | string | Yes | |
revoked_at | string | null | Yes |
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
Authentication: API key — scope admin (admin includes every scope).
Parameters
| Name | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
keyId | path | string | Yes | "key_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | path | string | Yes | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Responses
200 — Success.
Schema: IdentityKey
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
kid | string | Yes | |
alg | "ES256" | Yes | |
public_jwk | map<string, string> | Yes | |
label | string | null | Yes | |
created_at | string | Yes | |
revoked_at | string | null | Yes |
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"API keys
API keys — 5 operations (GET /v1/apps/{appId}/api-keys, POST /v1/apps/{appId}/api-keys, PATCH /v1/apps/{appId}/api-keys/{keyId}, …). Generated from the OpenAPI 3.1.0 contract.
Channels
Channels — 6 operations (POST /v1/apps/{appId}/messenger-links, GET /v1/apps/{appId}/channels, GET /v1/apps/{appId}/channels/status, …). Generated from the OpenAPI 3.1.0 contract.