API update
September 7th, 2026
- Added
simpleandwithReferenceFieldrequest examples toPOST /tasks/{task_id}/structured-contentsandPOST /structured-contents. See the API reference for - Documented that
root_contentistruefor the top-level content andfalsefor any content embedded through a reference field, consistent across theRecursiveStructuredContent,TaskStructuredContentCreateRequest, andLibraryStructuredContentCreateRequestschemas. - Clarified the request shape for creating structured content that embeds other content through reference fields, on both
POST /tasks/{task_id}/structured-contentsandPOST /structured-contents, with the following rules:- Field values must be nested under a
fieldsobject at every level (on the top-level content and on each embeddedcontent_details) andhas_embedded: truemust be set on the top-levelfieldswhen creating new embedded items through a reference field. - Server-managed fields such as
content_guidandcreated_byshould not be sent. The server assigns them and returns each embedded item inline as expandedcontent_details. See the API reference for more details.
- Field values must be nested under a
See the following API references for more details:
POST /tasks/{task_id}/structured-contents– API reference.POST /structured-contents– API reference.