---
title: "Set app user configuration"
method: PUT
path: "/api/apps/{id}/user-config"
tags: ["Apps"]
---

# Set app user configuration

`PUT /api/apps/{id}/user-config`

Stores validated per-user values outside the versioned app definition. The reserved `$theme` key (a preset-theme slug) is accepted on every app, even one that declares no userConfig schema.

## Path parameters

- `id` string, required

## Request body

- object
  - `values` object, required

## Response `200`

Stored user configuration

- object
  - `values` object, required
  - `schema` object, required

## Other responses

- `400` — Invalid user configuration
- `403` — Permission denied
- `404` — App not found
- `409` — App definition needs repair
- `413` — Request exceeds 64 KB or serialized values exceed 16 KB

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/versions/0375890be8c4/schema)