---
title: "Update App"
method: PATCH
path: "/api/apps/{name}"
tags: ["apps"]
---

# Update App

`PATCH /api/apps/{name}`

## Request

- Base URL: `https://softkiln.com` (the document declares no server; this is the origin it was published from)
- URL: `https://softkiln.com/api/apps/{name}`
- Auth: none declared

Update an app's editable metadata. Only display_name (the UI-facing name)
is mutable; the slug/handle is fixed. App admins/owners and global admins.

## Path parameters

- `name` string, required

## Request body

- UpdateAppRequest
  - `display_name` string, required

## Response `200`

Successful Response

- AppOut
  - `id` string, required
  - `name` string, required
  - `display_name` string, required
  - `repo` string, required
  - `project_id` string, nullable, required
  - `service_id` string, nullable, required
  - `prod_env_id` string, nullable, required
  - `dev_env_id` string, nullable, required
  - `prod_domain` string, nullable, required
  - `dev_domain` string, nullable, required
  - `has_postgres` boolean, required
  - `has_volume` boolean, required
  - `created_at` string, required
  - `template` string, nullable
  - `is_owner` boolean
  - `provisioning_status` string, required
  - `provisioning_current_step` string, nullable
  - `provisioning_error` string, nullable
  - `provisioning_steps` object, nullable
  - `billing` AppBillingState: Compact billing snapshot for at-a-glance dashboard badges. None on AppOut when billing is disabled or the app has no subscription.
    - `status` string, nullable, required
    - `stripe_status` string, nullable, required
    - `suspended` boolean, required
    - `deletion_at` string, nullable, required
    - `payment_failed_at` string, nullable
    - `disconnect_by` string, nullable
    - `deletion_by` string, nullable
    - `trial_ends_at` string, nullable, required
    - `on_trial` boolean, required
    - `exempt` boolean, required
    - `hold` boolean, required
  - `ticket_prefix` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/softkiln/apis/app-manager-api.md) · [All operations](https://skmtc.dev/softkiln/apis/app-manager-api/llms.txt) · [OpenAPI document](https://skmtc.dev/softkiln/apis/app-manager-api/revisions/8e293a417e4a?raw)