---
title: "Create or update a Forge app property."
method: PUT
path: "/app/properties/{propertyKey}"
tags: ["App Properties"]
---

# Create or update a Forge app property.

`PUT /app/properties/{propertyKey}`

Creates or updates a Forge app property. This API can only be accessed using **[asApp()](https://developer.atlassian.com/platform/forge/apis-reference/fetch-api-product.requestconfluence/#method-signature)** requests from Forge.

## Path parameters

- `propertyKey` string, required

## Request body

- object

## Response `200`

Property updated.

## Other responses

- `201` — Property created.
- `400` — Property key longer than 127 characters, or request made with invalid JSON.
- `401` — The request did not originate from the Forge app.
- `403` — Returned when the request is forbidden due to one of the following: - The request attempts impersonation. Only requests made using `asApp()` are allowed. - The Forge app is not installed.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api-v2/revisions/c4bd1ed570f2/schema)