Content Management API > Model/Block model
Reorders a set of fields and fieldsets within the model
Warning: Experimental API
Please note that this API method is marked as unstable and should be avoided in production environments. Changes may occur at any time without warning, potentially impacting your scripts. We recommend contacting our Support Team to explore alternative approaches that are safer and more reliable!
Examples
The response contains the ID of the asynchronous job that started:
POST https://site-api.datocms.com/item-types/:model_id_or_api_key/reorder-fields-and-fieldsets HTTP/1.1Authorization: Bearer YOUR-API-TOKENAccept: application/jsonX-Api-Version: 3Content-Type: application/vnd.api+json
{ "data": [ { "id": "Pkg-oztERp6o-Rj76nYKJg", "type": "field", "attributes": { "position": 1 }, "relationships": { "fieldset": { "data": null } } } ]}curl -g 'https://site-api.datocms.com/item-types/:model_id_or_api_key/reorder-fields-and-fieldsets' \ -X POST \ -H "Authorization: Bearer YOUR-API-TOKEN" \ -H "Accept: application/json" \ -H "X-Api-Version: 3" \ -H "Content-Type: application/vnd.api+json" \ --data-binary '{"data":[{"id":"Pkg-oztERp6o-Rj76nYKJg","type":"field","attributes":{"position":1},"relationships":{"fieldset":{"data":null}}}]}'await fetch( "https://site-api.datocms.com/item-types/:model_id_or_api_key/reorder-fields-and-fieldsets", { method: "POST", headers: { Authorization: "Bearer YOUR-API-TOKEN", Accept: "application/json", "X-Api-Version": "3", "Content-Type": "application/vnd.api+json", }, body: JSON.stringify({ data: [ { id: "Pkg-oztERp6o-Rj76nYKJg", type: "field", attributes: { position: 1 }, relationships: { fieldset: { data: null } }, }, ], }), },);HTTP/1.1 202 AcceptedContent-Type: application/jsonCache-Control: cache-control: max-age=0, private, must-revalidateX-RateLimit-Limit: 30X-RateLimit-Remaining: 28
{ "data": { "type": "job", "id": "4235" }}To get the asynchronous job result, poll the job result endpoint. While the task is in progress, the endpoint returns a 404 status code. When the job completes, the status changes to 200 OK:
GET https://site-api.datocms.com/job-results/:job_result_id HTTP/1.1Authorization: Bearer YOUR-API-TOKENAccept: application/jsonX-Api-Version: 3curl -g 'https://site-api.datocms.com/job-results/:job_result_id' \ \ -H "Authorization: Bearer YOUR-API-TOKEN" \ -H "Accept: application/json" \ -H "X-Api-Version: 3"await fetch("https://site-api.datocms.com/job-results/:job_result_id", { headers: { Authorization: "Bearer YOUR-API-TOKEN", Accept: "application/json", "X-Api-Version": "3", },});HTTP/1.1 200 OKContent-Type: application/jsonCache-Control: cache-control: max-age=0, private, must-revalidateX-RateLimit-Limit: 30X-RateLimit-Remaining: 28
{ "data": { "type": "job_result", "id": "34", "attributes": { "status": 200, "payload": { "data": [ { "type": "field", "id": "Pkg-oztERp6o-Rj76nYKJg", "attributes": { "label": "Title", "field_type": "string", "api_key": "title", "localized": true, "validators": { "required": {} }, "position": 1, "hint": "This field will be used as post title", "default_value": { "en": "A default value", "it": "Un valore di default" }, "appearance": { "editor": "single_line", "parameters": { "heading": false }, "addons": [ { "id": "1234", "field_extension": "lorem_ipsum", "parameters": {} } ] }, "deep_filtering_enabled": true }, "relationships": { "item_type": { "data": { "type": "item_type", "id": "DxMaW10UQiCmZcuuA-IkkA" } }, "fieldset": { "data": null } } } ] } } }}