---
title: "Upsert the JSON Schema for a config page"
method: PUT
path: "/v1/agents/{agentId}/real-time-configs/{clientEnv}/schema"
tags: ["Real-Time Configs"]
---

# Upsert the JSON Schema for a config page

`PUT /v1/agents/{agentId}/real-time-configs/{clientEnv}/schema`

## Request body

- UpdateConfigSchemaBody — The JSON Schema definition to apply to a config page.
  - `schema` object, required — JSON Schema (Draft 7) definition

## Response `200`

Successful response

- GetConfigPageResponse — A single config page for one environment.
  - `clientEnv` string, required — Environment (sandbox, pre-release, live)
  - `variables` object — Config key-value pairs
  - `schema` object — JSON Schema (Draft 7) definition
  - `lastUpdated` string — ISO 8601 timestamp of last update

## Other responses

- `400` — Validation error
- `401` — Unauthorized – missing or invalid API key
- `403` — Forbidden – insufficient permissions
- `404` — Resource not found

---

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