Skip to main content
POST
Add a property to a base

Body

application/json
base
string
required

Base id or slug

name
string
required

Property display name

agent
string

Agent column: the agent that fills it (a label, max 64)

approvers
string

Approval: who decides, comma-separated role:<viewer|developer|project_admin> or user: (1-20)

config
string

Property config JSON (options, format, includeTime...)

console
string

Console base URL

description
string

Property description

expectedSchemaVersion
string

Schema version you read (default: read the current one first)

idempotencyKey
string

Idempotency key: a retry with the same key and request returns the created object (default: generated)

inputs
string

Agent column: property keys the agent reads (1-20)

instructions
string

Agent column: what the agent fills (1-4000 chars)

key
string

API key, ^[a-z][a-z0-9_]{0,62}$ (default: derived from the name)

options
string

Select/status options (or an agent column's select output), comma-separated; status groups as Name:todo|in_progress|done

output
string

Agent column: value type text|number|checkbox|select|multi_select|url|date

position
string

Column position

project
string

Console project id or slug; overrides the saved Console scope

required
boolean

Require a value on create and on updates that touch it

resetOn
string

Approval: property keys whose change sends a decided approval back to pending

type
string

text|number|checkbox|date|select|multi_select|status|url|email|phone|person|ref|approval|agent (default: text)

Response

Success — body conforms to the @Returns schema.

base
object
required
consoleUrl
string
required
idempotencyKey
string
required
projectRef
string
required
property
object
required
report
object | null
required
success
boolean
required