---
title: "Get App"
method: GET
path: "/apps/{app_id}"
---

# Get App

`GET /apps/{app_id}`

## Request

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

Report one app the caller owns or is an active member of.

The route only reads, so it runs on ``run_read_in_thread``.
``load_app_for`` reads the app and the caller's membership row in
one statement. One more statement reads the owner, one more reads
the channels, and one more reads the pending deploys of those
channels. ``protected.resolve`` reads the owner from the identity
map and adds no statement.

## Path parameters

- `app_id` string, uuid, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- AppResponse
  - `id` string, uuid, required
  - `name` string, required
  - `repo_url` string, required
  - `template` string, required
  - `created_at` string, date-time, required
  - `external_db_access_enabled` boolean, required
  - `external_blob_access_enabled` boolean, required
  - `port_forwarding_enabled` boolean, required
  - `port_forwarding_available` boolean, required
  - `agent_protected_actions_enabled` boolean, nullable, required
  - `agent_protected_actions_effective` boolean, required
  - `channels` ChannelResponse[], required
    - `id` string, uuid, required
    - `name` string, required
    - `hostname` string, required
    - `git_ref_binding` string, nullable, required
    - `follows_branch` boolean, required
    - `current_sha` string, nullable, required
    - `status` string, required
    - `pending_deploy` PendingDeployResponse, required: The channel's in-flight deploy, if one is queued or running.
      - `deploy_id` string, uuid, required
      - `sha` string, required
      - `status` string, required
  - `owner_username` string, required
  - `role` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xhostd/apis/xhostd-public.md) · [All operations](https://skmtc.dev/xhostd/apis/xhostd-public/llms.txt) · [OpenAPI document](https://skmtc.dev/xhostd/apis/xhostd-public/revisions/bf439c4d1789?raw)