API referenceComputed Traits
List computed traits
Archived ones only when the status filter asks for them.
GET
Archived ones only when the status filter asks for them.
apiKey readheader
AuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: read
page?integerStarts at 1
Range
1 <= valueDefault
1pageSize?numberOne of 10, 25, 50, 100
Default
25q?stringSearch
Length
1 <= length <= 200status?stringComma-separated, any of: draft, published, archived
sort?stringOne of name, createdAt, updatedAt; prefix with - for descending
Default
"-updatedAt"Value in
"name""-name""createdAt""-createdAt""updatedAt""-updatedAt"OK
application/json- response
items*array<>total*integerpage*integerpageSize*integercurl -X GET 'https://api.postforge.dev/v1/computed-traits'{ "items": [ { "id": "string", "kind": "string", "name": "string", "folder": { "id": "string", "name": "string" }, "status": "draft", "draftVersionId": "e7fc80a1-b65e-482e-8fcd-f6c647b4104b", "publishedVersionId": "9786f1b1-ef7e-4f6a-94c4-c8eb67e924eb", "hasUnpublishedChanges": true, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "archivedAt": "2019-08-24T14:15:22Z", "description": "string", "source": "events", "event": "string", "aggregate": "count", "field": "string", "where": [], "window": { "type": "ever" }, "currency": "str" } ], "total": 0, "page": 0, "pageSize": 0}Where a component is used GET
The templates with an instance of it (their latest versions: in use, D104), directly or inside another component, and the published components whose body holds one. What publishing a new version changes.
Create a computed trait POST
Its first version is the draft; publish it to use it.