---
title: "Keep a value for a page"
method: PUT
path: "/api/artifacts/{artifactId}/state/{key}"
tags: ["Artifacts"]
---

# Keep a value for a page

`PUT /api/artifacts/{artifactId}/state/{key}`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `x-sixb-csrf`
  - HTTP bearer
  - HTTP bearer

Keeps a JSON value under the key for the caller, replacing one there. Refused with 413 state_full past the limits.

## Path parameters

- `artifactId` string, required
- `key` string, required: The key a page keeps the value under, such as filters

## Request body

- object
  - `value` unknown, required

## Response `200`

Response for status 200

- object
  - `key` string, required
  - `value` unknown
  - `updatedAt` string, required

## Other responses

- `400`: Response for status 400
- `404`: Response for status 404
- `413`: Response for status 413
- `501`: Response for status 501

## Changes

- **2026-10-20** `ebeab1520daa`: 1 info
  - endpoint added
- **2026-10-20** `2529bf887ba6`: 1 breaking
  - api path removed without deprecation
- **2026-10-20** `8df745541b3a`: 1 info
  - endpoint added
- **2026-10-20** `8c53eb806aa9`: 1 breaking
  - api path removed without deprecation
- **2026-10-19** `c035fdb6dedd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sixb-ai/apis/sixb-api/changes/api/artifacts/:artifactId/state/:key/put.md)

---

[API](https://skmtc.dev/sixb-ai/apis/sixb-api.md) - [All operations](https://skmtc.dev/sixb-ai/apis/sixb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sixb-ai/apis/sixb-api/revisions/a227d682eaa2?raw)