---
title: "Registering an Actor Property Name"
method: POST
path: "/v1/projects/{projectId}/actor-properties"
tags: ["Actor Properties"]
---

# Registering an Actor Property Name

`POST /v1/projects/{projectId}/actor-properties`

Registers a new actor property name for this project. Once registered, the property can be set on any App User or Public Link within the project via `PATCH`.

Property names follow the same rules as Entity property names: they must be non-empty, may contain letters, digits, hyphens, and underscores, and the name `displayName` (case-insensitive) is reserved.

Requires `actor_property.update` permission.

## Path parameters

- `projectId` number, required

## Request body

- object
  - `name` string, required — The name of the property to register.

## Response `200`

OK

- Success
  - `success` boolean, required

## Changes

- **2026-06-02** `dcd5409827e1` — 1 info
  - endpoint added
- **2025-03-13** `e8c2858fd4eb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/projects/:projectId/actor-properties/post.md)

---

[API](https://skmtc.dev/getodk/apis/odk-central-api.md) · [All operations](https://skmtc.dev/getodk/apis/odk-central-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getodk/odk-central-api/revisions/d4f5ba77f644/schema)