---
title: "Update metadata of an existing Application"
method: PATCH
path: "/orgs/{orgId}/apps/{appId}"
tags: ["public", "Application"]
---

# Update metadata of an existing Application

`PATCH /orgs/{orgId}/apps/{appId}`

Update metadata of an existing Application in the specified Organization.

## Path parameters

- `orgId` string, required
- `appId` string, required

## Request body

- ApplicationPatchPayload — Patch request body to update Application metadata.
  - `name` string, required — The Human-friendly name for the Application.

## Response `200`

Application updated.

- ApplicationResponse — An Application is a collection of Workloads that work together. When deployed, all Workloads in an Application are deployed to the same namespace. Apps are the root of the configuration tree holding Environments, Deployments, Shared Values, and Secrets.
  - `created_at` string, required — The timestamp in UTC indicates when the Application was created.
  - `created_by` string, required — The user who created the Application.
  - `envs` EnvironmentBaseResponse[], required — The Environments associated with the Application.
    - `id` string, required — The ID the Environment is referenced as.
    - `name` string, required — The Human-friendly name for the Environment.
    - `type` string, required — The Environment Type. This is used for organizing and managing Environments.
  - `id` string, required — The ID which refers to a specific application.
  - `name` string, required — The Human-friendly name for the Application.
  - `org_id` string, required — The Organization id of this Application
  - `status` 'active' | 'deleting', required — The status of the application
  - `status_changed_at` string, date-time, required — The timestamp in UTC of when the Environment status was last changed.
  - `status_message` string — The message associated with the status of the environment

## Other responses

- `404` — No Application with ID `appId` in Organization.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)