> For the complete documentation index, see [llms.txt](https://docs.snyk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snyk.io/developer-tools/snyk-api/using-specific-snyk-apis/snyk-apps-apis/manage-app-details.md). # Manage App details ## List Apps created by an Organization To view a list of Snyk Apps owned by your Snyk Organization, send a `GET` request to the `apps/creations` endpoint: `https://api.snyk.io/rest/orgs/{orgId}/apps/creations?version={version}` For details, see the endpoint [Get a list of apps created by an Organization](/developer-tools/snyk-api/reference/apps.md#orgs-org_id-apps-1). ## Update App details You can update the name of your App or the list of redirect URIs you have set. To update an App, send a `PATCH` request to the `apps/creations{app_id}` endpoint: `https://api.snyk.io/rest/orgs/{orgId}/apps/creations{app_id}?version={version}` The `app_id` path parameter is the `id` in the response to a [`GET` request to the `apps/creations` endpoint](#list-apps-created-by-an-organization). For details, see the endpoint[Update app creation attributes such as name, redirect URLs, and access token time to live using the App ID](/developer-tools/snyk-api/reference/apps.md#orgs-org_id-apps-creations-app_id). ## Delete an App To delete an App from your Snyk Organization, send a DELETE request to the endpoint `apps/creations{app_id}`: `https://api.snyk.io/rest/orgs/{orgId}/apps/creations/{app_id}?version={version}` The `app_id` path parameter is the `id` in the response to a [`GET` request to the `apps/creations` endpoint](#list-apps-created-by-an-organization). For details, see the endpoint [Delete an app by its App ID](/developer-tools/snyk-api/reference/apps.md#orgs-org_id-apps-client_id-2). Deleting an App revokes your App credentials and removes all of your App's installations. If you have active users, they will no longer be able to connect to Snyk through the App. ## Rotate App clientSecret You cannot view the `clientSecret` after the App is created. If you have misplaced it, you can rotate your `clientSecret` and receive a new one. Perform secret management requests for apps you have created by sending a `POST` request to the endpoint `apps/creations{app_id}/secrets`: `https://api.snyk.io/rest/orgs/{orgId}/apps/creations/{app_id}/secrets?version={version}` The `app_id` path parameter is the `id` in the response to a [`GET` request to the `apps/creations` endpoint](#list-apps-created-by-an-organization). For details, see the endpoint [Manage client secret for the Snyk App](/developer-tools/snyk-api/reference/apps.md#orgs-org_id-apps-creations-app_id-secrets). {% hint style="info" %} For client credentials apps that you have installed, see the endpoint [Manage client secret for non-interactive Snyk App installations](/developer-tools/snyk-api/reference/apps.md#groups-group_id-apps-installs-install_id-secrets). {% endhint %} You can perform three operations that are indicated by the body of your POST request: * create `{"mode": "create"}` * delete `{"mode": "delete", "secret": "{clientSecret}"}` * replace `{"mode": "replace"}` Snyk recommends you adopt the following procedure when rotating your secrets: 1. Create a new secret using `{"mode": "create"}` 2. Update your services with the newly generated secret 3. Remove the old secret using `{"mode": "delete", "secret": "{secret}"}` ### Create a clientSecret It is recommended that in normal operation you periodically rotate your client secrets. To start the process, send the request body `{"mode": "create"}` to the endpoint which will create a new secret. The returned value of this call will be your app with the newly generated secret. Both the new secret and any existing secrets will be valid until they are manually replaced or deleted. You can also immediately replace a client secret. An App can have a maximum of two active secrets at any time. This endpoint fails with the error `cannot update secrets` if you try to call `create` when you already have the maximum number of secrets active. ### Replace a clientSecret In the event that your App's `clientSecret` is leaked, you can generate a new one by using `{"mode": "replace"}`. When you replace your `clientSecret`, your current secret is immediately invalid. Your App will not be able to connect to Snyk until you update the App's configuration with the new secret. ### Delete a clientSecret To clean up any unused secrets, call the endpoint with `{"mode": "delete", "secret": "{clientSecret}"}` where `{clientSecret}` is your client secret that you want to delete. This action invalidates the secret immediately so it can no longer be used. An App must have at least one active secret; calling delete with your last secret will fail. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.snyk.io/developer-tools/snyk-api/using-specific-snyk-apis/snyk-apps-apis/manage-app-details.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.