Added
Structures API
August 26th, 2026
Structures are now available through the public API. A structure is any node in your organization's hierarchy, a site, a group, or a type you define.
The following APIs allow you to create, read, replace, move, and search structures, and manage the members assigned to each one.
| Endpoint name | Endpoint |
|---|---|
| Create a structure | POST /structures/v1/structures |
| Get a structure | GET /structures/v1/structures/{structure_id} |
| Get structure metadata | GET /structures/v1/structures/{structure_id}/metadata |
| Replace a structure | PUT /structures/v1/structures/{structure_id} |
| Move a structure | POST /structures/v1/structures/{structure_id}/move |
| Search structures | POST /structures/v1/structures/search |
| Add members to a structure | POST /structures/v1/structures/{structure_id}/members |
| List direct members of a structure | POST /structures/v1/structures/{structure_id}/members/list |
| Update a member's role | PATCH /structures/v1/structures/{structure_id}/members/USER_ID |
| Remove members from a structure | POST /structures/v1/structures/{structure_id}/members/remove |
Developer impact: Structures supersede the separate Sites and Groups models. The existing Sites and Groups endpoints are unaffected and continue to work.
Action required: No action required. Migrate to Structures only if you want custom fields, custom structure types, or roles on membership.