Skip to content

List Object Attributes

GET
/objects/{object_slug}/attributes

PREVIEW. This endpoint is deployed but gated: it returns 404 unless the hosted app platform is enabled for your organization. It is published here so the contract describes the whole surface, not so it can be called today.

List active fields. Archived-field discovery currently applies to custom objects.

Authorizations

Parameters

Path Parameters

object_slug
required
string

Query Parameters

include_archived
boolean

Header Parameters

X-Target-Org-Id
Any of:
string

Responses

200

Successful Response

object
data
required
Array<object>

One field on a custom object, and the rules its values must satisfy.

object
attribute_type
required

One of the 16 supported attribute types (text, number, email_address, timestamp, select, record_reference, …). Determines how values are validated and canonicalized.

string
config

Type-specific configuration, e.g. select options. Record references require target_object and must resolve to active records in that object within the caller’s organization and app.

object
key
additional properties
any
default_value

Configured create default. Enabled non-null defaults pass the same validation as explicit values.

description
Any of:
string
is_archived

Archived fields retain their values and can be restored.

boolean
is_default_value_enabled

Apply the configured default when this field is omitted on create. Never applies on PATCH.

boolean
is_multiselect

Values are a list rather than a scalar.

boolean
is_required

Required on create. PATCH may omit it, but cannot clear it with null or an empty multivalue list.

boolean
is_system

Whether this field is protected as a system attribute.

boolean
is_unique

No two active records may hold the same value for this attribute. A collision is rejected with 409 duplicate_active_value.

boolean
slug
required

Stable API slug for the attribute, used as a payload key.

string
sort_order

Configured display order; equal values are ordered by API slug.

integer
title
required

Customer-facing field label, distinct from its stable API slug.

string
pagination
Any of:
object
has_next
required

Whether there are more pages

boolean
limit
required

Items per page

integer
next_cursor
Any of:
string
page
required

Current page number (1-indexed)

integer
total
required

Total number of items

integer

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string