---
title: "Update application"
method: PUT
path: "/api/v2/saas-management/applications/{application_id}"
tags: ["SaaS App Management"]
---

# Update application

`PUT /api/v2/saas-management/applications/{application_id}`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/saas-management/applications/{application_id}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/saas-management/applications/:application_id/put.ts> (a function with typed inputs; its response is checked against the schema)

Update an existing application

## Path parameters

- `application_id` string, required

## Request body

- JumpcloudHttpSaasAppManagementPublicAPIUpdateApplicationRequest
  - `owner_user_id` string: Owner User ID
  - `app_name` string: Application name if it is a custom application.
  - `app_domains` string[]: List of app URLs if it is a custom application.
  - `description` string: Description of the application if it is a custom application.
  - `status` 'NEWLY_DISCOVERED' | 'APPROVED' | 'UNAPPROVED' | 'IGNORED': Application status
  - `access_restriction` 'NO_ACTION' | 'WARNING' | 'BLOCK' | 'DISMISSIBLE_WARNING' | 'DEFAULT_ACTION': Access restriction type
  - `alternative_button` string: Alternative button text
  - `alternative_button_url` string: Alternative button URL
  - `custom_restriction_message` string: Custom restriction message
  - `restriction_excluded_group_ids` string[]: List of excluded group IDs

## Response `200`

Application updated successfully

- JumpcloudHttpSaasAppManagementPublicAPIApplication
  - `id` string: Application ID
  - `name` string: Application name
  - `catalog_app_id` string: Catalog Application ID
  - `owner_user_id` string: Owner User ID
  - `status` 'NEWLY_DISCOVERED' | 'APPROVED' | 'UNAPPROVED' | 'IGNORED': Application status
  - `access_restriction` 'NO_ACTION' | 'WARNING' | 'BLOCK' | 'DISMISSIBLE_WARNING' | 'DEFAULT_ACTION': Access restriction type
  - `alternative_button` string: Alternative button text
  - `alternative_button_url` string: Alternative button URL
  - `custom_restriction_message` string: Custom restriction message
  - `discovered_at` string, date-time: Application discovery timestamp
  - `restriction_excluded_group_ids` string[]: List of excluded group IDs
  - `sso_apps` JumpcloudHttpSaasAppManagementPublicAPISSOApp[]: SSO connections associated with the application. Only populated when `sso_apps` is requested via the `expand` query parameter.
    - `id` string: SSO application ID
    - `app_name` string: Name of the catalog application associated with this SSO connection
    - `display_label` string: Display label of the SSO application
    - `template_name` string: Template name of the SSO application
    - `status` 'NOT_CONNECTED' | 'CONNECTED': SSO connection status

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal server error
- `default`: Generic error response

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/revisions/f396d9271b46?raw)