Skip to main content
POST
/
v1
/
public
/
properties
Create property
curl --request POST \
  --url https://api.poelis.com/v1/public/properties \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "item_id": "<string>",
  "type": "<string>",
  "name": "<string>",
  "readable_id": "<string>",
  "value": "<unknown>"
}
'
{
  "id": "<string>",
  "readable_id": "<string>",
  "item_id": "<string>",
  "name": "<string>",
  "type": "numeric",
  "value": "<unknown>",
  "deleted": true,
  "category": "<string>",
  "display_unit": "<string>",
  "draft_property_id": "<string>",
  "references": [
    {
      "item_document_id": "770e8400-e29b-41d4-a716-446655440002",
      "page": 42
    }
  ],
  "formula_expression": "<string>",
  "createdBy": {
    "id": "auth0|550e8400-e29b-41d4-a716-446655440000",
    "imageUrl": "https://example.com/avatar.png",
    "userName": "Jane Doe"
  },
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "updatedBy": {
    "id": "auth0|550e8400-e29b-41d4-a716-446655440000",
    "imageUrl": "https://example.com/avatar.png",
    "userName": "Jane Doe"
  }
}

Authorizations

​
Authorization
string
header
required

Enter your API key. Example: Bearer poelis_api_...

Body

application/json

Request to create a new property.

​
item_id
string
required

Item ID to create the property on

​
type
string
required

Property type: numeric, matrix, text, date, or status. Formula not supported via public API.

​
name
string
required

Property name

Minimum string length: 1
​
readable_id
string
required

Human-readable property ID (must be unique within item). Only lowercase letters, numbers and underscores are allowed.

Minimum string length: 1
Pattern: ^[a-z0-9_]+$
​
value
any
required

Property value (string/number depending on type)

​
category
string | null

Category (required for numeric and matrix)

​
display_unit
string | null

Display unit (required for numeric and matrix)

Response

Created property

Unified public property representation.

​
id
string
required
​
readable_id
string
required

Human-readable property ID

​
item_id
string
required
​
name
string
required
​
type
enum<string>
required
Available options:
numeric,
text,
date,
status,
matrix,
formula
​
value
any
required

Property value. Numeric: plain number or matrix (category/display_unit always set; matrix value string e.g. "[[1,2,3],[4,5,6]]") or formula (category/display_unit never set; value is the result of the computation including unit if any). Text: string. Date: string, ISO date (e.g. "2025-01-29"). Status: string, one of "Draft", "Under Review", "Done".

​
deleted
boolean
required
​
category
string | null

Category. For numeric (plain number or matrix) always set; for formula never set.

​
display_unit
string | null

Display unit. For numeric (plain number or matrix) always set; for formula never set.

​
draft_property_id
string | null
​
references
PublicPropertyReference · object[]

References to source documents for this property

​
formula_expression
string | null

Formula expression for numeric properties that calculate their value from other properties. Uses @{property_id} syntax to reference dependencies. The value field holds the result of this computation, including unit if any.

​
createdBy
PublicUser · object

User who created the property

Example:
{
  "id": "auth0|550e8400-e29b-41d4-a716-446655440000",
  "imageUrl": "https://example.com/avatar.png",
  "userName": "Jane Doe"
}
​
createdAt
string | null

ISO 8601 creation timestamp

​
updatedAt
string | null

ISO 8601 last-update timestamp

​
updatedBy
PublicUser · object

User who last updated the property

Example:
{
  "id": "auth0|550e8400-e29b-41d4-a716-446655440000",
  "imageUrl": "https://example.com/avatar.png",
  "userName": "Jane Doe"
}