---
title: "List apps"
method: GET
path: "/apps"
tags: ["Apps"]
---

# List apps

`GET /apps`

List applications. Optionally filter by app name and/or version label.

## Query parameters

- `app_name` string
- `version` string
- `limit` integer
- `offset` integer
- `query` string

## Response `200`

List of apps.

- AppVersionSummary[]
  - `id` string, required — Unique identifier for the app version
  - `app_name` string, required — Name of the application
  - `version` string, required — Version label for the application
  - `region` 'aws.us-east-1a', required — Deployment region code
  - `deployment` string, required — Deployment ID
  - `actions` AppAction[], required — List of actions available on the app
    - `name` string, required — Name of the action
    - `input_schema` object, nullable — JSON Schema (draft-07) describing the expected input payload. Null if schema could not be automatically generated.
    - `output_schema` object, nullable — JSON Schema (draft-07) describing the expected output payload. Null if schema could not be automatically generated.
  - `env_vars` object, required — Environment variables configured for this app version. Values are redacted for API key, OAuth, and managed-auth callers, which receive every key with an empty string value. Only dashboard sessions receive the actual values.

## Other responses

- `401` — Unauthorized – missing or invalid authorization token
- `500` — Internal Server Error

---

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