Update an Application

patch

https://api.zylo.com/v2/applications/{applicationId}

Required Permissions

applications:write

Rate Limit

basic

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

applicationId

string

required

[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}

Stringified UUIDv4.

Body Params

activity_threshold

double | null

0 to 365

Threshold in days compared against a user's last activity to determine whether the user is Active. 90 days by default and editable on Subscription details page.

app_label

string | null

The label for the application.

application_owner_user_email

string | null

^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$

Manually selected email address of the Application Owner.

business_goals

string | null

Business goals of the application.

business_owner_user_email

string | null

^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$

Manually selected email address of the Business Owner.

business_unit

string | null

Manually selected team that primarily owns the management of the application. Accepts an existing value, null, or a new value, which is created on write.

category

string | null

Zylo-managed or internally-managed Category of the application. New values cannot be created through the API: add them in Zylo under Admin -> Categorization with Custom Categories enabled, then read them from GET /v2/applications/options/category and assign with a PATCH.
Learn More

custom_fields

string

Values for custom fields associated with this Application.
See custom field details here.

holds_pii

boolean | null

Manually selected field to identify which applications contain Personally Identifiable Information (PII) on users.

it_owner_user_email

string | null

^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$

Manually selected email address of the IT Owner.

it_supported

boolean | null

Manually selected field to indicate if supported internally by IT.

next_action

string | null

enum

Manually selected pick list field to identify what action needs to be taken next on an application.

Allowed:

sso_enforced

boolean | null

Manually selected field to identify which applications are enforced behind Single Sign On provider.

status

string | null

enum

Status of the application. Reads may return: active, expired, cancelled, inactive, detected, discovered, monitored, managed, discontinued. Only "active" and "cancelled" may be set via the API; other statuses are calculated by Zylo from app data.

Allowed:

subcategory

string | null

Zylo-managed or internally-managed Subcategory of the application. New values cannot be created through the API: add them in Zylo under Admin -> Categorization with Custom Categories enabled, then read them from GET /v2/applications/options/subcategory and assign with a PATCH.
Learn More

200Ok