feature-flags
feature-flags — 6 operations (GET /v1/apps/{appId}/feature-flags, POST /v1/apps/{appId}/feature-flags, POST /v1/apps/{appId}/feature-flags/evaluate, …). Generated from the OpenAPI 3.1.0 contract.
Base URL: https://api.pushizo.com · Tag: feature-flags · Interactive docs (Scalar)
Operations
| Method | Path | Operation |
|---|---|---|
GET | /v1/apps/{appId}/feature-flags | Feature flags |
POST | /v1/apps/{appId}/feature-flags | Create a flag |
POST | /v1/apps/{appId}/feature-flags/evaluate | Evaluate flags for a user |
GET | /v1/apps/{appId}/feature-flags/{flagId} | Flag details |
PATCH | /v1/apps/{appId}/feature-flags/{flagId} | Update a flag |
DELETE | /v1/apps/{appId}/feature-flags/{flagId} | Delete a flag |
Details
Feature flags
Authentication: API key — scope analytics:read (admin includes every scope).
Parameters
| Name | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
appId | path | string | Yes | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Responses
200 — Success.
Schema: AppFlagList
| Field | Type | Required | Description |
|---|---|---|---|
data | array<object> | Yes | |
data[].id | string | Yes | |
data[].app_id | string | Yes | |
data[].key | string | Yes | |
data[].name | string | Yes | |
data[].description | string | null | Yes | |
data[].enabled | boolean | Yes | |
data[].value_type | enum | Yes | Values: "boolean", "string", "number", "json" |
data[].on_value | boolean | number | string | array<any> | map<string, any> | Yes | |
data[].off_value | boolean | number | string | array<any> | map<string, any> | Yes | |
data[].rollout_percent | integer | Yes | |
data[].segment_id | string | null | Yes | |
data[].rollout_schedule | array<object> | Yes | |
data[].rollout_schedule[].at | string | Yes | |
data[].rollout_schedule[].percent | integer | Yes | |
data[].created_at | string | Yes | |
data[].updated_at | string | Yes |
Example response:
{
"data": [
{
"name": "Sipariş bildirimleri",
"enabled": true,
"id": "id_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"key": "key-2026-10",
"description": "Sipariş durumu güncellemeleri",
"value_type": "boolean",
"on_value": true,
"off_value": true,
"rollout_percent": 1,
"segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"rollout_schedule": [
{
"at": "örnek",
"percent": 1
}
],
"created_at": "örnek",
"updated_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/feature-flags" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"Create a flag
Values can be read by anyone who knows the app ID; do not store secrets.
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: CreateAppFlagDto
| Field | Type | Required | Description |
|---|---|---|---|
key | string | Yes | |
name | string | Yes | Length: 1–100 |
description | string | null | No | |
enabled | boolean | No | |
value_type | enum | No | Values: "boolean", "string", "number", "json" |
on_value | boolean | number | string | array<any> | map<string, any> | No | |
off_value | boolean | number | string | array<any> | map<string, any> | No | |
rollout_percent | integer | No | Range: 0–100 |
segment_id | string | null | No | |
rollout_schedule | array<object> | No | Items: 0–10 |
rollout_schedule[].at | string (date-time) | Yes | |
rollout_schedule[].percent | integer | Yes | Range: 0–100 |
Example:
{
"name": "Sipariş bildirimleri",
"key": "key-2026-10",
"enabled": true,
"description": "Sipariş durumu güncellemeleri",
"value_type": "boolean",
"on_value": true,
"off_value": true
}Responses
201 — Success.
Schema: AppFlag
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
app_id | string | Yes | |
key | string | Yes | |
name | string | Yes | |
description | string | null | Yes | |
enabled | boolean | Yes | |
value_type | enum | Yes | Values: "boolean", "string", "number", "json" |
on_value | boolean | number | string | array<any> | map<string, any> | Yes | |
off_value | boolean | number | string | array<any> | map<string, any> | Yes | |
rollout_percent | integer | Yes | |
segment_id | string | null | Yes | |
rollout_schedule | array<object> | Yes | |
rollout_schedule[].at | string | Yes | |
rollout_schedule[].percent | integer | Yes | |
created_at | string | Yes | |
updated_at | string | Yes |
Example response:
{
"name": "Sipariş bildirimleri",
"enabled": true,
"id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"key": "key-2026-10",
"description": "Sipariş durumu güncellemeleri",
"value_type": "boolean",
"on_value": true,
"off_value": true,
"rollout_percent": 1,
"segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"rollout_schedule": [
{
"at": "örnek",
"percent": 1
}
],
"created_at": "örnek",
"updated_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/feature-flags" \
-H "Authorization: Bearer $PUSHIZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Sipariş bildirimleri",
"key": "key-2026-10",
"enabled": true,
"description": "Sipariş durumu güncellemeleri",
"value_type": "boolean",
"on_value": true,
"off_value": true
}'Evaluate flags for a user
Authentication: API key — scope analytics:read (admin includes every scope).
Parameters
| Name | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
appId | path | string | Yes | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Request body (required)
Schema: EvaluateAppFlagsDto
| Field | Type | Required | Description |
|---|---|---|---|
external_id | string | No | Length: 1–255 |
user_id | string | No | Length: 1–64 |
subject | string | No | Length: 1–128 |
Example:
{
"external_id": "user_42",
"user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"subject": "Siparişiniz yola çıktı"
}Responses
200 — Success.
Schema: AppFlagEvaluation
| Field | Type | Required | Description |
|---|---|---|---|
flags | map<string, object> | Yes |
Example response:
{
"flags": {
"key": {
"enabled": true,
"value": true,
"reason": "on"
}
}
}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/feature-flags/evaluate" \
-H "Authorization: Bearer $PUSHIZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"external_id": "user_42",
"user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"subject": "Siparişiniz yola çıktı"
}'Flag details
Authentication: API key — scope analytics:read (admin includes every scope).
Parameters
| Name | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
flagId | path | string | Yes | "id_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | path | string | Yes | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Responses
200 — Success.
Schema: AppFlag
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
app_id | string | Yes | |
key | string | Yes | |
name | string | Yes | |
description | string | null | Yes | |
enabled | boolean | Yes | |
value_type | enum | Yes | Values: "boolean", "string", "number", "json" |
on_value | boolean | number | string | array<any> | map<string, any> | Yes | |
off_value | boolean | number | string | array<any> | map<string, any> | Yes | |
rollout_percent | integer | Yes | |
segment_id | string | null | Yes | |
rollout_schedule | array<object> | Yes | |
rollout_schedule[].at | string | Yes | |
rollout_schedule[].percent | integer | Yes | |
created_at | string | Yes | |
updated_at | string | Yes |
Example response:
{
"name": "Sipariş bildirimleri",
"enabled": true,
"id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"key": "key-2026-10",
"description": "Sipariş durumu güncellemeleri",
"value_type": "boolean",
"on_value": true,
"off_value": true,
"rollout_percent": 1,
"segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"rollout_schedule": [
{
"at": "örnek",
"percent": 1
}
],
"created_at": "örnek",
"updated_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/feature-flags/id_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"Update a flag
Authentication: API key — scope admin (admin includes every scope).
Parameters
| Name | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
flagId | path | string | Yes | "id_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | path | string | Yes | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Request body (required)
Schema: UpdateAppFlagDto
| Field | Type | Required | Description |
|---|---|---|---|
name | string | No | Length: 1–100 |
description | string | null | No | |
enabled | boolean | No | |
value_type | enum | No | Values: "boolean", "string", "number", "json" |
on_value | boolean | number | string | array<any> | map<string, any> | No | |
off_value | boolean | number | string | array<any> | map<string, any> | No | |
rollout_percent | integer | No | Range: 0–100 |
segment_id | string | null | No | |
rollout_schedule | array<object> | No | Items: 0–10 |
rollout_schedule[].at | string (date-time) | Yes | |
rollout_schedule[].percent | integer | Yes | Range: 0–100 |
Example:
{
"name": "Sipariş bildirimleri",
"enabled": true,
"description": "Sipariş durumu güncellemeleri",
"value_type": "boolean",
"on_value": true
}Responses
200 — Success.
Schema: AppFlag
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
app_id | string | Yes | |
key | string | Yes | |
name | string | Yes | |
description | string | null | Yes | |
enabled | boolean | Yes | |
value_type | enum | Yes | Values: "boolean", "string", "number", "json" |
on_value | boolean | number | string | array<any> | map<string, any> | Yes | |
off_value | boolean | number | string | array<any> | map<string, any> | Yes | |
rollout_percent | integer | Yes | |
segment_id | string | null | Yes | |
rollout_schedule | array<object> | Yes | |
rollout_schedule[].at | string | Yes | |
rollout_schedule[].percent | integer | Yes | |
created_at | string | Yes | |
updated_at | string | Yes |
Example response:
{
"name": "Sipariş bildirimleri",
"enabled": true,
"id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"key": "key-2026-10",
"description": "Sipariş durumu güncellemeleri",
"value_type": "boolean",
"on_value": true,
"off_value": true,
"rollout_percent": 1,
"segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
"rollout_schedule": [
{
"at": "örnek",
"percent": 1
}
],
"created_at": "örnek",
"updated_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 PATCH "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/feature-flags/id_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
-H "Authorization: Bearer $PUSHIZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Sipariş bildirimleri",
"enabled": true,
"description": "Sipariş durumu güncellemeleri",
"value_type": "boolean",
"on_value": true
}'Delete a flag
Authentication: API key — scope admin (admin includes every scope).
Parameters
| Name | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
flagId | path | string | Yes | "id_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | path | string | Yes | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Responses
200 — Success.
Schema: Ok
| Field | Type | Required | Description |
|---|---|---|---|
ok | true | Yes |
Example response:
{
"ok": true
}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/feature-flags/id_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
-H "Authorization: Bearer $PUSHIZO_API_KEY"SDK endpoints (client)
SDK endpoints (client) — 51 operations (GET /sdk/v1/apps/{appId}/config, POST /sdk/v1/apps/{appId}/subscriptions, PATCH /sdk/v1/apps/{appId}/subscriptions/{subscriptionId}, …). Generated from the OpenAPI 3.1.0 contract.
wallet
wallet — 12 operations (GET /v1/apps/{appId}/wallet/config, PUT /v1/apps/{appId}/wallet/config, GET /v1/apps/{appId}/wallet/templates, …). Generated from the OpenAPI 3.1.0 contract.