Create Attribute
Create a new project-specific user attribute (manually populated).
Authorizations
Aspect API key (sk_...) in Authorization header. 'Bearer ' optional.
Query Parameters
Deprecated: send project_id in the body instead
Body
API request schema for creating a metadata attribute.
Human-readable name, unique per project
255Type of value this attribute holds
string, integer, float, boolean, datetime, single_select, multi_select, user_id, person_id, object_id, directory_id Project the attribute belongs to. Required unless given in the deprecated project_id query parameter
For select types only
Grouping category for UI
Settings for generating an attribute's values with AI.
Response
Successful Response
API response schema for metadata attribute.
Unique identifier for this attribute
Human-readable display name
Type of value this attribute holds
string, integer, float, boolean, datetime, single_select, multi_select, user_id, person_id, object_id, directory_id Whether attribute is system-defined or user-created
system, user, asset Whether this attribute can be used in filters
Whether this attribute can be shown in generic metadata display UI
Whether values for this attribute can be edited through metadata APIs
Whether assets can be sorted by this attribute
When the attribute was created
When the attribute was last updated
Project ID for project-specific attributes, null for system global
Available options for select types
Grouping category for UI display
For ASSET source: the asset property this attribute maps to
AI generation settings; null when generation is off
User who created the attribute; null for system attributes and ones created before creators were recorded