API v1
v1
View as Markdown

Remove a field

DELETE /api/v1/templates/{template}/versions/{version}/sections/{section}/fields/{field}

Take a field out of a section.

The values already written under the field are not destroyed. They are detached and kept, so nothing a person typed disappears because somebody changed a structure, and a field put back finds them again.

As with the other two, a published section is drafted first and the published one is left alone.

Path parameters

Sent as JSON. Anything not listed here is ignored.

template uuid Required

The id of the template. A path that is not a uuid answers 404 without a query being run, so neither the slug nor a sequential number reaches anything here.

version integer Required

The number of the version within its template, counting from 1, which is the number shown in the version history and the number a change note refers to. It is not a row id, so version 1 of one template and version 1 of another are different things reached through different templates.

section integer Required

The id of the placement, which is not the id of the section. It is the id a placement comes back with when a version is read.

field integer Required

The id of the field. It changes the first time a published section is changed, because the change opens a draft of the section and the fields are copied into it. The key does not change, and the answer carries the new id.

Returns

Nothing. A field of a template belonging to somebody else answers 404.

Rate limit

Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.

DELETE
curl https://my.monicahq.com/api/v1/templates/7b1c4e92-3d58-4f07-9a26-8c5b0e14d3af/versions/4/sections/904/fields/5521 \
-X DELETE \
-H "Authorization: Bearer $MONICA_TOKEN"
const response = await fetch('https://my.monicahq.com/api/v1/templates/7b1c4e92-3d58-4f07-9a26-8c5b0e14d3af/versions/4/sections/904/fields/5521', {
method: 'DELETE',
headers: { Authorization: `Bearer ${token}` },
})
$response = Http::withToken($token)->delete('https://my.monicahq.com/api/v1/templates/7b1c4e92-3d58-4f07-9a26-8c5b0e14d3af/versions/4/sections/904/fields/5521');
Response 204

No content.

Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.