Update Current User's Subscription Settings

POST

/openapi/v2.0/manage/api/v1/organizations/{uuid}/users/current/subscription

Current user updates a subscription type setting within specified organization (subscription switch / subscribed project scope / whether to auto-subscribe newly joined projects / receive channels). Business Constraints:

All projects in subscription_projects list must be ⊆ the project set the user is authorized to access in the organization

Unsupported subscription_type values return UnSupportAirportSubscriptionTYpe error Special Behavior: subscription_type=device_report_feedback (Device Report Feedback Type) belongs to organization-level subscription, does not distinguish projects; ignores subscription_projects and is_subscription_new_projects in request body.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "subscription_type": "airport_emergency_event",
    "subscription_config": {
        "subscription_status": true,
        "subscription_projects": [
            "string_value"
        ],
        "is_subscription_new_projects": true,
        "subscription_receive_type": [
            "phone"
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/manage/api/v1/organizations//users/current/subscription' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id: 5dff27bd-693c-4ace-979d-e26e920d497a' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "subscription_type": "airport_emergency_event",
    "subscription_config": {
        "subscription_status": true,
        "subscription_projects": [
            "string_value"
        ],
        "is_subscription_new_projects": true,
        "subscription_receive_type": [
            "phone"
        ]
    }
}'

Responses

🟢200

application/json

Business success (see 'Response Example' in the Markdown documentation for specific data)

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": null
}

🔴500

Modified at 2026-06-15 13:36:31

Query Organization Project List

Get Organization Details